開發者
狀態更新,直接發送至您的伺服器。
當付款或商業付款的狀態變更時,彩虹匯會向您的回調 URL 發送 POST 請求。您的系統可按結果採取行動,而無須依賴客戶的瀏覽器。
回調的內容
每則通知均以付款令牌及類型(付款或商業付款)識別該操作,並列明其狀態——處理中、已批准或已拒絕——連同您的訂單編號、金額及貨幣。定期付款亦附有您日後收費所用的定期付款令牌。
回調的發送目的地
建立付款或商業付款時請傳入 callbackUrl。您亦可為賬戶設定預設回調 URL。
送達及重試
當您的伺服器以 HTTP 200 回應時,回調即視為已送達。如伺服器回應錯誤,系統會按 API 技術文件所述的時間表重試發送——因此您的處理程式必須能應付多次收到同一通知的情況。
驗證回調
每個回調均包含簽署。請先按 API 技術文件所述驗證簽署,然後才按通知採取行動,並拒絕任何未能通過驗證的回調。
可靠的回調處理程式
先驗證
在讀取狀態或更改訂單之前,先檢查簽署。
保持冪等
以付款令牌及狀態作為處理依據,使重複的回調不會產生額外影響。
迅速回應
通知一經妥善記錄即返回 200;耗時的工作留待其後處理。
對賬
如有疑問,請以付款令牌查閱付款,並以 API 的回應為準。
更多詳情: 設計可靠的付款回調 · 通知參考資料 ↗ (於新分頁開啟)