查询电商平台账户实时余额API

电商平台可通过此接口可以查询本商户号的账号余额情况。

接口说明

适用对象: 电商平台
请求 URL: https://api.mch.weixin.qq.com/v3/merchant/fund/balance/{account_type}
请求方式: GET
接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3

path 指该参数需在请求 URL 传参
query 指该参数需在请求 JSON 传参

请求参数

变量类型必填参数名/描述/示例值
account_typestring是path 账户类型 枚举值:
BASIC: 基本账户
OPERATION: 运营账户
FEES: 手续费账户
BASIC

请求示例

URL https://api.mch.weixin.qq.com/v3/merchant/fund/balance/BASIC

返回参数

变量类型必填参数名/描述/示例值
available_amountint64是可用余额(单位: 分）, 此余额可做提现操作。
100
pending_amountint64否不可用余额(单位: 分）。
100

返回示例

正常示例

{
  "available_amount": 10000,
  "pending_amount": 0
}

错误码公共错误码

状态码错误码描述解决方案
403NO_AUTH当前商户号没有使用该接口的权限请确认是否已经开通相关权限
400INVALID_REQUEST输入账户类型未开通请检查 account_type, 并重新调用
400PARAM_ERROR参数错误请使用正确的参数重新调用

最后修改 April 12, 2020: 整理文档 (f36b91e)