交易接入 / 操作与配置
商户回调:查看投递与处理失败任务
理解回调任务状态,查看最近响应,并仅在自动重试停止后人工补发。
本篇操作教程02 个章节
01 / 准备条件
02 / 分步操作
03 / 结果检查
使用前准备
- 创建订单时提供了可公开访问的 HTTPS 回调地址。
- 接收端能够按当前接口文档处理事件并保证业务幂等。
01从准备到结果确认
查看这段动画的完整步骤
- 查找任务
业务单号:对应成功订单。
成功任务显示“投递成功”。
- 读取状态
投递状态:等待 / 成功 / 失败。
失败任务能看到最近响应或错误线索。
- 检查地址
通知 HTTPS 地址:公网可访问。
接收端重复收到同一事件时不会重复执行业务。
- 核对响应
HTTP 与响应体:2xx + success。
接收端重复收到同一事件时不会重复执行业务。
- 检查验签
原始请求正文:签名、应用、金额均一致。
接收端重复收到同一事件时不会重复执行业务。
- 防止重复
业务唯一约束:同一通知仅处理一次。
接收端重复收到同一事件时不会重复执行业务。
02排查顺序
查看这段动画的完整步骤
- 先核对业务单号、事件类型和应用
先核对业务单号、事件类型和应用,确认正在查看正确的任务。
成功任务显示“投递成功”。
- 判断是地址不可达、服务器错误还是接收端拒绝
查看“最近响应”的 HTTP 状态和返回内容,判断是地址不可达、服务器错误还是接收端拒绝。
失败任务能看到最近响应或错误线索。
- 修复商户接收端后
修复商户接收端后,等待自动重试;只有任务进入可人工处理状态时再点击“人工补发”。
接收端重复收到同一事件时不会重复执行业务。
- 接收端必须以业务单号或事件标识做幂等处理
接收端必须以业务单号或事件标识做幂等处理,不能把重复通知当作新订单。
接收端重复收到同一事件时不会重复执行业务。
详细操作与条件
回调状态
| 状态 | 页面说明 | 可否人工补发 |
|---|---|---|
| PENDING | 等待首次投递 | 否 |
| RETRYING | 等待自动重试 | 否 |
| SUCCESS | 投递成功 | 否,防止重复发货或重复记账 |
| DEAD | 自动重试已停止,需要人工处理 | 页面允许时可以 |
排查顺序
- 先核对业务单号、事件类型和应用,确认正在查看正确的任务。
- 查看“最近响应”的 HTTP 状态和返回内容,判断是地址不可达、服务器错误还是接收端拒绝。
- 修复商户接收端后,等待自动重试;只有任务进入可人工处理状态时再点击“人工补发”。
- 接收端必须以业务单号或事件标识做幂等处理,不能把重复通知当作新订单。
接口细节从哪里看
回调字段、签名和响应要求应以当前后台提供的 Swagger 或正式 API 文档为准。本页不复制可能随版本变化的报文和算法示例,避免旧示例误导接入。
操作结果确认
- 成功任务显示“投递成功”。
- 失败任务能看到最近响应或错误线索。
- 接收端重复收到同一事件时不会重复执行业务。
本页操作视频
与本页主动画使用同一分镜。视频按 1.5× 导出,32 秒;付款与凭据操作由本人完成。
常见问题
为什么成功回调不能再次发送?
后台主动禁止重复补发成功任务,避免下游重复发货、开通或记账。
为什么按钮显示“不可补发”?
任务仍在首次投递、自动重试或已经成功;请先处理接收端问题并等待状态更新。