更新时间：2023-04-06 15:04:55收藏我的文档设置返回文档一、文档地址收款到银行账户的异步消息通知文档地址详见 。注意：接口不支持沙箱环境测试。二、产品介绍产品说明支付宝的收单产品（电脑网站支付、手机网站支付、app 支付、当面付）签约商家在开通收款到银行账户的异步通知消息产品后，通过订阅对应的支付宝消息 api，收到支付宝推送的消息时调用 api 即可获取到账状态。注意事项●通知状态可分为收款成功、收款失败、银行退票。●收款到银行卡属于业务协议，对交易退款、分账等存在影响，导致不支持退款、分账。●收款到银行卡结算触发的异步通知默认编码格式为 gbk。●收款到银行卡具体结算时间，根据签约协议决定。●收款到银行卡失败或者退票是否会重试，具体根据签约协议决定。●结算通知会给订阅了结算通知的应用网关地址发送通知，因此若商户存在 5 个应用订阅消息配置地址后，支付宝会向这 5 个地址都发送通知。三、配置流程签约收款到银行账户该签约流程存在疑问，请到 在线咨询或拨打商家服务热线 4007585858 咨询。应用设置应用网关地址一个 appid 只能配置一个对应的应用网关，应用网关以 https:// 或 http:// 开头。绑定产品在 产品绑定 > 绑定产品 中添加 收款到银行账户的异步消息通知，并显示为 已开通 状态。订阅消息接口在应用详情页点击左侧的 消息服务 进入消息的订阅管理页面，在 from 蚂蚁 标签页即可订阅所需监听的 3 个消息 api，包括：●alipay.trade.settle.success：结算成功消息。●alipay.trade.settle.fail：收单资金结算到银行账户，结算失败的异步通知。●alipay.trade.settle.dishonoured：结算退票消息。注意：目前收款到银行账户的异步消息通知接收 from 蚂蚁消息只支持 http(s) 接入，不支持 websocket 长连接接入。处理 from 蚂蚁消息配置完成后，调用结算后支付宝会发送消息给商户设置的应用网关地址，商户收到消息处理流程：四、异步说明异步参数说明接口英文名接口中文名收款到银行账户，收款成功的消息通知收款到银行账户，收款失败的消息通知收款到银行账户，银行退票的消息通知异步触发条件根据触发条件，不同的场景（收款成功、收款失败、银行退票）触发不同的异步通知。msg_method触发条件描述说明alipay.trade.settle.success收款成功alipay.trade.settle.fail收款失败收款到银行卡失败可参考异步返回的 fail_desc（结算失败的原因描述）alipay.trade.settle.dishonoured银行退票收款到银行卡退票可参考异步返回的 fail_desc（结算失败的原因描述）结算退票商家的结算申请通过支付宝提交给银行处理后，银行返回结果是入账成功，支付宝通知商家结算成功，但间隔一段时间后，银行再次通知支付宝入账失败并返还转账款项给支付宝，支付宝再将该笔失败款返还至商家的支付宝账户中。结算退票原因部分银行（如北京银行）的入账申请需先通过人民银行的支付系统，再由接收行（如北京银行）入账，此时如存在账号、户名或其他不能入账的原因，接收行会将款项再退回到原汇出行（支付宝）。所以，一笔结算，人民银行的支付系统会先返回成功状态，但是若接收行入账失败，会再次通知结算失败。五、异步验签接口响应响应值描述是否重试fail消息获取失败重试success消息获取成功不重试消息验签收款到银行卡的异步通知验签方式建议根据该应用的接口加签配置决定。rsa2 普通公钥签名验签方法详见 如何使用 rsa2 签名验签。公钥证书验签签名验签方法详见 如何使用证书签名验签。注意编码格式统一，收款到银行卡结算触发的异步通知默认编码格式为 gbk。六、注意事项●收款到银行卡的异步消息通知特性与支付接口返回的异步通知相同，详见 支付宝异步通知说明。●收款到银行卡属于业务协议，会导致对接口产生的交易存在问题。如对交易退款、分账、交易状态等存在影响，导致不支持退款、分账。○退款报错 。○分账报错 。○退分账报错 。○全额退款后交易状态存在有误，详见 。
