查询结算账户API

最新更新时间:2019.09.09 版本说明


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

接口说明

适用对象:普通服务商

请求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 指该参数需在请求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] 返回特约商户的结算账户类型。
枚举值:

  1. ACCOUNT_TYPE_BUSINESS:对公银行账户
  2. 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] 返回特约商户的结算账户-汇款验证结果。
  1. VERIFYING:系统汇款验证中,商户可发起提现尝试。
  2. VERIFY_SUCCESS:系统成功汇款,该账户可正常发起提现。
  3. VERIFY_FAIL:系统汇款失败,该账户无法发起提现,请检查修改。
示例值:VERIFY_SUCCESS

返回示例


{
  "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 商户权限异常 请确认是否已经开通相关权限

版本说明

关闭
V1.0
2019.09.09
1. 提交申请单接口上线

技术咨询

反馈有奖