通用场景
退款存在退到银行卡场景时，收单会根据银行回执消息发送退款完成信息。仅当退款发起时，在query_options中传入：deposit_back_info时会发送。
公共请求参数
| 参数 | 类型 | 是否必选 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| notify_id | string | 必选 | 50 | 通知id | 5608cccc09ddb39d41c2e3c06e3d9fejh2 |
| utc_timestamp | string | 必选 | 13 | 消息发送时的服务端时间 | 1514210452731 |
| msg_method | string | 必选 | 100 | 消息接口名称 | alipay.trade.refund.depositback.completed |
| app_id | string | 必选 | 20 | 消息接受方的应用id | 2014060600164699 |
| version | string | 必选 | 5 | 版本号(1.1版本为标准消息) | 1.0或者1.1 |
| biz_content | string | 必选 | 消息报文 | 参见消息属性 | |
| sign | string | 必选 | 签名 | wco t3d8kg71dtlkwn7r9pzuoxeabjwp8/fousxcuskxsovyxbpsaidpryscjhcjmaglncjokjqlj28/asl93jotw39fx6i07lxhnbpknezalwmvpdnqui01hzszf9v1i6ggzjbiad5lg8bzttxzoj87ub2i9guj3nr/nuc9vey= | |
| sign_type | string | 必选 | 10 | 签名类型 | rsa2 |
| charset | string | 必选 | 10 | 编码集，该字符集为验签和解密所需要的字符集 | utf-8 |
消息属性
trade_no必选string(64)
【描述】支付宝交易号
【示例值】2014112611001004680073956707
out_trade_no必选string(64)
【描述】商户订单号
【示例值】20150320010101001
out_request_no必选string(64)
【描述】退款请求号
【示例值】hz01rf001
dback_status必选string(8)
【描述】银行卡冲退状态。s-成功，f-失败。银行卡冲退失败，资金自动转入用户支付宝余额。
【示例值】s
dback_amount必选string(9)
【描述】银行卡冲退金额，仅当dback_status=s时，才会返回。单位：元。
【示例值】1.01
bank_ack_time可选string(32)
【描述】银行响应时间，格式为yyyy-mm-dd hh:mm:ss
【示例值】2020-06-02 14:03:48
est_bank_receipt_time可选string(32)
【描述】预估银行入账时间，格式为yyyy-mm-dd hh:mm:ss
【示例值】2020-06-02 14:03:48
消息示例
默认示例
curl -x post 'notify_url' \
--header 'content-type: application/x-www-form-urlencoded; charset=utf-8' \
--data-urlencode 'charset=utf-8' \
--data-urlencode 'biz_content={
"bank_ack_time":"2020-06-02 14:03:48",
"est_bank_receipt_time":"2020-06-02 14:03:48",
"dback_status":"s",
"out_trade_no":"20150320010101001",
"trade_no":"2014112611001004680073956707",
"out_request_no":"hz01rf001",
"dback_amount":"1.01"
}' \
--data-urlencode 'utc_timestamp=${now}' \
--data-urlencode 'sign=${sign}' \
--data-urlencode 'app_id=${appid}' \
--data-urlencode 'version=1.1' \
--data-urlencode 'sign_type=rsa2' \
--data-urlencode 'notify_id=${notify_id}' \
--data-urlencode 'msg_method=alipay.trade.refund.depositback.completed'说明：notify_url是开发者在开放平台控制台上设置的应用网关地址
通知应答
| 响应报文 | 描述 | 是否重试 | 是否区分大小写 |
|---|---|---|---|
| success | 消息处理成功 | 否 | 否 |
| fail | 消息处理失败 | 是 | 否 |
说明：消息服务会根据响应报文判断商户系统是否已经成功处理消息。如果http同步响应报文返回 success 字符串，消息服务则认为消息已经处理成功，停止投递，如果返回 fail ，表示消息获取失败，支付宝会根据投递重试策略重新发送消息到应用网关地址；
投递重试策略：一般情况下，25 小时以内完成 8 次通知，除了第一次是实时投递外，后续的每次重试都会间隔一段时间，间隔频率一般是：2m、10m、10m、1h、2h、6h、15h（第二次消息投递是在第一次投递失败后的 2 分钟；第三次投递是在第二次投递失败后的 10 分钟，以此类推）
接口工具
消息服务文档
获取sdk