跳至主要內容

支付 API

以單一 REST API 處理付款生命週期。

透過單一、結構一致的 API 建立付款、管理退款、接收交易更新,並將支付營運直接融入您的產品。

功能

付款

建立、查閱、列出、確認及拒絕付款。

退款

以付款令牌進行全數或部分退款。

商業付款

發起支援的商業付款操作。

餘額

按貨幣劃分的可用及凍結餘額。

爭議

您賬戶最近的爭議記錄。

通知

狀態變更時發出的伺服器回調。

驗證

經 HTTPS 使用 Bearer 私人密鑰,並僅存於伺服器端。

測試環境

模擬付款處理的獨立環境。

生命週期

由請求到回調。

  1. 商戶伺服器

    以您的私人密鑰建立付款。

    POST /api/v1/payments
  2. 彩虹匯 API

    驗證請求並返回付款令牌。

    200 · token
  3. 付款處理

    客戶付款;如有需要,會進行驗證。

  4. 結果

    付款達至最終狀態。

    approved | declined
  5. 回調

    狀態發送至您的回調 URL。

    POST callbackUrl

驗證

每個請求均經 HTTPS 發出,並以置於 Authorization: Bearer 標頭中的私人 API 密鑰驗證。密鑰按環境發出(測試環境與正式環境的密鑰各自獨立),且只可在您的伺服器上使用。

慣例

請求及回應均採用 JSON 格式。金額以該貨幣的最小單位表示。每筆付款、退款及商業付款均以付款令牌識別,而每個回應均會說明調用是否成功;如不成功,則註明發生何種錯誤。

準備好商討您的支付設定了嗎?

請告訴我們您的業務目前如何收款,以及您對下一個支付整合有何需要。

Cookie 偏好設定

選擇我們可使用的非必要 Cookie。絕對必要的 Cookie 會一直啟用,因為網站需要它們才能運作。

  • 絕對必要

    保安、負載平衡、表格保護及記錄您的 Cookie 選擇。

    一直啟用

閱讀 Cookie 政策