垫付退款回补
更新时间:2024.07.11提交垫付退款后,发起退款方可通过该接口发起垫付退款资金回补,把退款垫付的资金从二级商户回补到电商平台账户。
- 垫付回补结果为处理中,微信支付会在90天内定期重试,重试结果需要查单确认。此状态下商户可以重试。
- 若处理中状态重试90天后出款方账户仍然余额不足,回补结果将置为回补失败,系统不再重试,商户也无法重试,后续不能再发起此退款单的回补。回补处理期间请确保出款账户余额足够。
- 垫付退款能力需先开通,才能使用。若需要开通,请联系微信支付客服。
# 接口说明
支持商户:
【普通服务商】
请求方式:
【POST】/v3/ecommerce/refunds/{refund_id}/return-advance
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看
# 请求参数
- Authorization 必填请参考 签名认证 生成认证信息
- Accept 必填请设置为
application/json
- Content-Type 必填请设置为
application/json
Header HTTP头参数
- refund_id 必填【微信退款单号】 必须是垫付退款的微信退款单
Path 路径参数
- sub_mchid 必填【二级商户号】 微信支付分配给二级商户的商户号
Body 包体参数
请求示例
POST
# 应答参数
- refund_id 必填【微信退款单号】 必须是垫付退款的微信退款单
- advance_return_id 必填【微信回补单号】 微信支付生成的垫付回补操作单号
- return_amount 必填【垫付回补金额】 退款单对应的垫付退款的金额
- payer_mchid 必填【出款方商户号】 微信支付分配给出款方的商户号
- payer_account 必填【出款方账户】 BASIC 基本账户
OPERATION 运营账户 - payee_mchid 必填【入账方商户号】 微信支付分配给入账方的商户号
- payee_account 必填【入账方账户】 BASIC 基本账户
OPERATION 运营账户 - result 必填【垫付回补结果】 SUCCESS 回补成功
FAILED 回补失败,出款方账户余额不足时发生
PROCESSING 处理中 - success_time 选填【垫付回补完成时间】 垫付回补完成的时间,遵循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秒。
200OK
应答示例
200 OK
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
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 |
文档是否有帮助