查询渠道额度

更新时间:2025.09.11

接口限频:单查询渠道额度目标商户号100qps

接口说明

支持商户:【普通商户】

请求方式:【GET】/v3/aggracct-bc/wb-channel/account/balance

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


 Wechatpay-Serial  必填 string

【微信支付公钥ID】或【微信支付平台证书序列号】  请求参数中的敏感字段,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


query  查询参数

 mchid  必填   string(32)

【微信支付商户号】 微信支付商户号


 bal_account_no  必填   string(1024)

【额度台账号】 【加密】额度台账号

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/aggracct-bc/wb-channel/account/balance?mchid=1900016681&bal_account_no=8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  
6

应答参数

200 OK

 in_transit_reduction_exist  选填   boolean

【是否存在在途减额指令】 是否存在在途减额指令


 balance  选填   integer

【额度台账号额度】 额度台账号额度

应答示例

200 OK

1{
2  "in_transit_reduction_exist" : false,
3  "balance" : 1
4}
5

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

403

NO_AUTH

权限异常

请检查 a. 发起商户是否微众技术号商户;b. 参数mchid是否微众渠道聚合商户

429

FREQUENCY_LIMITED

频率超限

请降低请求接口频率

 

元宝AI
反馈
目录
置顶