适用对象：电商平台
请求URL：https://api.mch.weixin.qq.com/v3/ecommerce/refunds/{refund_id}/return-advance
请求方式：POST
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信退款单号 | refund_id | string[1, 32] | 是 | path微信支付退款单的主键，唯一定义此资源的标识。
必须是垫付退款的微信支付退款单。
示例值：50000000382019052709732678859 |
| 二级商户号 | sub_mchid | string[1, 32] | 是 | body微信支付分配给二级商户的商户号 示例值：1900000109 |
{
"sub_mchid": "1900000109"
}
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信退款单号 | refund_id | string[1, 32] | 是 | 必须是垫付退款的微信退款单 示例值：50000000382019052709732678859 |
| 微信回补单号 | advance_return_id | string[1, 32] | 是 | 微信支付生成的垫付回补操作单号 示例值：1215562501201407033233368018 |
| 垫付回补金额 | return_amount | int | 是 | 退款单对应的垫付退款的金额 示例值：888 |
| 出款方商户号 | payer_mchid | string[1, 32] | 是 | 微信支付分配给出款方的商户号 示例值：1900000109 |
| 出款方账户 | payer_account | string[1, 32] | 是 | 枚举值： BASIC：基本账户 OPERATION：运营账户 示例值：BASIC |
| 入账方商户号 | payee_mchid | string[1, 32] | 是 | 微信支付分配给入账方的商户号 示例值：1900000108 |
| 入账方账户 | payee_account | string[1, 32] | 是 | 枚举值： BASIC：基本账户 OPERATION：运营账户 示例值：BASIC |
| 垫付回补结果 | result | string[1, 32] | 是 | 枚举值： SUCCESS：回补成功 FAILED：回补失败 PROCESSING：处理中 示例值：SUCCESS |
| 垫付回补完成时间 | success_time | string[1, 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年05月20日13点29分35秒。 示例值：2018-06-08T10:34:56+08:00 |
{
"refund_id": "50000000382019052709732678859",
"advance_return_id": "1215562501201407033233368018",
"return_amount": 888,
"payer_mchid": "1900000109",
"payer_account": "BASIC",
"payee_mchid": "1900000108",
"payee_account": "BASIC",
"result": "SUCCESS",
"success_time": "2018-06-08T10:34:56+08:00"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 接口返回错误 | 请不要更换商户退款单号，请使用相同参数再次调用API。 |
| 404 | RESOURCE_NOT_EXISTS | 退款单不存在 | 请检查退款单号是否有误以及订单状态是否正确，如：未支付、已支付未退款 |
| 400 | PARAM_ERROR | 参数错误 | 请求参数错误，请重新检查再调用退款申请 |
| 400 | MCH_NOT_EXISTS | 商户号不存在 | 请检查商户号是否正确 |
| 403 | NOT_ENOUGH | 余额不足 | 此状态代表退款申请失败，商户可根据具体的错误提示做相应的处理 |
| 400 | INVALID_REQUEST | 请求参数符合参数格式，但不符合业务规则 | 此状态代表退款申请失败，商户可根据具体的错误提示做相应的处理 |
| 403 | REQUEST_BLOCKED | 请求受阻 | 此状态代表退款申请失败，商户可根据具体的错误提示做相应的处理 |
| 403 | NO_AUTH | 没有垫付回补权限 | 此状态代表垫付退款回补失败，请检查是否有垫付回补这笔退款单的权限 |