NOTIFY 04

支付通知回调

支付完成后,平台会通过两种方式通知商户:

  • 异步通知(notify_url) —— 服务器端 POST/GET 通知,需返回 success 表示接收成功,否则会重试。
  • 跳转通知(return_url) —— 用户支付完成后浏览器跳转回商户页面,用于展示支付结果。

回调参数

字段名变量名必填描述
商户 IDpid是
平台订单号trade_no是平台侧订单号
商户订单号out_trade_no是商户系统订单号
支付方式type是alipay/wxpay 等
商品名称name是
商品金额money是
支付状态trade_status是TRADE_SUCCESS 表示成功
扩展参数param否下单时传入的 param
签名sign是V2 用 RSA,V1 用 MD5
签名类型sign_type是RSA / MD5
处理流程:收到通知 → 验证签名 → 校验订单金额与状态 → 更新商户系统订单 → 输出 success。务必做幂等性处理,防止重复通知导致重复发货。

V2 回调验签要点

  • 使用平台公钥验证签名(SHA256WithRSA)。
  • 校验 timestamp 与服务器时间差不超过 300 秒。
  • 验签通过且 trade_status=TRADE_SUCCESS 才处理订单。