查询二级商户账户实时余额API

电商服务商通过此接口可以查询二级商户账户余额信息。

电商平台可利用分账实现对二级商户的账期, 不建议电商平台利用限制二级商户提现进行账期控制, 特殊情况下商户可直接到微信支付进行提现, 造成账期控制无效。

接口说明

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

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

变量	类型	必填	参数名/描述/示例值
sub_mchid	string(32)	是	`path` `二级商户号` 电商平台二级商户号, 由微信支付生成并下发。
			1900000109

变量	类型	必填	参数名/描述/示例值
sub_mchid	string(32)	是	`二级商户号` 电商平台二级商户号, 由微信支付生成并下发。
			1900000109
available_amount	int64	是	`可用余额` (单位: 分）, 此余额可做提现操作。
			100
pending_amount	int64	否	`不可用余额` (单位: 分）。
			100

正常示例

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

状态码	错误码	描述	解决方案
500	SYSTEM_ERROR	系统错误	系统异常, 请使用相同参数稍后重新调用
403	REQUEST_BLOCKED	二级商户未开启手动提现权限	二级商户号提现权限被冻结, 无法发起提现
400	PARAM_ERROR	参数错误	请使用正确的参数重新调用
400	PARAM_ERROR	参数错误	请使用正确的参数重新调用, 电商平台提交相同商户单号的请求但参数和历史提交的参数不一致
404	ORDER_NOT_EXISTS	提现单号不存在	请检查订单号是否正确
403	NOT_ENOUGH	二级商户号账户可用余额不足	二级商户号账户可用余额不足
403	NO_AUTH	无接口使用权限	请开通商户号相关权限
400	INVALID_REQUEST	二级商户未开启手动提现权限	请确认电商平台商户号和二级商户商户号是否存在受理关系
429	FREQUENCY_LIMITED	频率限制	请降低频率后重试
403	CONTRACT_NOT_CONFIRM	二级商户未开启手动提现权限	二级商户号提现权限已关闭, 无法发起提现
403	ACCOUNT_NOT_VERIFIED	二级商户下行打款未成功	二级商户号结算银行卡信息有误, 修改后重试
403	ACCOUNT_ERROR	二级商户未绑卡	二级商户号没有绑定结算银行卡, 绑定后重试

Was this page helpful?

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