跳到正文
ZZOO 帮助中心

商户回调:查看投递与处理失败任务

理解回调任务状态,查看最近响应,并仅在自动重试停止后人工补发。

适用角色
商户用户、平台管理员
所属栏目
交易接入
文档状态
持续更新
核验时间
2026-09-23

用途与准备

理解回调任务状态,查看最近响应,并仅在自动重试停止后人工补发。

操作前准备
  • 创建订单时提供了可公开访问的 HTTPS 回调地址。
  • 接收端能够按当前接口文档处理事件并保证业务幂等。

先看完整流程

01 业务成功 02 创建回调任务 03 投递到商户 04 成功或等待处理
业务成功 → 创建回调任务 → 投递到商户 → 成功或等待处理

流程动效只用于提示步骤顺序;所有信息均在图下注明。可使用页头按钮暂停,系统开启“减少动态效果”时会自动停止。

回调状态

状态页面说明可否人工补发
PENDING等待首次投递
RETRYING等待自动重试
SUCCESS投递成功否,防止重复发货或重复记账
DEAD自动重试已停止,需要人工处理页面允许时可以

排查顺序

  1. 先核对业务单号、事件类型和应用,确认正在查看正确的任务。
  2. 查看“最近响应”的 HTTP 状态和返回内容,判断是地址不可达、服务器错误还是接收端拒绝。
  3. 修复商户接收端后,等待自动重试;只有任务进入可人工处理状态时再点击“人工补发”。
  4. 接收端必须以业务单号或事件标识做幂等处理,不能把重复通知当作新订单。

接口细节从哪里看

回调字段、签名和响应要求应以当前后台提供的 Swagger 或正式 API 文档为准。本页不复制可能随版本变化的报文和算法示例,避免旧示例误导接入。

操作结果确认

  • 成功任务显示“投递成功”。
  • 失败任务能看到最近响应或错误线索。
  • 接收端重复收到同一事件时不会重复执行业务。

常见问题

为什么成功回调不能再次发送?

后台主动禁止重复补发成功任务,避免下游重复发货、开通或记账。

为什么按钮显示“不可补发”?

任务仍在首次投递、自动重试或已经成功;请先处理接收端问题并等待状态更新。