ZovoCard 幫助與部落格
幫助中心 / developers

回調未收到與訂單補查

回調是通知渠道,訂單查詢才是確認狀態的重要依據。

更新 2026-09-28

準備接收端

在對應設置保存自己可公開訪問的 HTTPS 接收地址,按文檔驗證簽名和 event_id,並快速返回成功響應,再異步處理業務。不要把我們官網地址當成回調接收地址。

漏單與延遲處理

通用回調和 API Key 回調的事件範圍不同,訂閱項以文檔為準。接收失敗會重試,但不要只靠回調判定訂單失敗;使用帳號級訂單查詢及 updated_after 分頁補齊,按 event_id 和訂單 ID 去重。

配置接收地址

在對應開發者或回調設置中填寫自己的接收服務。

  1. 使用外部可訪問的 HTTPS 地址。
  2. 按所需來源和事件範圍選擇訂閱項。
  3. 按當前文檔實現簽名驗證,檢查事件標識和業務對象。
  4. 收到消息後先可靠保存並快速返回成功,再異步更新自己的系統。

填寫的是你自己的接收接口,不是 zovocard 官網地址。

處理重試與冪等

回調可能重復到達,順序也可能與業務處理順序不同。

  1. 按 event_id 或接口規定的事件標識去重。
  2. 同時以業務訂單或交易號防止重復入賬或重復發貨。
  3. 對狀態不明的事件,查詢平台當前狀態後再更新本地結果。

沒有收到回調怎麼辦

檢查地址、HTTPS、網關攔截和接收日誌。確認訂閱項是否包含該訂單來源;帳號級與 Key 級事件範圍可能不同。必要時用文檔中的訂單查詢和更新時間分頁補查,保留請求標識用於工單核驗。

前往相關功能 ↗