支付结果异步通知
支付结果异步通知
接口描述
- 对于各类预先生成支付订单(C扫B,公众号支付,小程序支付,APP支付等)的支付方式,在订单支付成功后,若下单时传入了notify_url参数,则服务端会通过此接口通知商户端支付成功的结果。
- 该接口的请求参数由服务端生成,返回参数是需要商户端响应的参数。
- 有可能重复通知,商户后台系统需要做幂等处理,避免重复发送。
接口地址
支付请求中的notify_url
参数
请求方式
POST
请求头部
Content-Type:application/json
回调参数
参数 | 类型 | 必填 | 约束 | 示例 |
---|---|---|---|---|
return_code | string | M | 响应码:SUCCESS成功,FAIL失败,响应码仅代表通信 | SUCCESS |
return_msg | string | M | 返回信息提示,“支付成功”,“支付中”,“参数不合法” 等 | 支付成功 |
result_code | string | M | 支付成功:PAY_SUCCESS成功 ,PAY_FAIL失败,TRADE_REFUND 退款成功,TRADE_REFUND_FAIL 退款失败 | PAY_SUCCESS |
pay_type | string | M | 支付类型,300.支付宝,400.微信,600.云闪付,700.翼支付,800.数字人民币,900.龙支付 | 300 |
pay_trace_no | string | M | 请求支付流水号 | 51c7d68424e5492199cf7f4734a2b977 |
pay_time | string | M | 请求交易时间,格式yyyyMMddHHmmss | 20181116155621 |
end_time | string | 支付完成时间,yyyyMMddHHmmss | 20181116155621 | |
inst_no | string | M | 机构号 | 900024 |
mch_no | string | M | 商户号 | 851811130002 |
mch_name | string | M | 商户名称 | 小猫生活 |
shop_no | string | 门店号 | 86000033007 | |
shop_name | string | 门店名称 | 小猫生活 | |
trade_no | string | M | 平台订单号 | 20000002814118090716435200001 |
td_trade_no | string | 微信订/支付宝订单号 | 4200000337201905279610829271 | |
qd_trade_no | string | 渠道订单号 | MYBKJHZF2019052717474162270360 | |
o_trade_no | string | 退款订单原订单号 | 20000131214619052717474113721 | |
total_amount | string | M | 支付金额,单位:分 | 100 |
receipt_amount | string | 商户实收金额(单位:分)= 订单金额-商户优惠金额 | 100 | |
pay_amount | string | 用户实付(单位:分)= 订单金额-平台优惠金额-商家优惠金额 | 100 | |
coupon_amount | string | 商家优惠金额,单位:分 | 0 | |
discount_amount | string | 平台优惠金额,单位:分 | 100 | |
user_id | string | 付款方用户id、微信openid、支付宝账户、qq号”等 | odpmp5Y-AmAMgPE1alyynzngzfTg | |
attach | string | 附加数据,原样返回 | 1234 | |
sign | string | M | 签名 | 336437c53711dd466154c4162cbe1c52 |
参数示例:
{
"attach": "5300640076",
"end_time": "2019-07-20 12:36:27.0",
"inst_no": "900052",
"mch_name": "糖糖西饼屋",
"mch_no": "851902260011",
"pay_time": "20190720123623",
"pay_trace_no": "19988763891732480",
"pay_type": "300",
"qd_trade_no": "",
"receipt_amount": "9500",
"result_code": "PAY_SUCCESS",
"return_code": "SUCCESS",
"return_msg": "交易成功,且可对该交易做操作,如:多级分润、退款等",
"shop_name": "糖糖小店",
"shop_no": "861902260012",
"sign": "dbd1e9e9c0d47f1852cda1751876c3af",
"td_trade_no": "2019072022001498650585123932",
"total_amount": "9500",
"pay_amount": "100",
"coupon_amount": "0",
"discount_amount": "0",
"trade_no": "20000345563319072012362422114",
"user_id": "2088222426898650"
}
商户收到平台回调后,须返回参数:
参数 | 类型 | 约束 | 描述 | 示例 |
---|---|---|---|---|
return_code | string | M | SUCCESS接收成功,FAIL接收失败 | SUCCESS |
return_msg | string | M | 返回信息提示,“支付成功”等 | 成功 |
返回示例
{
"return_code": "SUCCESS",
"return_msg": "成功"
}