退款清分成功异步通知API

通知地址
通知的地址为发起退款交易的时候上送的notify_url。

通知策略
退款清分完成后，SaaS会把相关清分结果发送给商户，商户需要接收处理，并返回应答。对后台通知交互时，如果SaaS收到商户的应答不是成功或超时，SaaS认为通知失败，SaaS会通过一定的策略定期重新发起通知。尽可能提高通知的成功率，但不保证通知最终能成功。(通知频率为15/15/30/180/1800/1800/1800/1800/3600，单位：秒)

如果异步通知的状态与查询接口的返回存在不一致，以查询接口的返回为准。

请求参数(O-非必传 ,M-必传,C-选传)

参数 参数名称 类型 参数说明 样例 可空
agent_no 服务商编号 String M
merch_no 海科商户编号 String(32) 海科商户编号 M
out_refund_no 服务商退款订单号 String M
refund_no 海科退款订单号 String M
pay_type 支付类型 String WX：微信支付
ALI：支付宝支付
UNIONQR：云闪付		 M
refund_amount 退款金额 String 退款金额（单位：元） M
discount_amount 免充值优惠券金额 String 不走结算资金的免充值型优惠券金额（单位：元,支持2位小数） O
trade_status 交易状态 String 1：交易成功
2：交易失败
3：交易进行中		 M
clear_status 清算状态 String 1：已清算
2：未清算		 固定是1 M
real_fee_amount 实收手续费金额 String 实收手续费金额（单位：元,支持2位小数） M
settle_amount 交易结算金额 String 交易结算金额（单位：元,支持2位小数） M
trade_rate 交易费率 String 交易费率，单位：%
clear_status=1时返回		 0.38 M
attach 通道原生参数 String O

请求示例:

{
    "out_refund_no": "440000199711151124",
    "refund_no": "WX240410170222000818227131",
    "sign": "96853DF7B2285AC4CD6A09EC61C2158D",
    "agent_no": "FW3002100",
    "trade_status": "1",
    "refund_amount":"0.01",
    "settle_amount": "0.01",
    "clear_status": "1",
    "real_fee_amount": "0.00",
    "trade_rate": "0.38",
    "pay_type": "WX",
    "attach": "{
        \"nonce_str\": \"c720449a331a43d192747e04bc15e35e\",
        \"out_refund_no\": \"WX240410170222000818227131\",
        \"settlement_refund_fee\": \"1\",
        \"cert_id\": \"4233741533\",
        \"return_msg\": \"成功\",
        \"fee_type\": \"CNY\",
        \"mch_id\": \"1505378701\",
        \"sub_mch_id\": \"626185853\",
        \"refund_id\": \"50103409282024041029404142563\",
        \"coupon_refund_fee\": \"0\",
        \"refund_create_time\": \"2024-04-10 17:02:22\",
        \"appid\": \"wx17728c1a8fa300d6\",
        \"refund_fee\": \"1\",
        \"result_code\": \"SUCCESS\",
        \"cash_refund_fee\": \"1\",
        \"sign_type\": \"SM2\",
        \"return_code\": \"SUCCESS\"
    }"
}

返回参数(O-非必传 ,M-必传,C-选传)

参数 参数名称 类型 参数说明 样例 可空
return_code 返回状态码 String(16) SUCCESS/FAIL
SUCCESS表示商户接收通知成功并校验成功		 M
return_msg 返回信息 String(128) 当return_code为FAIL时返回信息为错误原因 O

返回示例:

{
    "return_code": "SUCCESS"
}
文档更新时间: 2024-08-20 10:14   作者：陈文