微信支付-开发者文档

返回上一层文档首页 / 查询结算账号API

查询结算账户API

最新更新时间：2021.06.18 版本说明

服务商/电商平台（不包括支付机构、银行），可使用本接口，查询其进件且已签约特约商户/二级商户的结算账户信息（敏感信息掩码）。该接口可用于核实是否成功修改结算账户信息、及查询系统汇款验证结果。

接口说明

适用对象：服务商电商平台

请求URL：https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/{sub_mchid}/settlement

请求方式：GET

path指该参数为路径参数

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

body 指该参数需在请求JSON传参

请求参数

参数名	变量	类型[长度限制]	必填	描述
特约商户/二级商户号	sub_mchid	string[8,10]	是	path 请输入本服务商进件、已签约的特约商户/二级商户号。示例值：1900006491

请求示例


https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/1900006491/settlement

    
｛
JAVA示例代码
｝

返回参数

参数名	变量	类型[长度限制]	必填	描述
账户类型	account_type	string[1,32]	是	返回特约商户的结算账户类型。枚举值： ACCOUNT_TYPE_BUSINESS：对公银行账户 ACCOUNT_TYPE_PRIVATE：经营者个人银行卡示例值：ACCOUNT_TYPE_BUSINESS
开户银行	account_bank	string[1,128]	是	返回特约商户的结算账户-开户银行全称。示例值：工商银行
开户银行全称（含支行）	bank_name	string[1,128]	否	返回特约商户的结算账户-开户银行全称（含支行）。示例值：施秉县农村信用合作联社城关信用社
开户银行联行号	bank_branch_id	string[1,128]	否	返回特约商户的结算账户-联行号。示例值：402713354941
银行账号	account_number	string[1,128]	是	返回特约商户的结算账户-银行账号，掩码显示。示例值：62*************78
汇款验证结果	verify_result	string[1,32]	是	返回特约商户的结算账户-汇款验证结果。 VERIFYING：系统汇款验证中，商户可发起提现尝试。 VERIFY_SUCCESS：系统成功汇款，该账户可正常发起提现。 VERIFY_FAIL：系统汇款失败，该账户无法发起提现，请检查修改。注：该字段，入驻后若没有修改过银行卡，除非汇款失败，否则是不返回的示例值：VERIFY_SUCCESS
汇款验证失败原因	verify_fail_reason	string[1, 1024]	否	如果汇款验证成功为空，汇款验证失败为具体原因。示例值：用户姓名/证件/手机不匹配，请核对后重试

返回示例

正常示例


{
  "account_type": "ACCOUNT_TYPE_BUSINESS",
  "account_bank": "工商银行",
  "bank_name": "施秉县农村信用合作联社城关信用社",
  "bank_branch_id": "402713354941",
  "account_number": "***************8678",
  "verify_result": "VERIFY_SUCCESS"
}


    http://2323weixin.qq.com

错误码公共错误码

错误码	描述	解决方案
SYSTEMERROR	系统错误	系统异常，请使用相同参数稍后重新调用
PARAM_ERROR	参数错误	请使用正确的参数重新调用
INVALID_REQUEST	无效请求	请查看返回的错误信息，根据错误信息进行操作
NOAUTH	商户权限异常	请确认是否已经开通相关权限