支付 API
以單一 REST API 處理付款生命週期。
透過單一、結構一致的 API 建立付款、管理退款、接收交易更新,並將支付營運直接融入您的產品。
功能
付款
建立、查閱、列出、確認及拒絕付款。
退款
以付款令牌進行全數或部分退款。
商業付款
發起支援的商業付款操作。
餘額
按貨幣劃分的可用及凍結餘額。
爭議
您賬戶最近的爭議記錄。
通知
狀態變更時發出的伺服器回調。
驗證
經 HTTPS 使用 Bearer 私人密鑰,並僅存於伺服器端。
測試環境
模擬付款處理的獨立環境。
生命週期
由請求到回調。
商戶伺服器
以您的私人密鑰建立付款。
POST /api/v1/payments彩虹匯 API
驗證請求並返回付款令牌。
200 · token付款處理
客戶付款;如有需要,會進行驗證。
結果
付款達至最終狀態。
approved | declined回調
狀態發送至您的回調 URL。
POST callbackUrl
驗證
每個請求均經 HTTPS 發出,並以置於 Authorization: Bearer 標頭中的私人 API 密鑰驗證。密鑰按環境發出(測試環境與正式環境的密鑰各自獨立),且只可在您的伺服器上使用。
慣例
請求及回應均採用 JSON 格式。金額以該貨幣的最小單位表示。每筆付款、退款及商業付款均以付款令牌識別,而每個回應均會說明調用是否成功;如不成功,則註明發生何種錯誤。