更新时间:2023-07-10 11:07:07收藏我的文档设置返回文档场景说明红包(原“现金红包”)通过设置应用网关发送 from 蚂蚁消息配置。支持发送蚂蚁消息的 api:接口英文名接口中文名alipay.fund.trans.app.pay红包(原“现金红包”)无线支付接口单笔转账(红包打款)接口资金退回接口如何设置异步地址应用设置应用网关地址一个 appid 只能配置一个对应的应用网关,应用网关以 https:// 或 http:// 开头。可查看 如何配置应用网关和授权回调地址 的应用网关配置方式。订阅消息接口在应用页面点击左侧的 开发设置 进入消息服务的订阅管理页面,在 from蚂蚁 标签页即可订阅所需监听的消息接口:alipay.fund.trans.order.changed(资金单据状态变更通知接口)和 alipay.fund.trans.refund.success(资金退回成功通知)。如图:处理 from 蚂蚁消息配置完成后,调用转账接口成功后支付宝会发送消息给商家设置的应用网关地址,商家收到消息处理。异步说明异步参数说明资金单据状态变更通知接口,发送红包、红包打款接口异步通知可查看 (资金单据状态变更通知)。红包资金退回成功接口异步参数说明可查看 (资金退回成功通知))。异步示例●alipay.fund.trans.order.changed 接口消息示例:●alipay.fund.trans.refund.success 接口消息示例:异步触发条件●alipay.fund.trans.app.pay 涉及的状态: wait_pay、success、closed。触发条件名触发条件描述触发条件默认值状态说明success转账成功true(触发通知)●alipay.fund.trans.app.pay 支付成功。●alipay.fund.trans.uni.transfer支付成功。wait_pay等待支付true(触发通知)alipay.fund.trans.app.pay 创建订单成功,等待支付。closed订单超时关闭true(触发通知)alipay.fund.trans.app.pay 超时未付款,交易关闭。●alipay.fund.trans.refund.success 触发条件: 根据触发条件,只有 success 退款成功才会触发异步。触发条件名触发条件描述触发条件默认值状态说明success退款成功true(触发通知)●alipay.fund.trans.refund 接口退款成功。●alipay.fund.trans.app.pay 支付后超过打款时间,系统自动退款成功。异步验签接口响应响应值描述是否重试fail消息获取失败重试success消息获取成功不重试消息验签在公钥证书模式下,支付宝开放平台 sdk 提供了验签方法,可以使用该方法对通知报文验签,验签可查看 如何使用证书签名验签。●java 语言: java 公钥证书验签使用 rsacertcheckv1。●php 语言:●.net 语言: .net 语言验签方法使用 rsacertcheckv1。注意事项●alipay.fund.trans.app.pay(红包(原“现金红包”)无线支付接口)在客户端唤起支付宝收银台即创建订单。 说明:alipay.fund.trans.app.pay(红包(原“现金红包”)无线支付接口)不同于 app 支付,alipay.fund.trans.app.pay(红包(原“现金红包”)无线支付接口)创建订单未支付,在支付宝客户端账单中不显示,但是通过调用 (转账业务单据查询接口)可查询到该笔订单处于 wait_pay 状态。●红包(原“现金红包”)和单笔转账必须使用公钥证书进行签名验签,对资金类接口会强制检验是否使用公钥证书模式,否则报错。●alipay.fund.trans.app.pay(红包(原“现金红包”)无线支付接口)的 closed 状态是指 alipay.fund.trans.app.pay (红包(原“现金红包”)无线支付接口) 订单创建超时未付款,交易关闭。●alipay.fund.trans.app.pay(红包(原“现金红包”)无线支付接口)支付成功后,超过 24 小时的打款时间,导致系统自动退款触发的异步是根据 alipay.fund.trans.refund.success(资金退回成功通知接口)发送的消息。●如何区分接口退款和系统超时退款的异步? 很抱歉,2 者异步信息一致,无法区分。