API 接口文档

异步通知
现代化接入指南

支付成功后平台向商户业务系统发起通知,商户验签后处理订单。 你可以根据页面说明配置请求参数、签名字段、回调地址,并完成支付业务闭环。

接入流程
1. 获取商户ID和密钥控制台
2. 组装接口参数参数
3. 生成签名并请求签名
4. 接收回调并验签通知

异步通知接口参数

以下内容来自原开发文档,已保留请求地址、请求参数、返回参数和示例说明。

支付结果通知

通知类型:

服务器异步通知(notify_url)、页面跳转通知(return_url)

请求方式:

GET

请求参数说明:

字段名变量名类型示例值描述
商户IDpidInt1001
平台订单号trade_noString20160806151343349
商户订单号out_trade_noString20160806151343351
接口订单号api_trade_noString40001249985198893微信支付宝返回的单号
支付方式typeStringalipay支付方式列表
交易状态trade_statusStringTRADE_SUCCESS固定为TRADE_SUCCESS
订单创建时间addtimeString2024-07-01 16:47:32
订单完成时间endtimeString2024-07-01 16:49:24仅完成才返回
商品名称nameString
商品金额moneyString1.00
业务扩展参数paramString
支付用户标识buyerString 一般为openid
当前时间戳timestampString172120607210位整数,单位秒
签名字符串signString 参考签名规则
签名类型sign_typeStringRSA默认为RSA

返回内容说明:

收到异步通知后,需返回success以表示服务器接收到了订单通知

其他说明:

  • 商户系统代码内务必对返回的签名sign进行校验,并且判断trade_status的值是否等于TRADE_SUCCESS
  • 支付平台可能会增加回调字段,验证签名时必须支持增加的扩展字段

更多接口

快速切换到其他文档模块。