关闭

Login expired. Please log in again.

Feedback

0/300
Submit

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

子商户进件API

接入指引
接口规则
参数规定
开发指引
公共API
进件子商户
查询子商户
修改子商户
联系我们
联系我们
返回上一层 子商户进件 / 查询子商户API

查询子商户

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


用于机构查询子商户创建是否成功，接口只提供单个子商户信息查询。


接口说明

适用对象:机构模式

请求URL: https://api.mch.weixin.qq.com/secapi/mch/queryInstitutionsub

请求方式: POST

是否需要证书: 是

请求参数

参数名 变量 类型 必填 描述
机构appid app_id string(32) 是 机构在微信公众平台申请服务号对应的APPID
示例值：wx8888888888888888
机构商户号 mch_id string(32) 是 微信支付分配的机构商户号
示例值：3200000001
子商户号 sub_mch_id string(32) 是 子商户号
示例值：20000100
签名 sign string(32) 是 参数签名，详见签名方法
示例值：C380BEC2BFD727A4B6845133519F3AD6

请求示例：

<xml> 				
 <app_id><![CDATA[wx8888888888888888]]></app_id>
 <mch_id><![CDATA[示例值：3200000001]]></mch_id>
 <sub_mch_id><![CDATA[20000100]]></sub_mch_id>
 <sign><![CDATA[C380BEC2BFD727A4B6845133519F3AD6]]></sign>
</xml>

返回参数

正常返回

字段名 变量 类型 必填 描述
返回状态码 return_code string(16) 是 SUCCESS/FAIL
此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断
示例值：SUCCESS
返回信息 return_msg string(128) 否 返回信息，如非空，为错误原因
签名失败
参数格式校验错误
示例值：签名失败

当return_code为SUCCESS的时候，会包括以下字段：


