异步扣款通知
异步通知参数
参数 | 参数名称 | 类型 | 描述 |
---|---|---|---|
notify_time | 通知时间 | Date | 通知的发送时间。格式为yyyy-MM-dd HH:mm:ss |
notify_type | 通知类型 | String(64) | 通知的类型 |
notify_id | 通知校验ID | String(128) | 通知校验 ID |
sign_type | 签名类型 | String(10) | 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2(如果开发者手动验签,不使用 SDK 验签,可以不传此参数) |
sign | 签名 | String(256) | 请参考异步返回结果的验签(如果开发者手动 验签,不使用 SDK 验签,可以不传此参数) |
trade_no | 支付宝交易号 | String(64) | 支付宝交易凭证号 |
app_id | 开发者的app_id | String(32) | 支付宝分配给开发者的应用Id |
out_trade_no | 商户订单号 | String(64) | 原支付请求的商户订单号 |
out_biz_no | 商户业务号 | String(64) | 商户业务 ID,主要是退款通知中返回退款申请的流水号 |
buyer_id | 买家支付宝用户号 | String(16) | 买家支付宝账号对应的支付宝唯一用户号。以 2088 开头的纯 16 位数字 |
buyer_logon_id | 买家支付宝账号 | String(100) | 买家支付宝账号 |
seller_id | 卖家支付宝用户号 | String(30) | 卖家支付宝用户号 |
seller_email | 卖家支付宝账号 | String(100) | 卖家支付宝账号 |
trade_status | 交易状态 | String(32) | 交易目前所处的状态 |
total_amount | 订单金额 | Number(9,2) | 本次交易支付的订单金额,单位为人民币(元) |
receipt_amount | 实收金额 | Number(9,2) | 商家在交易中实际收到的款项,单位为元 |
invoice_amount | 开票金额 | Number(9,2) | 用户在交易中支付的可开发票的金额 |
buyer_pay_amount | 付款金额 | Number(9,2) | 用户在交易中支付的金额 |
refund_fee | 总退款金额 | Number(9,2) | 退款通知中,返回总退款金额,单位为元,支持两位小数 |
send_back_fee | 实际退款金额 | Number(9,2) | 商户实际退款给用户的金额,单位为元,支持两位小数 |
subject | 订单标题 | String(256) | 商品的标题/交易标题/订单标题/订单关键字等,是请求时对应的参数,原样通知回来 |
body | 商品描述 | String(400) | 该订单的备注、描述、明细等。对应请求时的body参数,原样通知回来 |
gmt_create | 交易创建时间 | Date | 该笔交易创建的时间。格式为yyyy-MM-dd HH:mm:ss |
gmt_payment | 交易付款时间 | Date | 该笔交易的买家付款时间。格式为yyyy-MM-dd HH:mm:ss |
gmt_refund | 交易退款时间 | Date | 该笔交易的退款时间。格式为yyyy-MM-dd HH:mm:ss.S |
gmt_close | 交易结束时间 | Date | 该笔交易结束时间。格式为yyyy-MM-dd HH:mm:ss |
fund_bill_list | 支付金额信息 | String(512) | 支付成功的各个渠道金额信息,详见资金明细信息说明 |
交易状态说明
枚举名称 | 枚举说明 |
---|---|
WAIT_BUYER_PAY | 交易创建,等待买家付款 |
TRADE_CLOSED | 未付款交易超时关闭,或支付完成后全额退款 |
TRADE_SUCCESS | 交易支付成功 |
TRADE_FINISHED | 交易结束,不可退款 |
触发条件
触发条件名 | 触发条件描述 | 触发条件默认值 |
---|---|---|
TRADE_FINISHED | 交易完成 | false(不触发通知) |
TRADE_SUCCESS | 支付成功 | true(触发通知) |
WAIT_BUYER_PAY | 交易创建 | false(不触发通知) |
TRADE_CLOSED | 交易关闭 | false(不触发通知) |
异步返回结果验签
https://api.xx.com/receive_notify.htm
,对应接收到通知的示例如下:https://api.xx.com/receive_notify.htm?gmt_payment=2015-06-11 22:33:59¬ify_id=42af7baacd1d3746cf7b56752b91edcj34&seller_email=testyufabu07@alipay.com¬ify_type=trade_status_sync&sign=kPbQIjX+xQc8F0/A6/AocELIjhhZnGbcBN6G4MM/HmfWL4ZiHM6fWl5NQhzXJusaklZ1LFuMo+lHQUELAYeugH8LYFvxnNajOvZhuxNFbN2LhF0l/KL8ANtj8oyPM4NN7Qft2kWJTDJUpQOzCzNnV9hDxh5AaT9FPqRS6ZKxnzM=&trade_no=2015061121001004400068549373&out_trade_no=21repl2ac2eOutTradeNo322&gmt_create=2015-06-11 22:33:46&seller_id=2088211521646673¬ify_time=2015-06-11 22:34:03&subject=xxx中文&trade_status=TRADE_SUCCESS&sign_type=RSA2
1.
sign
、sign_type
两个参数外,凡是通知返回的参数皆是待验签的参数。2.
gmt_create=2015-06-11 22:33:46&gmt_payment=2015-06-11 22:33:59¬ify_id=42af7baacd1d3746cf7b56752b91edcj34¬ify_time=2015-06-11 22:34:03¬ify_type=trade_status_sync&out_trade_no=21repl2ac2eOutTradeNo322&seller_email=testyufabu07@alipay.com&seller_id=2088211521646673&subject=xxx中文&trade_no=2015061121001004400068549373&trade_status=TRADE_SUCCESS
1.
2.
3.
TRADE_SUCCESS
或 TRADE_FINISHED
时,支付宝才会认定为买家付款成功。TRADE_SUCCESS
状态的通知触发条件是商家开通的产品支持退款功能的前提下,买家付款成功。TRADE_FINISHED
状态的通知触发条件是商家开通的产品不支持退款功能的前提下,买家付款成功;或商家开通的产品支持退款功能的前提下,交易已经成功并且已经超过可退款期限。修改于 2023-11-23 02:05:30