Skip to content

回调与通知 ​

更新时间:2026/10/16 09:53:00

回调链路分两段:通道 → 平台(通道回调记录)与平台 → 商户(商户回调推送)。排查「商户没收到通知」类问题时,先看通道回调是否到达,再看商户推送是否成功。

链路总览 ​

  • 通道回调记录:平台收到通道(支付宝、微信等)通知的原始记录,只读;
  • 商户回调推送:平台把订单结果以 HTTP POST 推送到商户配置的回调地址,失败可重发。

商户回调推送 ​

入口:回调通知(顶级菜单,与「交易订单」平级) → 商户回调推送(运营端与商户端一致)

查询条件:业务单号、事件、报文格式、商户(运营端)。

列表列:业务单号(可点开详情)、事件、报文格式、来源(订单 / 应用 / 协议)、是否成功、发送次数、商户、最近发送时间。

操作:

操作说明
发送记录抽屉展示该通知任务的每次发送明细:序号、发送类型(自动 / 手动)、是否成功、HTTP 状态码、错误信息、创建时间
重发手动重新推送该通知(回调地址暂时不可用、商户侧处理异常后补推等场景)

任务详情:通知 URL、下次发送时间、重试次数、完整报文内容(JSON)。

推送失败会自动重试

通知推送失败后系统会按策略自动重试(发送次数与下次时间在任务详情中可见);持续失败的任务在修复回调地址后可手动「重发」。

通道回调记录 ​

入口:回调通知 → 通道回调记录

查询条件:通道商户、交易号、通道交易号、支付产品、回调类型(支付 / 退款 / 转账 / 分账)、处理状态、商户。

操作:仅「查看」——详情展示通道通知的原始报文(notifyInfo JSON),用于核对通道侧的返回内容。原始报文仅运营端可见,商户端只展示回调受理状态(需要报文时联系平台获取)。

回调地址配置 ​

商户接收回调的地址由业务系统在发起支付时通过 notifyUrl 参数指定;回调报文格式与验签方式见异步回调。

应用级的统一通知订阅(按应用配置回调地址、订阅支付 / 退款事件)在应用工作台的「异步通知配置」中,该功能当前版本建设中。

常见问题 ​

现象处理
商户没收到回调按顺序排查:①「通道回调记录」确认通道通知到达且处理成功;②「商户回调推送」看推送任务是否成功、HTTP 状态码多少;③核对发起支付时传入的 notifyUrl 是否公网可达
回调收到了但验签失败用平台公钥(商户端「对接配置」中复制)验证签名,报文格式见异步回调
推送一直失败检查回调地址服务状态,修复后对任务执行「重发」

相关章节 ​