# ⚠️回調說明 · 接入前必讀!
- 支付金額說明
在接收到支付成功的回調後,請以回調參數中的 orderActualAmount 欄位作為實際到賬金額的準確信息進行處理,避免由於支付金額不一致造成商戶資金損失。
- 回調/查詢接口,欄位需要做空判斷
可能在不同的業務或者不同的狀態中,訂單的某些欄位會返回空值。比如在等待支付時,這時候查詢訂單,支付訂單時間為空。商戶在接入時,對所有欄位需要做空判斷,以免查詢/回調報錯。
- 關於重複回調
系統會在一定條件下重試回調,請開發者務必確認回調響應是否正確返回以下內容,確保系統識別響應成功並停止重試:
{ "code": 200, "success": true}
- IP 白名單設置(客戶端回調服務需加白)
請在【開發者中心 → API KEY】中,將回調服務的 公網 IP 添加到 白名單輸入框中,確保回調請求可正常訪問。
- 回調失敗常見問題:IP 受限
請確認以下 IP 已全部加入白名單:
- 所有服務端(下單/回調)所在的公網 IP
- 商戶回調地址所綁定伺服器的公網 IP
- 可用出口 IP(若使用雲廠商負載均衡等)
- AccessKey 生效時間說明
AccessKey 創建後約需 2 分鐘生效,請確保使用時已完成初始化同步。若報 ACCESS_KEY_INVALID,請稍後重試。