查询特约商户账户实时余额
更新时间:2024.11.18收付通平台通过此接口可以查询二级商户账户余额信息。
|
接口说明
支持商户:【普通服务商】
请求方式:【GET】/v3/ecommerce/fund/balance/{sub_mchid}
请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点
【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看
请求参数
Header HTTP头参数
Authorization 必填 string
请参考签名认证生成认证信息
Accept 必填 string
请设置为application/json
path 路径参数
sub_mchid 必填 string(32)
【特约商户号】 服务商特约商户号,由微信支付生成并下发。
query 查询参数
account_type 选填 string
【账户类型】 枚举值:
BASIC:基本账户
OPERATION:运营账户
FEES:手续费账户
注意:该字段参数不可以放在body参数中,按照请求示列的格式请求
请求示例
GET
应答参数
|
sub_mchid 必填 string(32)
【特约商户号】 服务商特约商户号,由微信支付生成并下发。
account_type 选填 string(16)
【账户类型】 枚举值:
BASIC:基本账户
OPERATION:运营账户
FEES:手续费账户
注意:该字段参数不可以放在body参数中,按照请求示列的格式请求
available_amount 必填 int64
【可用余额】 可用余额(单位:分),此余额可做提现操作
pending_amount 选填 int64
【不可用余额】 不可用余额(单位:分)
应答示例
200 OK
错误码
公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
403 | NO_AUTH | 无权查询该商户余额 | 请确认服务商商户号和特约商户商户号是否存在受理关系 |
403 | NO_AUTH | 无权调用此接口 | 请开通商户号相关权限 |
403 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用,服务商提交相同商户单号的请求但参数和历史提交的参数不一致 |
400 | INVALID_REQUEST | 输入账户类型未开通 | 请检查account_type,并重新调用 |