参数名 变量 类型 必填 描述
业务返回码 result_code string(16) 是 业务结果 SUCCESS/FAIL
示例值：SUCCESS
错误编码 err_code string(32) 否 详细参见错误列表
示例值：SYSTEMERROR
错误描述 err_code_des string(128) 否 错误信息描述
示例值：系统错误
签名 sign string(32) 是 签名信息
示例值：C380BEC2BFD727A4B6845133519F3AD6
子商户号 sub_mch_id string(32) 是 微信支付系统生成的子商户号
示例值：1234567
子商户名称 merchant_name string(128) 是 子商户公司注册的名称
示例值：7-11
子商户简称 merchant_shortname string(64) 是 子商户简称，用于微信订单详情和支付成功页展示
示例值：Merchant shortname
注册国家或区域 merchant_country_code string(3) 否 公司所注册的国家或区域，详见国家/地区代码
示例值：344
业务类目 business_category string(10) 是 业务类目，详见业务类目列表
示例值：101
MCC mcc string(4) 否 Mcc码，请参考商户行业编码
示例值：075586010000
公司联系电话 office_phone string(32) 是 商户联系方式，用户支付完成后展示给用户的商家联系方式
示例值：075586010000
联系人姓名 contact_name string(64) 否 联系人姓名
示例值：张三
联系人手机 contact_phone string(32) 否 联系人手机
示例值：1800000000
联系人邮箱 contact_email string(256) 否 联系人邮箱
示例值：test@test.com
子商户唯一标识 merchant_remark string(20) 是 机构为商户备注的信息，可以是商户在机构系统的商户编号
示例值：ABC1234567
业务类型 business_type string(7) 否 取值为三种业务类型：ONLINE, OFFLINE 或BOTH
示例值：BOTH
商户类型 merchant_type string(10) 否 取值ENTERPRISE或INDIVIDUAL
示例值：ENTERPRISE
公司注册文件编号 registration_certificate_number string(50) 否 公司注册文件编号，当商户类型取值为ENTERPRISE时必填
示例值：5555-8888
公司注册文件过期时间 registration_certificate_date string(10) 否 公司注册文件过期时间。取值为过期的日期或取值为“PERMANENT” , “N/A”, 若取值为日期，格式为YYYY-MM-DD，比如：2020-10-16。当商户类型为ENTERPRISE时必填。
示例值：2020-10-16
APP下载链接 app_download string(128) 否 商户APP的下载地址
示例值：https://download.qq.com
业务网站 business_website string(128) 否 商户的业务网站地址
示例值：https://www.qq.com
公众号 office_account string(128) 否 商户的公众号appid
示例值：wx8888888888888888
小程序 mini_program string(128) 否 商户的小程序appid
示例值：wx8888888888888888
门店地址 store_address string(128) 否 商户的门店地址
示例值：10F World Finance Centre (South Office), 11 Canton Road, Tsim Sha Tsui, Hong Kong
董事姓名 director_name string(128) 否 董事姓名
示例值：Bob Zhang
董事证件编号 director_id_number string(128) 否 董事证件编号
示例值：5555-8888
负责人姓名 principal_name string(128) 否 负责人姓名
示例值：Bob Zhang
负责人证件编号 principal_id_number string(128) 否 负责人证件编号
示例值：5555-8888
子商户结算银行账户 settlement_bank_number string(128) 否 子商户结算银行账户信息
示例值：555588889999
渠道编号 channel_id string(20) 否 机构合作渠道的编号，通过商户平台创建
示例值：101
H5支付权限状态 h5_authorization_state string(32) 否 描述子商户的H5支付权限状态：
APPROVED：已有H5权限；
UNAUTHORIZED：未获得H5权限，也未申请过H5权限；
UNDER_REVIEW：H5权限申请当前在审核中；
REJECTED：H5权限申请被驳回，请于h5_audit_reject_detail字段查看驳回原因；
UNDER_PUNISHMENT：曾经申请并获得H5权限，但当前权限被处罚，请联系BD处理；
APPLICATION_FAILED：H5权限申请单创建失败，请于h5_audit_reject_detail字段查看失败原因
示例值：APPROVED
H5驳回详情 h5_audit_reject_detail string(1024) 否 H5支付权限状态为REJECTED或APPLICATION_FAILED时返回；申请单被驳回的原因或申请失败原因。
示例值：商户证书无效
子商户状态 sub_mch_status string(32) 是 子商户状态，表示当前该子商户在微信支付系统内的状态：
OPERATING：正常；子商户权限正常，可发起交易；
PENDING：待处理；子商户资料未通过日常审核，需要机构登录微信支付商户平台查看和处理。子商户权限正常，可发起交易；
DEACTIVATED：已停用；该子商户被机构自主停用，无支付权限，不能发起交易；
CLOSED：已关闭；该子商户被微信支付关闭支付权限，不能发起交易；
INCOMPLETE_APPLICATION：未完成入驻；子商户入驻申请未完成，无支付权限，不能发起交易。请于application_status字段查看入驻申请状态
示例值：OPERATING
子商户入驻状态 application_status string(32) 否 子商户状态为
INCOMPLETE_APPLICATION时返回；子商户入驻申请状态：
UNDER_REVIEW：审核中；微信支付正在审核该子商户的入驻申请，请耐心等待；建议每隔一天查询一次子商户状态，直至子商户流转到其他状态；
REJECTED：已驳回；该子商户的入驻申请被微信支付驳回，请于application_rejected_detail字段查看驳回原因
示例值：UNDER_REVIEW
子商户入驻驳回详情 application_reject_detail string(4096) 否 子商户入驻状态为REJECTED时返回；入驻申请被微信支付的审核人员驳回的原因，以json array形式展示每个被驳回的字段(field)及驳回原因(reason)
如申请被驳回，请登录微信支付商户平台，按要求修改申请信息后重新提交（暂不支持API）
示例值：[{"field":"contact_name","reason":"contact name is invalid."},{"field":"contact_phone","reason":"contact phone is invalid."}]

返回示例：

<xml> 				
   <return_code><![CDATA[SUCCESS]]></return_code> 
   <return_msg><![CDATA[OK]]></return_msg> 
   <result_code><![CDATA[SUCCESS]]></result_code> 
   <sign><![CDATA[C380BEC2BFD727A4B6845133519F3AD6]]></sign> 
   <sub_mch_id><![CDATA[013467007045764]]></sub_mch_id> 
   <merchant_name><![CDATA[ABC Merchant]]></merchant_name> 
   <merchant_shortname><![CDATA[ABC]]></merchant_shortname> 
   <merchant_country_code><![CDATA[344]]></merchant_country_code> 
   <business_category><![CDATA[101]]></business_category>
   <mcc><![CDATA[4214]]></mcc>
   <office_phone><![CDATA[075586010000]]></office_phone> 
   <contact_name><![CDATA[Eric Lee]]></contact_name>
   <contact_phone><![CDATA[13000000000]]></contact_phone>
   <contact_email><![CDATA[test@xxx.com]]></contact_email>
   <merchant_remark><![CDATA[ABC1234567]]></merchant_remark>
   <h5_authorization_state><![CDATA[APPROVED]]></h5_authorization_state>
   <sub_mch_status><![CDATA[OPERATING]]></sub_mch_status>
