查询结算账户
更新时间:2024.11.18服务商/电商平台(不包括支付机构、银行),可使用本接口,查询其进件且已签约特约商户/二级商户当前的结算账户信息(敏感信息掩码)和验证结果。
接口说明
支持商户:【普通服务商】 【平台商户】
请求方式:【GET】/v3/apply4sub/sub_merchants/{sub_mchid}/settlement
请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点
【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看
请求参数
Header HTTP头参数
Authorization 必填 string
请参考签名认证生成认证信息
Accept 必填 string
请设置为application/json
path 路径参数
sub_mchid 必填 string(10)
【特约商户/二级商户号】 请输入本服务商进件、已签约的特约商户/二级商户号。
请求示例
GET
应答参数
200 OK
account_type 必填 string
【账户类型】 返回特约商户的结算账户类型。
可选取值
ACCOUNT_TYPE_BUSINESS
: 对公银行账户ACCOUNT_TYPE_PRIVATE
: 经营者个人银行卡
account_bank 必填 string(128)
【开户银行】 返回特约商户的结算账户-开户银行全称。
bank_name 选填 string(128)
【开户银行全称(含支行)】 返回特约商户的结算账户-开户银行全称(含支行)。
bank_branch_id 选填 string(128)
【开户银行联行号】 返回特约商户的结算账户-联行号。
account_number 必填 string(128)
【银行账号】 返回特约商户的结算账户-银行账号,掩码显示。
verify_result 必填 string
【验证结果】 返回特约商户的结算账户-验证结果。
可选取值
VERIFY_SUCCESS
: 验证成功,该账户可正常发起提现。VERIFY_FAIL
: 验证失败,该账户无法发起提现,请检查修改。VERIFYING
: 验证中,商户可发起提现尝试。
verify_fail_reason 选填 string(1024)
【验证失败原因】 如果验证成功则为空,验证失败则为具体原因。
应答示例
200 OK
错误码
公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
403 | NO_AUTH | 商户权限异常 | 该商户不是本服务商进件的子商户,无权限操作 |