查询结算账户

更新时间: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

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/1900006491/settlement \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

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

1{
2  "account_type" : "ACCOUNT_TYPE_BUSINESS",
3  "account_bank" : "工商银行",
4  "bank_name" : "施秉县农村信用合作联社城关信用社",
5  "bank_branch_id" : "402713354941",
6  "account_number" : "62*************78",
7  "verify_result" : "VERIFY_SUCCESS",
8  "verify_fail_reason" : "用户姓名/证件/手机不匹配,请核对后重试"
9}
10

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

403

NO_AUTH

商户权限异常

该商户不是本服务商进件的子商户,无权限操作

 

 

反馈
咨询
目录
置顶