查询账户实时余额
更新时间:2024.12.27商户通过此接口可以查询本商户号的账号余额情况。
# 接口说明
支持商户: 【普通服务商】
请求方式: 【GET】
请求URL: "https://api.mch.weixin.qq.com/v3/merchant/fund/balance/{account_type}"
# 请求参数
- account_type 必填【账户类型】 枚举值:BASIC:基本账户OPERATION:运营账户FEES:手续费账户
Path 路径参数
# 应答参数
- available_amount 必填【可用余额】 可用余额(单位:分),此余额可做提现操作。
- pending_amount 选填【不可用余额】 不可用余额(单位:分)。
请求示例
1https://api.mch.weixin.qq.com/v3/merchant/fund/balance/BASIC
应答示例
1{2 "available_amount": 10000,3 "pending_amount": 04}
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 (opens new window) |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 (opens new window) |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
# 业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
403 | NO_AUTH | 当前商户号没有使用该接口的权限 | 请确认是否已经开通相关权限 |
400 | INVALID_REQUEST | 输入账户类型未开通 | 请检查account_type,并重新调用 |
400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
文档是否有帮助