最新更新时间:2020.12.23 版本说明
电商服务商通过此接口可以查询二级商户账户余额信息。
• 电商平台可利用分账实现对二级商户的账期,不建议电商平台利用限制二级商户提现进行账期控制,特殊情况下商户可直接到微信支付进行提现,造成账期控制无效。
适用对象:电商平台
请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/fund/balance/{sub_mchid}
请求方式:GET
path指该参数为路径参数
query指该参数需在请求URL传参
body指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
二级商户号 | sub_mchid | string[1,32] | 是 | path电商平台二级商户号,由微信支付生成并下发。 示例值: 1900000109 |
账户类型 | account_type | string[1,16] | 否 | query枚举值: BASIC:基本账户 OPERATION:运营账户 FEES:手续费账户 示例值: BASIC |
https://api.mch.weixin.qq.com/v3/ecommerce/fund/balance/1900000109?account_type=BASIC
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
二级商户号 | sub_mchid | string[1,32] | 是 | 电商平台二级商户号,由微信支付生成并下发。 示例值: 1900000109 |
账户类型 | account_type | string[1,16] | 否 | 枚举值: BASIC:基本账户 OPERATION:运营账户 FEES:手续费账户 示例值: BASIC |
可用余额 | available_amount | int64 | 是 | 可用余额(单位:分),此余额可做提现操作。 示例值: 100 |
不可用余额 | pending_amount | int64 | 否 | 不可用余额(单位:分)。 示例值: 100 |
{
"sub_mchid": "1900000109",
"available_amount": 10000,
"pending_amount": 0,
"account_type": "BASIC"
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
403 | NO_AUTH | 无权查询该商户余额 | 请确认电商平台商户号和二级商户商户号是否存在受理关系 |
403 | NO_AUTH | 无权调用此接口 | 请开通商户号相关权限 |
400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
400 | INVALID_REQUEST | 输入账户类型未开通 | 请检查account_type,并重新调用 |