幫助中心 / developers
回調未收到與訂單補查
回調是通知渠道,訂單查詢才是確認狀態的重要依據。
準備接收端
在對應設置保存自己可公開訪問的 HTTPS 接收地址,按文檔驗證簽名和 event_id,並快速返回成功響應,再異步處理業務。不要把我們官網地址當成回調接收地址。
漏單與延遲處理
通用回調和 API Key 回調的事件範圍不同,訂閱項以文檔為準。接收失敗會重試,但不要只靠回調判定訂單失敗;使用帳號級訂單查詢及 updated_after 分頁補齊,按 event_id 和訂單 ID 去重。
配置接收地址
在對應開發者或回調設置中填寫自己的接收服務。
- 使用外部可訪問的 HTTPS 地址。
- 按所需來源和事件範圍選擇訂閱項。
- 按當前文檔實現簽名驗證,檢查事件標識和業務對象。
- 收到消息後先可靠保存並快速返回成功,再異步更新自己的系統。
填寫的是你自己的接收接口,不是 zovocard 官網地址。
處理重試與冪等
回調可能重復到達,順序也可能與業務處理順序不同。
- 按 event_id 或接口規定的事件標識去重。
- 同時以業務訂單或交易號防止重復入賬或重復發貨。
- 對狀態不明的事件,查詢平台當前狀態後再更新本地結果。
沒有收到回調怎麼辦
檢查地址、HTTPS、網關攔截和接收日誌。確認訂閱項是否包含該訂單來源;帳號級與 Key 級事件範圍可能不同。必要時用文檔中的訂單查詢和更新時間分頁補查,保留請求標識用於工單核驗。