易支付收不到异步通知(回调)怎么办

买家付了钱,你的系统里订单却一直是未支付,通常是异步通知没有送达,或者送达了但你的系统没有正确应答。本页给出逐项排查的方法。

  • 异步通知
  • notify_url
  • 易支付 V1
  • 更新于

通知是怎么发的

支付成功后,平台用 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/一串标识

补发通知

问题修好后,之前错过的订单可以让平台重新通知一次,有两种办法:

  1. 自己调用综合接口 /api.php?act=notify,带上 trade_no 或 out_trade_no。只有支付成功的订单可以补发,详见 综合接口。
  2. 联系官方客服,提供订单号,由客服补发。

/api.php 是服务器对服务器的接口,调用它的服务器公网出口 IP 需要先加入白名单。

两个容易忽略的点

处理要做幂等。同一笔订单可能收到多次通知,同一个 out_trade_no 只能发货一次。

不要用同步跳转当发货依据。买家付完款后是否跳回你的网站取决于实际的支付通道,有些通道不会跳回。发货只认异步通知。

其他报错见 排错指引;协议细节见 签名算法 与 异步通知。

其他对接文档

获取商户 ID 与密钥

联系官方客服开通接入应用,网关地址、pid 与 key 由客服直接提供,专人协助联调。

联系官方客服