垫付退款回补

更新时间：2024.11.04

提交垫付退款后，发起退款方可通过该接口发起垫付退款资金回补，把退款垫付的资金从二级商户回补到电商平台账户。

垫付回补结果为处理中，微信支付会在90天内定期重试，重试结果需要查单确认。此状态下商户可以重试。
若处理中状态重试90天后出款方账户仍然余额不足，回补结果将置为回补失败，系统不再重试，商户也无法重试，后续不能再发起此退款单的回补。回补处理期间请确保出款账户余额足够。
垫付退款能力需先开通，才能使用。若需要开通，请联系微信支付客服。

接口说明

支持商户：【普通服务商】

请求方式：【POST】/v3/ecommerce/refunds/{refund_id}/return-advance

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

path 路径参数

refund_id 　必填 string(32)

【微信退款单号】必须是垫付退款的微信退款单

body 包体参数

sub_mchid 　必填 string(32)

【二级商户号】微信支付分配给二级商户的商户号

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/ecommerce/refunds/50000000382019052709732678859/return-advance \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "sub_mchid" : "1900000109"
8  }'
9

应答参数

200 OK

refund_id 　必填 string(32)

【微信退款单号】必须是垫付退款的微信退款单

advance_return_id 　必填 string(32)

【微信回补单号】微信支付生成的垫付回补操作单号

return_amount 　必填 integer

【垫付回补金额】退款单对应的垫付退款的金额

payer_mchid 　必填 string(32)

【出款方商户号】微信支付分配给出款方的商户号

payer_account 　必填 string(32)

【出款方账户】BASIC 基本账户
OPERATION 运营账户

payee_mchid 　必填 string(32)

【入账方商户号】微信支付分配给入账方的商户号

payee_account 　必填 string(32)

【入账方账户】BASIC 基本账户
OPERATION 运营账户

result 　必填 string(32)

【垫付回补结果】SUCCESS 回补成功
FAILED 回补失败，出款方账户余额不足时发生
PROCESSING 处理中

success_time 　选填 string(64)

【垫付回补完成时间】垫付回补完成的时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。

应答示例

200 OK

1{
2  "refund_id" : "50000000382019052709732678859",
3  "advance_return_id" : "1215562501201407033233368018",
4  "return_amount" : 888,
5  "payer_mchid" : "1900000109",
6  "payer_account" : "BASIC",
7  "payee_mchid" : "1900000108",
8  "payee_account" : "BASIC",
9  "result" : "SUCCESS",
10  "success_time" : "2018-06-08T10:34:56+08:00"
11}
12

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	此状态代表退款申请失败，商户可根据具体的错误提示做相应的处理
400	MCH_NOT_EXISTS	商户号不存在	请检查商户号是否正确
403	NO_AUTH	没有垫付回补权限	此状态代表垫付退款回补失败，请检查是否有垫付回补这笔退款单的权限
403	NOT_ENOUGH	余额不足	此状态代表退款申请失败，商户可根据具体的错误提示做相应的处理
403	REQUEST_BLOCKED	请求受阻	此状态代表退款申请失败，商户可根据具体的错误提示做相应的处理
404	RESOURCE_NOT_EXISTS	退款单不存在	请检查退款单号是否有误以及订单状态是否正确，如：未支付、已支付未退款
500	SYSTEM_ERROR	接口返回错误	请不要更换商户退款单号，请使用相同参数再次调用API

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服