适用对象：电商平台
请求URL：https://api.mch.weixin.qq.com/v3/ecommerce/refunds/{refund_id}/return-advance
请求方式：GET
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信退款单号 | refund_id | string[1, 32] | 是 | path微信支付退款单的主键，唯一定义此资源的标识。
必须是垫付退款的微信支付退款单。
示例值：50000000382019052709732678859 |
| 二级商户号 | sub_mchid | string[1, 32] | 是 | query微信支付分配给二级商户的商户号 示例值：1900000109 |
https://api.mch.weixin.qq.com/v3/ecommerce/refunds/50000000382019052709732678859/return-advance?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 | 商户号不存在 | 请检查商户号是否正确 |
| 401 | SIGN_ERROR | 参数签名结果不正确 | 请检查签名参数和方法是否都符合签名算法要求 |