商家充值退款余额查询
更新时间:2025.01.02商户和机构可通过调用此接口查询自身的充值退款外币账户实时余额和对应外币币种。
1. 接口说明
适用对象:直连模式 机构模式
请求URL:https://apihk.mch.weixin.qq.com/v3/global/refund/recharge-balance
或
https://apihk.mch.weixin.qq.com/v3/global/refund/partner/recharge-balance/sub-mchid/{sub_mchid}
请求方式: GET
Path 指该参数为路径参数
Query 指该参数为URL参数
Body 指该参数需在请求JSON传参
2. 请求参数
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
特约商户号 | sub_mchid | string[1,32] | 否 | Path 微信支付分配的特约商户号, 用于服务商查询特约商户的充值退款余额 |
请求示例
直联模式
机构模式
3. 返回参数
参数名 | 变量 | 类型 | 必填 | 描述 |
---|---|---|---|---|
账户可用余额 | id | integer | 是 | 充值退款外币账户可用余额, 单位是币种的最小单位,只能为整数 |
币种 | out_refund_no | string[3,3] | 是 | 充值退款外币账户币种, 符合ISO 4217标准的三位字母代码 |
返回示例
4. 错误码
公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |