退款成功异步通知API(v1.02)
通知地址
通知的地址为发起退款交易的时候上送的notify_url。
通知策略
退款完成后,SaaS会把相关支付结果发送给商户,商户需要接收处理,并返回应答。对后台通知交互时,如果SaaS收到商户的应答不是成功或超时,SaaS认为通知失败,SaaS会通过一定的策略定期重新发起通知。尽可能提高通知的成功率,但不保证通知最终能成功。(通知频率为15/15/30/180/1800/1800/1800/1800/3600,单位:秒)
如果异步通知的状态与查询接口的返回存在不一致,以查询接口的返回为准。
请求参数(O-非必传 ,M-必传):
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
refund_no | 退款订单号 | String | SaaS平台的退款订单编号 | M | |
merch_no | 商户编号 | String | M | ||
out_refund_no | 服务商退款订单号 | String | 服务商退款订单号 | 161018121614000624679888 | M |
refund_amount | 本次退款金额 | String | 以元为单位 | 100 | M |
refund_type | 退款类型 | String | UNIONQR:银联二维码 | UNIONQR | M |
refund_status | 退款状态 | String | 固定为1 | 1 | M |
out_trade_no | 原服务商交易订单号 | String | 原服务商的交易订单编号 | 161018121614000624679888 | M |
trade_no | 原交易订单号 | String | SaaS平台的交易订单号 | M | |
channel_trade_no | 凭证条码订单号 | String | 凭证条码订单号(v1.24增加) | 161018121614000624679888 | M |
total_amount | 原交易订单金额 | String | 以元为单位 | 100 | M |
rate | 费率 | String | M | ||
fee | 手续费 | String | M | ||
total_refund_amount | 原交易已退款金额合计 | String | 以元为单位 | 500 | M |
sn | 厂商终端号 | String | (v1.05增加) | O | |
remark | 交易备注 | String | (v1.05增加) | O | |
fee_subsidy_party | 手续费原补贴方 | String | 手续费原补贴方 | O | |
orig_fee_subsidy_amount | 原交易手续费补贴金额 | String | 原交易手续费补贴金额 | 原交易手续费补贴金额 | C |
refunded_subsidy_amount | 已退手续费补贴金额 | String | 已退手续费补贴金额 | 已退手续费补贴金额 | C |
remanent_subsidy_amount | 剩余未退手续费补贴金额 | String | 剩余未退手续费补贴金额 | 剩余未退手续费补贴金额 | C |
real_fee_subsidy_amount | 本次手续费实际退补金额 | String | 本次手续费实际退补金额 | C | |
card_type | 卡类型 | String | 01-借记卡;02-贷记卡;03-准贷记卡;04-预付费卡(v1.16增加) | 01 | M |
请求示例:
参见微信支付宝异步通知格式,请求内容为本页请求参数!
返回参数:
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
result | 接收结果 | String | 接收成功后返回“SUCCESS” | SUCCESS | M |
返回示例:
{
"result": "SUCCESS"
}
文档更新时间: 2025-02-11 11:09 作者:admin