统一收单交易退款查询

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

注意:

\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.20, "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.10, "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

必需

支付宝交易号。和商户订单号不能同时为空

out_trade_no

string

必需

商户订单号。订单支付时传入的商户订单号,和支付宝交易号不能同时为空。 trade_no,out_trade_no如果同时存在优先取trade_no

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

示例

返回响应

🟢200成功

application/json

Body

trade_no

string

支付宝交易号

可选

out_trade_no

string

创建交易传入的商户订单号

可选

out_request_no

string

本笔退款对应的退款请求号

可选

total_amount

number

该笔退款所对应的交易的订单金额。单位：元。

可选

refund_amount

number

本次退款请求，对应的退款金额。单位：元。

可选

refund_status

string

退款状态。枚举值： REFUND_SUCCESS 退款处理成功；未返回该字段表示退款请求未收到或者退款失败；注：如果退款查询发起时间早于退款时间，或者间隔退款发起时间太短，可能出现退款查询时还没处理成功，后面又处理成功的情况，建议商户在退款发起后间隔10秒以上再发起退款查询请求。枚举值退款处理成功: REFUND_SUCCESS

可选

refund_royaltys

array [object {7}]

退分账明细信息，当前仅在直付通产品中返回。

可选

refund_amount

integer

可选

royalty_type

string

可选

result_code

string

可选

trans_out

string

可选

trans_out_email

string

可选

trans_in

string

可选

trans_in_email

string

可选

gmt_refund_pay

string

退款时间。默认不返回该信息，需要在入参的query_options中指定"gmt_refund_pay"值时才返回该字段信息。

可选

refund_detail_item_list

array [object {4}]

本次退款使用的资金渠道；默认不返回该信息，需要在入参的query_options中指定"refund_detail_item_list"值时才返回该字段信息。

可选

fund_channel

string

可选

amount

integer

可选

real_amount

number

可选

fund_type

string

可选

send_back_fee

string

本次商户实际退回金额；单位：元。默认不返回该信息，需要在入参的query_options中指定"refund_detail_item_list"值时才返回该字段信息。

可选

deposit_back_info

object

银行卡冲退信息；默认不返回该信息，需要在入参的query_options中指定"deposit_back_info"值时才返回该字段信息。

可选

has_deposit_back

string

必需

dback_status

string

必需

dback_amount

number

必需

bank_ack_time

string

必需

est_bank_receipt_time

string

必需

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}]

可选