用途与准备
理解回调任务状态,查看最近响应,并仅在自动重试停止后人工补发。
操作前准备
- 创建订单时提供了可公开访问的 HTTPS 回调地址。
- 接收端能够按当前接口文档处理事件并保证业务幂等。
先看完整流程
流程动效只用于提示步骤顺序;所有信息均在图下注明。可使用页头按钮暂停,系统开启“减少动态效果”时会自动停止。
回调状态
| 状态 | 页面说明 | 可否人工补发 |
|---|---|---|
| PENDING | 等待首次投递 | 否 |
| RETRYING | 等待自动重试 | 否 |
| SUCCESS | 投递成功 | 否,防止重复发货或重复记账 |
| DEAD | 自动重试已停止,需要人工处理 | 页面允许时可以 |
排查顺序
- 先核对业务单号、事件类型和应用,确认正在查看正确的任务。
- 查看“最近响应”的 HTTP 状态和返回内容,判断是地址不可达、服务器错误还是接收端拒绝。
- 修复商户接收端后,等待自动重试;只有任务进入可人工处理状态时再点击“人工补发”。
- 接收端必须以业务单号或事件标识做幂等处理,不能把重复通知当作新订单。
接口细节从哪里看
回调字段、签名和响应要求应以当前后台提供的 Swagger 或正式 API 文档为准。本页不复制可能随版本变化的报文和算法示例,避免旧示例误导接入。
操作结果确认
- 成功任务显示“投递成功”。
- 失败任务能看到最近响应或错误线索。
- 接收端重复收到同一事件时不会重复执行业务。
常见问题
为什么成功回调不能再次发送?
后台主动禁止重复补发成功任务,避免下游重复发货、开通或记账。
为什么按钮显示“不可补发”?
任务仍在首次投递、自动重试或已经成功;请先处理接收端问题并等待状态更新。