查询特约商户账户实时余额
更新时间：2024.12.27服务商通过此接口可以查询特约商户账户余额信息。
注意
- 服务商可利用分账实现对特约商户的账期，不建议服务商利用限制特约商户提现进行账期控制，特殊情况下商户可直接到微信支付进行提现，造成账期控制无效。
# 接口说明
支持商户： 【普通服务商】
请求URL： /v3/ecommerce/fund/balance/{sub_mchid}
请求方式： GET
# 请求参数
- sub_mchid 必填【特约商户号】 服务商特约商户号，由微信支付生成并下发。
Path 路径参数
- account_type 选填【账户类型】 枚举值：BASIC：基本账户OPERATION：运营账户FEES：手续费账户 注意：该字段参数不可以放在body参数中，按照请求示列的格式请求
Query 查询参数
# 返回参数
- sub_mchid 必填【特约商户号】 服务商特约商户号，由微信支付生成并下发。
- account_type 选填【账户类型】 枚举值：BASIC：基本账户OPERATION：运营账户FEES：手续费账户 注意：该字段参数不可以放在body参数中，按照请求示列的格式请求
- available_amount 必填【可用余额】 可用余额（单位：分），此余额可做提现操作。
- pending_amount 选填【不可用余额】 不可用余额（单位：分）。
请求示例
1https://api.mch.weixin.qq.com/v3/ecommerce/fund/balance/1900000109?account_type=BASIC返回示例
1{2 "sub_mchid": "1900000109",3 "available_amount": 10000,4 "pending_amount": 0,5 "account_type": "BASIC"6}# 错误码
# 公共错误码
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
| 401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
| 500 | SYSTEM_ERROR | 系统异常，请稍后重试 | 请稍后重试 |
# 业务错误码
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 403 | NO_AUTH | 无权查询该商户余额 | 请确认服务商商户号和特约商户商户号是否存在受理关系 |
| 403 | NO_AUTH | 无权调用此接口 | 请开通商户号相关权限 |
| 403 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用，服务商提交相同商户单号的请求但参数和历史提交的参数不一致 |
| 400 | INVALID_REQUEST | 输入账户类型未开通 | 请检查account_type，并重新调用 |
文档是否有帮助
