退款接口query-凯发app官方网站

更新时间：2024-11-11 16:40:50

我的文档

设置

（统一收单交易退款接口）和

（统一收单交易退款查询）支持设置 query_options，该参数参数说明如下。

1、参数说明

query_options（查询选项）

描述	统一收单交易退款接口（alipay.trade.refund）	统一收单交易退款查询接口（alipay.trade.fastpay.refund.query）
参数说明	查询选项商户通过上送该参数来定制同步需要额外返回的信息字段，数组格式。
参数值	参数值枚举：（1）refund_detail_item_list：退款使用的资金渠道（2）deposit_back_info：收单到银行卡退款冲退通知	参数值枚举：（1）refund_detail_item_list：退款使用的资金渠道（2）deposit_back_info：银行卡冲退信息

入参示例：

biz_content={

"out_trade_no": "2020010101888467556",

"out_request_no": "hz01rf001",

"refund_amount": "1",

"query_options": [

"refund_detail_item_listvoucher_detail_list",

"deposit_back_info"]

}

2、refund_detail_item_list

query_options=refund_detail_item_list，可查询本次交易退款使用的资金渠道。

（1）查询用户支付但未退款时的支付渠道，可在

（统一收单交易查询）设置 query_options=fund_bill_list，详见

。

（2）退款接口和退款查询接口返回 refund_detail_item_list 响应参数字段一致。

关键出参

关键字段	是否必传	参数说明
send_back_fee	特殊可选	本次商户实际退回金额。注：入参的 query_options 中指定时才返回，且 refund_detail_item_list 各个支付渠道的 amount 相加=send_back_fee。
refund_detail_item_list	特殊可选	退款使用的资金渠道。只有在签约中指定需要返回资金明细，或者入参的 query_options 中指定时才返回该字段信息。
└fund_channel	是	交易使用的资金渠道，参见支付渠道列表
└amount	是	该支付工具类型所使用的金额

示例：

3、deposit_back_info

query_options=refund_detail_item_list，可触发用户使用银行卡支付退款时的冲退通知，详见

。

3.1、退款接口

（1）在退款接口中入参 query_options 新增 deposit_back_info，同步返回及异步通知是否返回银行卡冲退信息。

注：退款接口必传 query_options=deposit_back_info，否则默认不触发异步通知。

（2）返回新增字段，has_deposit_back 是否存在银行卡冲退（退外部资产）

（3）若用户使用支付宝账户余额等渠道支付，不触发异步。

关键出参

关键字段	是否必传	参数说明
has_deposit_back	特殊可选	是否有银行卡冲退

3.2、退款查询接口

（1）退款到银行卡除了异步吗，也可通过退款查询接口返回的 deposit_back_info 进行判断。

（2）如果存在银行卡冲退，可返回银行卡冲退状态、金额、预计到账时间等。

关键出参

关键字段	是否必传	参数说明
deposit_back_info	特殊可选	银行卡冲退信息
└has_deposit_back	否	是否存在银行卡冲退信息
└dback_status	否	银行卡冲退状态。s-成功，f-失败，p-处理中。银行卡冲退失败，资金自动转入用户支付宝余额。
└dback_amount	否	银行卡冲退金额
└bank_ack_time	否	银行响应时间，格式为 yyyy-mm-dd hh:mm:ss
└est_bank_receipt_time	否	预估银行到账时间，格式为 yyyy-mm-dd hh:mm:ss

描述	统一收单交易退款接口（alipay.trade.refund）	统一收单交易退款查询接口（alipay.trade.fastpay.refund.query）
参数说明	查询选项商户通过上送该参数来定制同步需要额外返回的信息字段，数组格式。
参数值	参数值枚举：（1）refund_detail_item_list：退款使用的资金渠道（2）deposit_back_info：收单到银行卡退款冲退通知	参数值枚举：（1）refund_detail_item_list：退款使用的资金渠道（2）deposit_back_info：银行卡冲退信息