商家充值退款余额查询

更新时间: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 微信支付分配的特约商户号, 用于服务商查询特约商户的充值退款余额
注意:仅在普通服务商代理查询特约商户充值退款余额场景的时候需要填写此参数, 其它情况都不需要填写该参数
示例值:1900000109

请求示例

直联模式

1curl -X GET \
2	https://apihk.mch.weixin.qq.com/v3/global/refund/recharge-balance

机构模式

1curl -X GET \
2	https://apihk.mch.weixin.qq.com/v3/global/refund/partner/recharge-balance/sub-mchid/1900000109

3. 返回参数

参数名

变量

类型

必填

描述

账户可用余额

id

integer

充值退款外币账户可用余额, 单位是币种的最小单位,只能为整数
示例值:888

币种

out_refund_no

string[3,3]

充值退款外币账户币种, 符合ISO 4217标准的三位字母代码
示例值:HKD

返回示例

1{
2  "remaining_amount": 888,
3  "currency": "HKD"
4}

4. 错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

 

 

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2025 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

Contact Us

Customer Service Tel

+86 571 95017

9:00-18:00 Monday-Friday GMT+8

Business Development

wxpayglobal@tencent.com

Developer Support

wepayTS@tencent.com

Wechat Pay Global

About Tenpay
Powered By Tencent & Tenpay Copyright© 2005-2025 Tenpay All Rights Reserved.