统一收单交易退款查询

商户可使用该接口查询自已通过alipay.trade.refund提交的退款请求是否执行成功。

注意:

该接口的返回码10000，仅代表本次查询操作成功，不代表退款成功，当接口返回的refund_status值为REFUND_SUCCESS时表示退款成功，否则表示退款没有执行成功。

如果退款未成功，商户可以调用退款接口重试，重试时请务必保证退款请求号和退款金额一致，防止重复退款。

发起退款查询接口的时间不能离退款请求时间太短，建议之间间隔10秒以上。

注意:

\1. 该接口的返回码10000，仅代表本次查询操作成功，不代表退款成功，当接口返回的refund_status值为REFUND_SUCCESS时表示退款成功，否则表示退款没有执行成功。
\2. 如果退款未成功，商户可以调用退款接口重试，重试时请务必保证退款请求号和退款金额一致，防止重复退款。
\3. 发起退款查询接口的时间不能离退款请求时间太短，建议之间间隔10秒以上。

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/trade/fastpay/refund/query' \ --header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \ --header 'alipay-request-id: $requestid' \ --header 'Content-Type: application/json' \ --data-raw '{ "trade_no":"2021081722001419121412730660", "out_trade_no":"2014112611001004680073956707", "out_request_no":"HZ01RF001", "query_options":[ "refund_detail_item_list" ] }'

{ "trade_no": "2014112611001004680073956707", "out_trade_no": "20150320010101001", "out_request_no": "20150320010101001", "total_amount": 100.2, "refund_amount": 12.33, "refund_status": "REFUND_SUCCESS", "refund_royaltys": [ { "refund_amount": 10, "royalty_type": "transfer", "result_code": "SUCCESS", "trans_out": "2088102210397302", "trans_out_email": "alipay-test03@alipay.com", "trans_in": "2088102210397302", "trans_in_email": "zen_gwen@hotmail.com" } ], "gmt_refund_pay": "2014-11-27 15:45:57", "refund_detail_item_list": [ { "fund_channel": "ALIPAYACCOUNT", "amount": 10, "real_amount": 11.21, "fund_type": "DEBIT_CARD" } ], "send_back_fee": "88", "deposit_back_info": { "has_deposit_back": "true", "dback_status": "S", "dback_amount": 1.01, "bank_ack_time": "2020-06-02 14:03:48", "est_bank_receipt_time": "2020-06-02 14:03:48" }, "refund_hyb_amount": "10.24", "refund_charge_info_list": [ { "refund_charge_fee": 0.01, "switch_fee_rate": "0.01", "charge_type": "trade", "refund_sub_fee_detail_list": [ { "refund_charge_fee": 0.1, "switch_fee_rate": "0.01" } ] } ] }

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

trade_no

string

必需

【描述】支付宝交易号。和商户订单号不能同时为空【示例值】2021081722001419121412730660

out_trade_no

string

必需

【描述】商户订单号。订单支付时传入的商户订单号,和支付宝交易号不能同时为空。 trade_no,out_trade_no如果同时存在优先取trade_no 【示例值】2014112611001004680073956707

out_request_no

string

必需

query_options

array[string]

必需

【描述】查询选项，商户通过上送该参数来定制同步需要额外返回的信息字段，数组格式。枚举支持： refund_detail_item_list：本次退款使用的资金渠道； gmt_refund_pay：退款执行成功的时间； deposit_back_info：银行卡冲退信息；【枚举值】本次退款使用的资金渠道: refund_detail_item_list 退款执行成功的时间: gmt_refund_pay 银行卡冲退信息: deposit_back_info 【示例值】refund_detail_item_list

示例

返回响应

🟢200成功

application/json

Body

trade_no

string

支付宝交易号

必需

out_trade_no

string

商户订单号

必需

buyer_logon_id

string

用户的登录id

必需

fund_change

string

可选

本次退款是否发生了资金变化

refund_fee

number

必需

退款总金额。单位：元。指该笔交易累计已经退款成功的金额。

refund_detail_item_list

array [object {4}]

可选

退款使用的资金渠道。只有在签约中指定需要返回资金明细，或者入参的query_options中指定时才返回该字段信息。

fund_channel

string

可选

amount

integer

可选

real_amount

number

可选

fund_type

string

可选

store_name

string

可选

交易在支付时候的门店名称

buyer_user_id

string

可选

买家在支付宝的用户id

send_back_fee

string

可选

本次商户实际退回金额。单位：元。说明：如需获取该值，需在入参query_options中传入 refund_detail_item_list。

refund_hyb_amount

string

可选

本次请求退惠营宝金额。单位：元。

refund_charge_info_list

array [object {4}]

退费信息

可选

refund_charge_fee

number

可选

switch_fee_rate

string

可选

charge_type

string

可选

refund_sub_fee_detail_list

array [object {2}]

可选