支付宝交易支付状态查询:支付成功响应参数-明生-k8凯发旗舰
支付宝提供了alipay.trade.query(统一收单交易查询)查询订单支付状态的接口,用来确认支付状态。
一、alipay.trade.query公共响应参数
包括:code、msg、sub_code、sub_msg和sign,code为10000时表示api创建连接成功。
二、alipay.trade.query交易响应参数
可以通过trade_status来判断交易支付是否成功,成功则返回trade_success。
默认有四种交易支付状态:
(1)wait_buyer_pay:交易创建,等待买家付款
(2)trade_closed:未付款交易超时关闭,或支付完成后全额退款
(3)trade_success:交易支付成功
(4)trade_finished:交易结束,不可退款
实际支付宝收款确认的开发过程中,考虑到网络状态及程序支付安全设计的需要,可以增加一种默认状态。
(5)trade_unknown:未知状态
可以通过alipay_trade_query_response的trade_status值来判断支付宝统一收单交易查询。
一、alipay.trade.query公共响应参数
包括:code、msg、sub_code、sub_msg和sign,code为10000时表示api创建连接成功。
二、alipay.trade.query交易响应参数
参数 | 类型 | 是否必选 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
trade_no | string | 必选 | 64 |
支付宝交易号 |
2013112011001004330000121536 |
out_trade_no | string | 必选 | 64 |
商家订单号 |
6823789339978248 |
buyer_logon_id | string | 必选 | 100 |
买家支付宝账号 |
159****5620 |
trade_status | string | 必选 | 32 |
交易状态:wait_buyer_pay(交易创建,等待买家付款)、trade_closed(未付款交易超时关闭,或支付完成后全额退款)、trade_success(交易支付成功)、trade_finished(交易结束,不可退款) |
trade_closed |
total_amount | price | 必选 | 11 |
交易的订单金额,单位为元,两位小数。该参数的值为支付时传入的total_amount |
88.88 |
buyer_pay_amount | price | 可选 | 11 |
买家实付金额,单位为元,两位小数。该金额代表该笔交易买家实际支付的金额,不包含商户折扣等金额 |
8.88 |
point_amount | price | 可选 | 11 |
积分支付的金额,单位为元,两位小数。该金额代表该笔交易中用户使用积分支付的金额,比如集分宝或者支付宝实时优惠等 |
10 |
invoice_amount | price | 可选 | 11 |
交易中用户支付的可开具发票的金额,单位为元,两位小数。该金额代表该笔交易中可以给用户开具发票的金额 |
12.11 |
send_pay_date | date | 特殊可选 | 32 |
本次交易打款给卖家的时间 |
2014-11-27 15:45:57 |
receipt_amount | string | 特殊可选 | 11 |
实收金额,单位为元,两位小数。该金额为本笔交易,商户账户能够实际收到的金额 |
15.25 |
store_id | string | 特殊可选 | 32 |
商户门店编号 |
nj_s_001 |
terminal_id | string | 特殊可选 | 32 |
商户机具终端编号 |
nj_t_001 |
fund_bill_list | tradefundbill[] | 必选 |
交易支付使用的资金渠道。 只有在签约中指定需要返回资金明细,或者入参的query_options中指定时才返回该字段信息。 |
||
store_name | string | 特殊可选 | 512 |
请求交易支付中的商户店铺的名称 |
证大五道口店 |
buyer_user_id | string | 必选 | 16 |
买家在支付宝的用户id |
2088101117955611 |
buyer_user_type | string | 特殊可选 | 18 |
买家用户类型。corporate:企业用户;private:个人用户。 |
private |
mdiscount_amount | string | 特殊可选 | 11 |
商家优惠金额 |
88.88 |
discount_amount | string | 特殊可选 | 11 |
平台优惠金额 |
88.88 |
ext_infos | string | 特殊可选 | 1024 |
交易额外信息,特殊场景下与支付宝约定返回。 json格式。 |
{"action":"cancel"} |
默认有四种交易支付状态:
(1)wait_buyer_pay:交易创建,等待买家付款
(2)trade_closed:未付款交易超时关闭,或支付完成后全额退款
(3)trade_success:交易支付成功
(4)trade_finished:交易结束,不可退款
实际支付宝收款确认的开发过程中,考虑到网络状态及程序支付安全设计的需要,可以增加一种默认状态。
(5)trade_unknown:未知状态
可以通过alipay_trade_query_response的trade_status值来判断支付宝统一收单交易查询。