</xml>
<xml> 				
   <return_code><![CDATA[SUCCESS]]></return_code> 
   <return_msg><![CDATA[OK]]></return_msg> 
   <result_code><![CDATA[SUCCESS]]></result_code> 
   <sign><![CDATA[C380BEC2BFD727A4B6845133519F3AD6]]></sign> 
   <sub_mch_id><![CDATA[013467007045764]]></sub_mch_id> 
   <merchant_name><![CDATA[ABC Merchant]]></merchant_name> 
   <merchant_shortname><![CDATA[ABC]]></merchant_shortname> 
   <merchant_country_code><![CDATA[344]]></merchant_country_code> 
   <business_category><![CDATA[101]]></business_category>
   <mcc><![CDATA[4214]]></mcc>
   <office_phone><![CDATA[075586010000]]></office_phone> 
   <contact_name><![CDATA[Eric Lee]]></contact_name>
   <contact_phone><![CDATA[13000000000]]></contact_phone> 
   <contact_email><![CDATA[test@xxx.com]]></contact_email>
   <merchant_remark><![CDATA[ABC1234567]]></merchant_remark>
   <h5_authorization_state><![CDATA[APPROVED]]></h5_authorization_state>
   <sub_mch_status>><![CDATA[INCOMPLETE_APPLICATION]]></sub_mch_status>
   <application_status><![CDATA[REJECTED]]></application_status>
   <application_reject_detail><![CDATA[[{"field":"contact_name","reason":"contact name is invalid."},{"field":"contact_phone","reason":"contact phone is invalid."}]]]></application_reject_detail>
</xml>

错误码

错误编码 描述 原因 解决方案
INVALID_REQUEST 请求错误 请使用HTTP POST 方式，检查后重新尝试。 请开发人员请求数据
INVALID_REQUEST 请求异常 XML格式异常，请检查格式，重新尝试
SIGNERROR 签名错误 签名校验失败，请检查签名数据，重新尝试。
INVALID_REQUEST 请求错误 请使用字符集UTF-8.
PARAM_ERROR 参数错误 参数错误，请检查重新尝试。
例如：参数超过限定长度。 		请检查参数
PARAM_ERROR 参数错误 参数错误，请检查重新尝试。
例如：参数格式错误。
INVALID_REQUEST 请求错误 没有进件子商户的权限。 请检查权限
INVALID_REQUEST 请求错误 检索客户端证书序列号失败&\160；
来自客户端证书的可分辨名称（DN）字段失败&\160；
证书验证失败。
没有携带证书。请检查后重新尝试。		 请检查证书
INVALID_REQUEST 请求错误 商户信息校验时发生系统错误。
输入字段包含不适当的术语。检查并再次输入。
输入字段包含不符合服务规则的不适当术语。检查并再次输入。
由于违规，权限被限制。有关详细信息，请联系客户服务。
请检查输入信息或联系微信支付
SYSTEMERROR 系统错误 系统错误 请联系微信支付技术支持


版本说明

关闭
V1.3
2023年11月7日
支持通过子商户查询接口查询子商户状态；新增字段：sub_mch_status, application_status, application_reject_detail
V1.2
2023年9月12日
1.支持通过子商户查询接口查询H5支付权限状态；新增字段：h5_authorization_state, h5_audit_reject_detail
V1.1
2020年12月24日
1. 添加字段：merchant_country_code, mcc,business_type, merchant_type, registration_certificate_number,registration_certificate_date, registration_certificate_copy, app_download, business_website, office_account, mini_program, store_address, director_name, director_id_number, principal_name, principal_id_number, settlement_bank_number.
删除字段：website，total 和 merchant_introduction
V1.0
2020年6月08日
1. 查询子商户接口上线

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

ICP证

粤B2-20090059

Back to top