修改子商户

更新时间：2025.02.20

用于机构子商户创建成功后，接口提供子商户信息修改

注意：

● 与入驻子商户API相比，该API删除了merchant_remark参数，增加了sub_mch_id参数。

接口说明

适用对象: 机构模式

请求URL: https://apihk.mch.weixin.qq.com/secapi/mch/modifyInstitutionsub

请求方式: POST

是否需要证书: 是

请求参数

参数名	变量	类型	必填	描述
机构appid	app_id	string(32)	是	机构在微信公众平台申请服务号对应的APPID （该字段不支持修改）示例值：wx8888888888888888
机构商户号	mch_id	string(32)	是	微信支付分配的机构商户号（该字段不支持修改）示例值：3200000001
子商户号	sub_mch_id	string(32)	是	子商户号，微信支付为该商户创建的商户号（该字段不支持修改）示例值：12345678
签名	sign	string(32)	是	参数签名。详见签名方法示例值：C380BEC2BFD727A4B6845133519F3AD6
子商户全称	merchant_name	string(128)	是	子商户公司注册的名称示例值：Merchant name
渠道编号	channel_id	string(20)	否	机构合作渠道的编号，通过商户平台创建示例值：101
子商户简称	merchant_shortname	string(64)	是	子商户简称，用于微信订单详情和支付成功页展示示例值：Merchant shortname
注册国家或区域	merchant_country_code	string(3)	是	公司所注册的国家或区域，详见国家/地区代码示例值：344
商户类型	merchant_type	string(10)	是	取值ENTERPRISE或INDIVIDUAL 示例值：ENTERPRISE
业务类目	business_category	string（3）	是	参考附录，详见业务类目列表示例值：343
MCC码	mcc	string(4)	是	Mcc码，请参考商户行业编码示例值：4214
公司注册文件编号	registration_certificate_number	string(50)	是	公司注册文件编号示例值：5555-8888
公司注册文件过期时间	registration_certificate_date	string(10)	是	公司注册文件过期时间。取值为过期的日期或取值为“PERMANENT” , “N/A”, 若取值为日期，格式为YYYY-MM-DD，比如：2020-10-16。示例值：2020-10-16
公司注册文件照片	registration_certificate_copy	string(128)	否	公司注册文件的照片，取值为上传文件API返回的media ID. 示例值：aoGhHuxkrIaqB4GzPCeo963zXKcO2hDVD8AjXIpgrj
业务类型	business_type	string(7)	是	取值为三种业务类型：ONLINE, OFFLINE 或BOTH 示例值：BOTH
APP下载链接	app_download	string(128)	是/否	商户APP的下载地址，当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入示例值：https://download.qq.com
业务网站	business_website	string(128)	是/否	当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入示例值：https://www.qq.com
公众号	office_account	string(128)	是/否	当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入示例值：wx8888888888888888
小程序	mini_program	string(128)	是/否	当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入示例值：wx8888888888888888
门店地址	store_address	string(128)	是/否	商户门店地址，当业务类型取值为OFFLINE或BOTH时必传示例值：广东省深圳市南山区科技中一道10000号
门店照片	store_photos	string(1024)	否	商户门店照片，当业务类型取值为OFFLINE或BOTH时建议填写（非必填）。至少上传三张门店照片，取值为上传图片API返回的media ID。多个图片，使用Json数组格式提交。示例值：["1beSM1UtWFrTTtCNYOrlllzaoIwc-RjARO-AP_QprCc","1beSM1UtWFrTTtCNYOrlliXeq8spgRNG46iLYGMaeqc","1beSM1UtWFrTTtCNYOrllooH4tOjn3F-NKYa_K6dAV8"]
董事姓名	director_name	string(128)	否	董事姓名，当商户类型为ENTERPRISE时选择填入示例值：Bob Zhang
董事证件号码	director_id_number	string(128)	否	董事证件号码，当商户类型为ENTERPRISE时选择填入示例值：5555—8888
负责人姓名	principal_name	string(128)	否	负责人姓名。当商户类型为INDIVIDUAL时选择填入示例值：Bob Zhang
负责人证件号	principal_id_number	string(128)	否	负责人证件号码。当商户类型为INDIVIDUAL时选择填入示例值：5555—8888
公司电话	office_phone	string(32)	是	公司电话示例值：075586010000
联系人姓名	contact_name	string(64)	是	联系人姓名示例值：李先生
联系人电话	contact_phone	string(32)	是	联系人电话示例值：075586010000
联系人邮箱	contact_email	string(256)	是	联系人邮箱示例值：test@test.com
子商户结算银行账户	settlement_bank_number	string(128)	否	子商户的结算银行账户信息示例值：555588889999
是否申请H5支付权限	apply_h5_payment	string(4)	否	是否申请H5支付权限，取值YES或NO。如已有H5支付权限但需要修改H5支付域名，需要填写为YES。示例值：YES
H5经营网址	h5_website_url	string(128)	是/否	apply_h5_payment为YES时必填。包含该子商户的主营业务、销售商品/服务及价格、用户可在线下单购买的网址。示例值：https://qq.com
H5支付域名	h5_domains	string(512)	是/否	子商户的结算银行账户信息示例值：["www.qq.com","www.weixin.com"]

