查询结算账户API

普通服务商(支付机构、银行不可用）, 可使用本接口查询其进件、已签约的特约商户-结算账户信息(敏感信息掩码）。 该接口可用于核实是否成功修改结算账户信息、及查询系统汇款验证结果。

接口说明

适用对象: 普通服务商
请求 URL: https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/{sub_mchid}/settlement
请求方式: GET
接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3

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

请求参数

变量类型必填参数名/描述/示例值
sub_mchidstring(10)是特约商户号 path 请输入本服务商进件、已签约的特约商户号。
特殊规则: 长度最小 8 个字节
1900006491

请求示例

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

返回参数

变量类型必填参数名/描述/示例值
account_typeenum是账户类型 返回特约商户的结算账户类型。
枚举值:
ACCOUNT_TYPE_BUSINESS: 对公银行账户
ACCOUNT_TYPE_PRIVATE: 经营者个人银行卡
ACCOUNT_TYPE_BUSINESS
account_bankstring(128)是开户银行 返回特约商户的结算账户-开户银行全称。
工商银行
bank_namestring(128)是开户银行全称(含支行) 返回特约商户的结算账户-开户银行全称(含支行）。
施秉县农村信用合作联社城关信用社
bank_branch_idstring(128)是开户银行联行号 返回特约商户的结算账户-联行号。
402713354941
account_numberstring(128)是银行账号 返回特约商户的结算账户-银行账号, 掩码显示。
62*************78
verify_resultenum是汇款验证结果 返回特约商户的结算账户-汇款验证结果。
VERIFYING: 系统汇款验证中, 商户可发起提现尝试。
VERIFY_SUCCESS: 系统成功汇款, 该账户可正常发起提现。
VERIFY_FAIL: 系统汇款失败, 该账户无法发起提现, 请检查修改。
VERIFY_SUCCESS

返回示例

正常示例

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

错误码公共错误码

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


最后修改 April 12, 2020: 整理文档 (f36b91e)