查询垫付回补结果

更新时间:2024.07.11

提交垫付退款回补后,通过调用该接口查询垫付回补结果。

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

# 接口说明

支持商户:
【普通服务商】
请求方式:
【GET】/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
    Path 路径参数
  • refund_id 必填 string(32)
    【微信退款单号】 必须是垫付退款的微信退款单
    Query 查询参数
  • sub_mchid 必填 string(32)
    【二级商户号】 微信支付分配给二级商户的商户号

请求示例

GET

# 应答参数

    200OK
  • 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

# 错误码

# 公共错误码

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

# 业务错误码

状态码 错误码 描述 解决方案
400 MCH_NOT_EXISTS 商户号不存在 请检查商户号是否正确
401 SIGN_ERROR 参数签名结果不正确 请检查签名参数和方法是否都符合签名算法要求
404 RESOURCE_NOT_EXISTS 垫付回补结果查询失败 请检查退款单号是否有误
500 SYSTEM_ERROR 接口返回错误 请不要更换商户退款单号,请使用相同参数再次调用API
反馈
咨询
目录