NOTIFY
04
支付通知回调
支付完成后,平台会通过两种方式通知商户:
- 异步通知(notify_url) —— 服务器端 POST/GET 通知,需返回
success表示接收成功,否则会重试。 - 跳转通知(return_url) —— 用户支付完成后浏览器跳转回商户页面,用于展示支付结果。
回调参数
| 字段名 | 变量名 | 必填 | 描述 |
|---|---|---|---|
| 商户 ID | pid | 是 | |
| 平台订单号 | 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才处理订单。