查询特约商户账户实时余额
更新时间：2023.10.11服务商通过此接口可以查询特约商户账户余额信息。
注意
- 服务商可利用分账实现对特约商户的账期，不建议服务商利用限制特约商户提现进行账期控制，特殊情况下商户可直接到微信支付进行提现，造成账期控制无效。
# 接口说明
支持商户： 【普通服务商】
请求方式： 【GET】
请求URL： "https://api.mch.weixin.qq.com/v3/ecommerce/fund/balance/{sub_mchid}"
# 请求参数
- sub_mchid 必填服务商特约商户号，由微信支付生成并下发。
Path 路径参数
- account_type 选填枚举值：BASIC：基本账户OPERATION：运营账户FEES：手续费账户注意：该字段参数不可以放在body参数中，按照请求示列的格式请求
Query 查询参数
# 应答参数
- sub_mchid 必填服务商特约商户号，由微信支付生成并下发。
- account_type 选填枚举值：BASIC：基本账户OPERATION：运营账户FEES：手续费账户
- 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 接口规则 | 请参阅 接口规则 (opens new window) |
| 401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 (opens new window) |
| 500 | SYSTEM_ERROR | 系统异常，请稍后重试 | 请稍后重试 |
# 业务错误码
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 400 | INVALID_REQUEST | 输入账户类型未开通 | 请检查account_type，并重新调用 |
| 403 | NO_AUTH | 你无权查询该商户余额 | 请确认电商平台商户号和二级商户商户号是否存在受理关系 |
| 403 | NO_AUTH | 你无权调用此接口 | 请确认是否已经开通相关权限 |
| 403 | NO_AUTH | 受理关系无效 | 请检查电商平台和二级商户号的受理关系是否正常 |
文档是否有帮助
