跳至主要內容

開發者

狀態更新,直接發送至您的伺服器。

當付款或商業付款的狀態變更時,彩虹匯會向您的回調 URL 發送 POST 請求。您的系統可按結果採取行動,而無須依賴客戶的瀏覽器。

回調的內容

每則通知均以付款令牌及類型(付款或商業付款)識別該操作,並列明其狀態——處理中、已批准或已拒絕——連同您的訂單編號、金額及貨幣。定期付款亦附有您日後收費所用的定期付款令牌。

回調的發送目的地

建立付款或商業付款時請傳入 callbackUrl。您亦可為賬戶設定預設回調 URL。

送達及重試

當您的伺服器以 HTTP 200 回應時,回調即視為已送達。如伺服器回應錯誤,系統會按 API 技術文件所述的時間表重試發送——因此您的處理程式必須能應付多次收到同一通知的情況。

驗證回調

每個回調均包含簽署。請先按 API 技術文件所述驗證簽署,然後才按通知採取行動,並拒絕任何未能通過驗證的回調。

可靠的回調處理程式

先驗證

在讀取狀態或更改訂單之前,先檢查簽署。

保持冪等

以付款令牌及狀態作為處理依據,使重複的回調不會產生額外影響。

迅速回應

通知一經妥善記錄即返回 200;耗時的工作留待其後處理。

對賬

如有疑問,請以付款令牌查閱付款,並以 API 的回應為準。

更多詳情: 設計可靠的付款回調 · 通知參考資料 ↗ (於新分頁開啟)

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

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

Cookie 偏好設定

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

  • 絕對必要

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

    一直啟用

閱讀 Cookie 政策