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 级事件范围可能不同。必要时用文档中的订单查询和更新时间分页补查,保留请求标识用于工单核验。

前往相关功能 ↗