回调与通知
回调链路分两段:通道 → 平台(通道回调记录)与平台 → 商户(商户回调推送)。排查「商户没收到通知」类问题时,先看通道回调是否到达,再看商户推送是否成功。
链路总览
- 通道回调记录:平台收到通道(支付宝、微信等)通知的原始记录,只读;
- 商户回调推送:平台把订单结果以 HTTP POST 推送到商户配置的回调地址,失败可重发。
商户回调推送
入口:回调通知(顶级菜单,与「交易订单」平级) → 商户回调推送(运营端与商户端一致)
查询条件:业务单号、事件、报文格式、商户(运营端)。
列表列:业务单号(可点开详情)、事件、报文格式、来源(订单 / 应用 / 协议)、是否成功、发送次数、商户、最近发送时间。
操作:
| 操作 | 说明 |
|---|---|
| 发送记录 | 抽屉展示该通知任务的每次发送明细:序号、发送类型(自动 / 手动)、是否成功、HTTP 状态码、错误信息、创建时间 |
| 重发 | 手动重新推送该通知(回调地址暂时不可用、商户侧处理异常后补推等场景) |
任务详情:通知 URL、下次发送时间、重试次数、完整报文内容(JSON)。
推送失败会自动重试
通知推送失败后系统会按策略自动重试(发送次数与下次时间在任务详情中可见);持续失败的任务在修复回调地址后可手动「重发」。
通道回调记录
入口:回调通知 → 通道回调记录
查询条件:通道商户、交易号、通道交易号、支付产品、回调类型(支付 / 退款 / 转账 / 分账)、处理状态、商户。
操作:仅「查看」——详情展示通道通知的原始报文(notifyInfo JSON),用于核对通道侧的返回内容。原始报文仅运营端可见,商户端只展示回调受理状态(需要报文时联系平台获取)。
回调地址配置
商户接收回调的地址由业务系统在发起支付时通过 notifyUrl 参数指定;回调报文格式与验签方式见异步回调。
应用级的统一通知订阅(按应用配置回调地址、订阅支付 / 退款事件)在应用工作台的「异步通知配置」中,该功能当前版本建设中。
常见问题
| 现象 | 处理 |
|---|---|
| 商户没收到回调 | 按顺序排查:①「通道回调记录」确认通道通知到达且处理成功;②「商户回调推送」看推送任务是否成功、HTTP 状态码多少;③核对发起支付时传入的 notifyUrl 是否公网可达 |
| 回调收到了但验签失败 | 用平台公钥(商户端「对接配置」中复制)验证签名,报文格式见异步回调 |
| 推送一直失败 | 检查回调地址服务状态,修复后对任务执行「重发」 |