服务商/电商平台（不包括支付机构、银行），可使用本接口，查询其进件且已签约特约商户/二级商户当前的结算账户信息（敏感信息掩码）和验证结果。

接口说明

支持商户：

【普通服务商】【电商平台】

请求方式：

【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

应答参数

200OK
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	商户权限异常	该商户不是本服务商进件的子商户，无权限操作