异步扣款通知
异步通知参数
| 参数 | 参数名称 | 类型 | 描述 |
|---|---|---|---|
| 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=RSA21.
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