PAYATHON 2026

电脑网站支付扫码成功但未收到回调报文,如何解决?

支付老李

结论

是的。如果电脑网站支付需要接收异步通知,应在发起支付请求时调用 setNotifyUrl,设置这笔请求使用的通知地址。

应用控制台中的“授权回调地址”和“应用网关地址”另有用途,通常不会自动成为支付接口的异步通知地址,也不能代替请求参数中的 notify_url。调用时未设置 notify_url,即使支付成功,支付平台也不一定会向业务系统发送异步通知。

为什么扫码成功却没有回调

扫码支付成功只说明交易已经完成。支付结果通知走的是另一条链路,接收地址由支付请求中的 notify_url 决定。

以下几个地址用途不同,容易混淆:

  • notify_url:服务器接收支付结果异步通知的地址,需要通过 setNotifyUrl 设置。
  • return_url:支付完成后,用户浏览器同步跳转的页面地址,不能代替异步通知地址。
  • 授权回调地址:通常用于 OAuth 或用户授权流程。
  • 应用网关地址:用于平台向应用转发特定的应用级请求,不是各支付接口的异步通知地址。

因此,即使控制台已经配置授权回调地址和应用网关地址,只要支付请求中没有正确传入 notify_url,业务服务器仍可能收不到支付结果通知。

解决步骤

1. 在支付请求中设置通知地址

以常见的 Java SDK 调用方式为例:

AlipayTradePagePayRequest request = new AlipayTradePagePayRequest();

request.setNotifyUrl("https://www.example.com/alipay/notify");
request.setReturnUrl("https://www.example.com/alipay/return");

request.setBizContent("{" +
        "\"out_trade_no\":\"ORDER_202609140001\"," +
        "\"total_amount\":\"0.01\"," +
        "\"subject\":\"测试订单\"," +
        "\"product_code\":\"FAST_INSTANT_TRADE_PAY\"" +
        "}");

AlipayTradePagePayResponse response = alipayClient.pageExecute(request);

其中,下面这行代码设置的才是本次支付请求对应的异步通知地址:

request.setNotifyUrl("https://www.example.com/alipay/notify");

具体的请求类和执行方法可能因 SDK 版本而异,应以项目实际使用的 SDK API 为准。无论使用哪个版本,最终发出的请求参数中都必须包含正确的 notify_url。

2. 确认通知地址可从公网访问

通知地址需要满足这些条件:

  • 可以从公网直接访问,不能使用 localhost、127.0.0.1 或局域网地址。
  • 建议使用有效的 HTTPS 地址。
  • 访问时不应要求登录、输入验证码或携带浏览器 Cookie。
  • 确保防火墙、WAF、反向代理和网关不会拦截平台通知。
  • 接口应支持平台要求的 HTTP 请求方法,通常需要正确处理 POST 表单参数。
  • 尽量避免不必要的重定向。

本地调试时,可以使用安全的公网映射地址,也可以将接口部署到能从公网访问的测试环境。

3. 验证通知签名和交易信息

收到通知后,不能只根据 trade_status 更新订单。至少要先完成以下验签:

Map<String, String> params = new HashMap<>();

for (Map.Entry<String, String[]> entry : request.getParameterMap().entrySet()) {
    String value = String.join(",", entry.getValue());
    params.put(entry.getKey(), value);
}

boolean signVerified = AlipaySignature.rsaCheckV1(
        params,
        alipayPublicKey,
        charset,
        signType
);

if (!signVerified) {
    response.getWriter().print("failure");
    return;
}

验签通过后,还要核对以下信息:

  • app_id 是否属于当前应用。
  • out_trade_no 是否是本系统的订单号。
  • total_amount 是否与订单金额一致。
  • seller_id 或收款方信息是否符合预期。
  • trade_status 是否是业务允许处理的状态。

所有信息校验通过后,再以幂等方式更新订单。

4. 按要求返回成功响应

通知处理成功后,需要返回平台要求的成功字符串。常见写法如下:

response.setContentType("text/plain;charset=UTF-8");
response.getWriter().print("success");

如果返回内容不符合要求、接口超时或响应了错误状态码,平台可能会将本次通知判定为失败并重试。因此,通知接口必须支持重复调用,避免因重复通知造成重复发货、重复记账或重复发放权益。

排查时重点检查什么

如果已经调用 setNotifyUrl,但仍未收到通知,可以按以下顺序排查:

  1. 查看实际发出的请求参数或 SDK 日志,确认其中是否包含 notify_url。
  2. 检查地址是否填写正确,包括协议、域名、端口和路径。
  3. 从公网环境直接请求该地址,确认网络和 DNS 是否正常。
  4. 查看负载均衡、Nginx、网关、WAF 以及应用访问日志。
  5. 确认通知接口没有被登录认证、CSRF 校验或 IP 限制拦截。
  6. 检查服务器能否在平台规定的超时时间内完成响应。
  7. 确认应用读取的是正确的公钥、字符集和签名类型配置。
  8. 查询订单状态,确认交易是否已经进入可发送通知的成功状态。

注意事项

不能把异步通知作为确认支付状态的唯一方式。网络故障、应用发布或网关异常都可能造成通知延迟或处理失败。订单长时间停留在“待支付”状态时,应调用交易查询接口主动核实状态。

浏览器跳转到 return_url 同样不能证明支付成功,因为同步跳转可能被用户关闭、篡改或中断。较为可靠的处理方式包括:

  • 优先处理已经通过验签的异步通知。
  • 对通知处理做好幂等控制。
  • 使用交易查询作为补偿机制。
  • 只有订单号、金额、收款方和交易状态全部核对通过后,才能更新业务订单。

控制台中的授权回调地址和应用网关地址不能代替支付请求的通知地址。需要接收异步支付结果时,应通过 setNotifyUrl 明确设置实际可访问的回调接口。

备注:内容仅供参考。