退款入账通知

更新时间：2026.05.21

1. 场景说明

不同与支付结果通知 API，退款入账通知表示银行将资金入账给持卡人账户，该通知受银行退款资金入账的处理时效不同而不同，部分银行在退款受理数天后才会发起退款入账通知。本交易设计目标是优化用户体验，退款交易是否清算情况以账单为准。

对后台通知交互时，如果网联收到应答不是成功或超时，网联认为通知失败，网联会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但网联不保证通知最终能成功。注意：同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。

2. 接口说明

2.1 通知参数

字段名	变量名	是否必填	类型	示例值	描述
返回状态码	`return_code`	是	`String(16)`	`SUCCESS`	`SUCCESS/FAIL`。此字段是通信标识，非交易标识，交易是否成功需要查看 `result_code` 来判断。
返回信息	`return_msg`	否	`String(128)`	`签名失败`	返回信息，如非空，为错误原因。签名失败。参数格式校验错误。

以下字段在return_code为SUCCESS的时候有返回：

字段名	变量名	是否必填	类型	示例值	描述
商户号	`mch_id`	是	`String(32)`	`1900000109`	微信支付分配的商户号。
子商户号	`sub_mch_id`	是	`String(32)`	`1900000109`	微信分配的子商户公众账号 ID。
渠道商商户号	`channel_id`	是	`String(32)`	`190000001`	微信支付分配给收单服务商的 ID。
随机字符串	`nonce_str`	是	`String(32)`	`5K8264ILTKCH16CQ2502SI8ZNMTM67VS`	网联返回的随机字符串。
签名	`sign`	是	`String(512)`	`C380BEC2BFD727A4B6845133519F3AD6`	网联返回的签名。
业务结果	`result_code`	是	`String(16)`	`SUCCESS`	`SUCCESS/FAIL`。
错误代码	`err_code`	否	`String(32)`	`SYSTEMERROR`
错误代码描述	`err_code_des`	否	`String(128)`	`系统错误`	错误返回的信息描述。
网联订单号	`transaction_id`	是	`String(32)`	`42485456845646987984546`	网联订单号
商户订单号	`out_trade_no`	是	`String(32)`	`56465799465465`	商户订单号
商户退款单号	`out_refund_no`	是	`String(64)`	`123456651651654`	商户退款单号
网联退款单号	`refund_id`	是	`String(32)`	`524561654864651651`	网联退款单号
退款状态	`refund_status`	是	`String(16)`	`SUCCESS`	退款状态：`SUCCESS`— 退款成功；`REFUND CLOSE`— 退款关闭；`PROCESSING`— 退款处理中；`CHANGE`— 退款异常（退款到银行发现用户的卡作废或者冻结了，导致原路退款银行卡失败）
退款资金来源	`refund_account`	否	`String(30)`	`REFUND_SOURCE_RECHARGE_FUNDS`	`REFUND_SOURCE_RECHARGE_FUNDS` — 可用余额退款 / 基本账户退款；`REFUND_SOURCE_UNSETTLED_FUNDS` — 未结算资金退款。
退款入账账户	`refund_recv_accout`	是	`String(64)`	`招商银行信用卡 0403`	取当前退款单的退款入账方：1）退回银行卡：{银行名称}{卡类型}{卡尾号}2）退回支付用户零钱：支付用户零钱3）退还商户：商户基本账户 / 商户结算银行账户4）退回支付用户零钱通：支付用户零钱通
退款成功时间	`refund_success_time`	否	`String(20)`	`2016-07-25 15:26:26`	退款成功时间，当退款状态为退款成功时有返回。
货币种类	`fee_type`	否	`String(8)`	`CNY`	订单金额货币类型，符合 ISO 4217 标准的三位字母代码，默认人民币：CNY
现金退款金额	`cash_refund_fee`	否	`Int`	`100`	当订单使用了充值型优惠券后返回该参数，应结订单金额 = 订单金额 - 免充值优惠券金额。
标价金额	`total_fee`	是	`Int`	`100`	订单总金额，单位为分
申请退款金额	`refund_fee`	否	`Int`	`100`	退款总金额，单位为分，可以做部分退款
现金支付金额	`cash_fee`	是	`Int`	`100`	订单现金支付金额
现金退款金额	`cash_refund_fee`	是	`Int`	`100`	现金退款金额，单位为分，只能为整数

2.2 返回参数

字段名	变量名	是否必填	类型	示例值	描述
返回状态码	`return_code`	是	`String(16)`	`SUCCESS`	`SUCCESS/FAIL`。`SUCCESS` 表示商户接收通知成功并校验成功。
返回信息	`return_msg`	否	`String(128)`	`签名失败`	返回信息，如非空，为错误原因。签名失败。参数格式校验错误。

注意：网联端在接收通知响应时，只有 http 应答码为 200 时，才会作为接收成功处理。所以，收单机构在成功处理支付通知后，http 应答码一定要返回 200，否则，会造成通知积压、堵塞，影响正常的退款通知。

文档是否有帮助