跳到主要内容

实时余额查询

实时查询特约商户账户余额信息。

请求接口

openapi/pay/fund/wxSpSubMchBalanceQuery

公共参数

接口协议 - 公共参数

请求参数

参数必填类型说明
sub_mchidString(32)特约商户号
account_typeString(16)账户类型
BASIC:基本账户
OPERATION:运营账户
FEES:手续费账户

content请求实例

{
"sub_mchid": "1900000109",
"account_type": "BASIC",
"offset": 1,
"limit": 20,
"detail_status": "ALL"
}

响应参数

名称必填类型说明
sub_mchidString(32)特约商户号
account_typeString(16)账户类型
available_amountint可用余额,单位:分
pending_amountint不可用余额,单位:分

响应示例

{
"sub_mchid": "1900000109",
"available_amount": 10000,
"pending_amount": 0,
"account_type": "BASIC"
}

错误描述说明

公共返回码

错误描述解决方案
无权查询该商户余额请确认微信服务商商户号和特约商户商户号是否存在受理关系
无权调用此接口请开通微信商户号相关权限
参数错误请使用正确的参数重新调用,服务商提交相同商户单号的请求但参数和历史提交的参数不一致
输入账户类型未开通请检查account_type,并重新调用
预约咨询