请求示例：

1<xml> 				
2 <mch_id>1230000109</mch_id>
3 <mch_id>12345678</mch_id>
4 <app_id><![CDATA[wx7bc98d929da735fe]]></app_id>
5 <merchant_name><![CDATA[Merchant name]]></merchant_name>
6 <merchant_shortname><![CDATA[ABC]]></merchant_shortname>
7 <office_phone><![CDATA[075586010000]]></office_phone>
8 <business_category><![CDATA[343]]></business_category>
9 <merchant_remark><![CDATA[202012041]]></merchant_remark>
10 <merchant_country_code><![CDATA[344]]></merchant_country_code>
11 <contact_name><![CDATA[bob]]></contact_name>
12 <contact_phone><![CDATA[+8618688886666]]></contact_phone>
13 <contact_email><![CDATA[test@tencent.com]]></contact_email>
14 <merchant_type><![CDATA[INDIVIDUAL]]></merchant_type>
15 <registration_certificate_number><![CDATA[5555-8888]]></registration_certificate_number>
16 <registration_certificate_date><![CDATA[2025-08-27]]></registration_certificate_date>
17 <registration_certificate_copy><![CDATA[w7yQFawBtja5uEdm_aoXokv2SDoEmHIPs]]></registration_certificate_copy>
18 <business_type><![CDATA[BOTH]]></business_type>
19 <business_website><![CDATA[http://www.qq.com]]></business_website>
20 <store_address><![CDATA[First Street]]></store_address>
21 <mcc><![CDATA[5045]]></mcc>
22 <apply_h5_payment><![CDATA[YES]]></apply_h5_payment>
23 <h5_website_url><![CDATA[http://www.qq.com]]></h5_website_url>
24 <h5_domains><![CDATA[["www.qq.com","www.weixin.com"]]]></h5_domains>
25 <sign><![CDATA[C47005DF5722D862EFF30E7B8964AE17]]></sign>
26</xml>

返回参数

正常返回

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

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

参数名	变量	类型	必填	描述
业务返回码	result_code	string(32)	是	业务返回码，SUCCESS/FAIL 示例值：SUCCESS
错误编码	err_code	string(32)	否	详细参见错误列表示例值：参数格式校验错误
错误描述	err_code_des	string(128)	否	错误信息描述示例值：系统错误
子商户号	sub_mch_id	string(32)	是	子商户号，微信支付为该商户创建的商户号示例值：12345678
签名	sign	string(32)	是	参数签名,详见签名方法示例值：C380BEC2BFD727A4B6845133519F3AD6
H5支付权限状态	h5_authorization_state	string(32)	否	apply_h5_payment为YES时返回，描述子商户的H5支付权限状态： APPROVED：已有H5权限 UNAUTHORIZED：未获得H5权限，也未申请过H5权限 UNDER_REVIEW：H5权限申请当前在审核中 REJECTED：H5权限申请被驳回 UNDER_PUNISHMENT：曾经申请并获得H5权限，但当前权限被处罚，请联系BD处理； APPLICATION_FAILED：H5权限申请单创建失败示例值：APPROVED

返回示例：

1<xml> 
2 <return_code><![CDATA[SUCCESS]]></return_code>     
3 <return_msg><![CDATA[OK]]></return_msg>     
4 <result_code><![CDATA[SUCCESS]]></result_code> 
5 <sign><![CDATA[C380BEC2BFD727A4B6845133519F3AD6]]></sign>     
6 <sub_mch_id><![CDATA[013467007045764]]></sub_mch_id>    
7</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	请求错误	商户信息校验时发生系统错误。输入字段包含不适当的术语。检查并再次输入。输入字段包含不符合服务规则的不适当术语。检查并再次输入。由于违规，权限被限制。有关详细信息，请联系客户服务。	请检查输入信息或联系微信支付
SYSTEM_ERROR	系统错误	系统错误	请联系微信支付技术支持
INVALID_REQUEST	H5支付权限申请失败	子商户未通过审核，无法修改。	请耐心等待，在审核通过后再次提交。
INVALID_REQUEST	H5支付权限申请失败	商户被处罚，不允许申请开通H5支付权限。	商户支付权限被处罚，请先联系运营人员解除。
INVALID_REQUEST	H5支付权限申请失败	提交的H5经营网址或支付域名存在风险，请联系对接BD处理。	经营网址或者H5支付域名命中黑名单，请联系运营人员申请豁免。