通知是怎么发的
支付成功后,平台用 GET 方式请求你下单时传的 notify_url,参数拼在地址的 query 里。你的系统验签并处理完订单后,页面只输出 success。
如果平台没有收到 success,会自动重试,间隔逐次拉长。所以"偶尔晚到"是正常的,"一直不到"才需要排查。
逐项排查
| 检查项 | 怎么确认 |
|---|---|
| 通知地址能被公网访问 | 必须是公网可达的 http/https 地址,不能是 localhost 或内网 IP。用手机流量直接访问这个地址试试 |
| 不需要登录 | 未登录状态访问通知地址,不应被跳转到登录页 |
| 没有被防火墙、CDN、WAF 拦截 | 查服务器访问日志里有没有对通知路径的 GET 请求。如果用了人机验证、地区封锁或爬虫防护,要对通知路径放行 |
| 接受 GET 请求 | 通知路由如果只允许 POST,请求会被拒绝 |
返回内容只有 success | 不能带 HTML 标签、空格、换行或调试输出 |
| 验签能通过 | 收到了请求但验签不过,也会表现为"没发货"。见 验签失败排查 |
最快的判断方法是看服务器访问日志:日志里没有请求,说明通知没到你的服务器,问题在网络和拦截;有请求但订单没变,问题在验签或你的处理逻辑。
常见系统的通知地址
用现成系统时,通知地址一般由程序生成。下表是各系统的通知路径,可以用来在访问日志里搜索,或在反向代理里放行:
| 系统 | 通知路径 |
|---|---|
| 独角数卡 2.x | /pay/yipay/notify_url |
| Dujiao-Next | /api/v1/payments/callback,需要在渠道里手动填写完整地址 |
| 异次元发卡 | /user/api/order/callback.插件标识 |
| New-API | /api/user/epay/notify,域名取自「回调地址」或「服务器地址」 |
| One-Hub | /api/payment/notify/一串标识 |
| Xboard / V2Board | /api/v1/guest/payment/notify/EPay/一串标识 |
补发通知
问题修好后,之前错过的订单可以让平台重新通知一次,有两种办法:
- 自己调用综合接口
/api.php?act=notify,带上trade_no或out_trade_no。只有支付成功的订单可以补发,详见 综合接口。 - 联系官方客服,提供订单号,由客服补发。
/api.php 是服务器对服务器的接口,调用它的服务器公网出口 IP 需要先加入白名单。
两个容易忽略的点
处理要做幂等。同一笔订单可能收到多次通知,同一个 out_trade_no 只能发货一次。
不要用同步跳转当发货依据。买家付完款后是否跳回你的网站取决于实际的支付通道,有些通道不会跳回。发货只认异步通知。
其他对接文档
获取商户 ID 与密钥
联系官方客服开通接入应用,网关地址、pid 与 key 由客服直接提供,专人协助联调。
联系官方客服