更新时间：2024-04-12 14:33:08收藏我的文档设置返回文档商户向支付宝发起退款后，可通过 alipay.trade.refund.depositback.completed（收单退款冲退完成通知），获取退款后资金返回银行卡后返回的通知信息从而得知用户真实的退款到账时间。目前支付宝返回的退款时间（gmt_refund）为退款成功时间，不是退款到账时间。●如果付款是通过支付宝余额等渠道，为直接到账时间。●如果付款是通过银行卡支付的，目前由于受到银行结算时间的影响，统一展示为 1-3 个工作日到账，以银行结算时间为准。设置流程应用设置应用网关地址一个 appid 只能配置一个对应的应用网关，应用网关以 https:// 或 http:// 开头。详情请参见 应用网关和授权回调地址怎么配置。订阅消息接口登录 进入应用详情页 > 消息服务 在 from 蚂蚁 标签页即可订阅所需监听的消息接口：收单退款冲退完成通知（alipay.trade.refund.depositback.completed）。目前接收 from 蚂蚁消息只支持 http(s) 接入，不支持 websocket 长连接接入。退款接口设置 query_options●在退款接口中入参 query_options 新增 deposit_back_info，同步返回及异步通知是否返回银行卡冲退信息。 注意：退款接口必传 query_options=deposit_back_info，否则默认不触发异步通知。●返回新增字段，has_deposit_back 是否存在银行卡冲退（退外部资产）。●若用户使用支付宝账户余额等渠道支付，不触发异步。参数名称必传参数说明关键入参query_options是查询选项，商户通过上送该参数来定制同步需要额外返回的信息字段，数组格式。如：["deposit_back_info"]关键出参has_deposit_back是是否有银行卡冲退。请求示例处理 from 蚂蚁消息配置完成后，调用转账接口成功后支付宝会发送消息给商户设置的应用网关地址，商户收到消息处理流程：异步说明异步参数说明异步参数说明可参考 alipay.trade.refund.depositback.completed（收单退款冲退完成通知）。异步示例异步触发条件根据触发条件，退款到银行卡是否成功可根据 dback_status（银行卡冲退状态）状态判断是否成功。通知类型描述默认开启s成功1f失败1异步验签异步验签根据签名方式可分为公钥证书验签和 rsa2 验签。rsa2 普通公钥签名验签方法详见 如何使用 rsa2 签名验签。公钥证书验签签名验签方法详见 如何使用证书签名验签。接口响应响应值描述是否重试fail消息获取失败重试success消息获取成功不重试注意事项如何查询退款到卡时间退款到银行卡成功，查询退款到卡时间有2种。●alipay.trade.refund.depositback.completed（收单退款冲退完成通知）。 退款到银行卡成功（dback_status=s），异步通知中会返回预估银行入账时间（est_bank_receipt_time）。●alipay.trade.fastpay.refund.query（统一收单交易退款查询）。○入参 query_options 新增 deposit_back_info 选项，查询返回充退信息。○如果存在银行卡冲退，返回银行卡预估到账时间（est_bank_receipt_time）。异步通知返回 dback_status=f（冲退失败）退款是否成功 并不是根据 alipay.trade.refund.depositback.completed 的 dback_status 进行判断，dback_status 只表示到银行卡失败。退款接口返回 fund_change=y，支付宝端发生资金变动，已经进行退款成功。收单退款冲退完成通知返回 dback_status=f，银行卡冲退失败，资金自动转入用户支付宝余额。
