適用對象:機構(gòu)模式
請求URL: https://api.mch.weixin.qq.com/secapi/mch/addInstitutionsub
請求方式: POST
是否需要證書: 是
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 機構(gòu)appid | app_id | string(32) | 是 | 機構(gòu)在微信公眾平臺申請服務(wù)號對應(yīng)的APPID 示例值：wx8888888888888888 |
| 機構(gòu)商戶號 | mch_id | string(32) | 是 | 微信支付分配的機構(gòu)商戶號 示例值：3200000001 |
| 簽名 | sign | string(32) | 是 | 參數(shù)簽名。詳見簽名方法 注意：默認加密方式為MD5，且僅支持MD5加密 詳見簽名方法示例值：C380BEC2BFD727A4B6845133519F3AD6 |
| 渠道編號 | channel_id | string(20) | 否 | 機構(gòu)合作渠道的編號，通過商戶平臺創(chuàng)建 示例值：101 |
| 商戶名稱 | merchant_name | string(128) | 是 | 完整的商家實體名稱必須與公司的官方注冊文件（例如營業(yè)執(zhí)照、公司注冊證書、工商注冊證等）中的注冊名稱完全相同。 示例值：Merchant name |
| 子商戶簡稱 | merchant_shortname | string(64) | 是 | 子商戶簡稱，用于微信訂單詳情和支付成功頁展示 示例值：Merchant shortname |
| 子商戶唯一標識 | merchant_remark | string(20) | 是 | 機構(gòu)為商戶備注的信息，可以是商戶在機構(gòu)系統(tǒng)的商戶編號 示例值：ABC123456 |
| 注冊國家或區(qū)域 | merchant_country_code | string(3) | 是 | 公司所注冊的國家或區(qū)域，詳見國家/地區(qū)代碼 示例值：344 |
| 商戶類型 | merchant_type | string(10) | 是 | 取值ENTERPRISE或INDIVIDUAL 若商戶為自然人或獨資經(jīng)營者，請選擇INDIVIDUAL。 示例值：ENTERPRISE |
| 行業(yè)類目 | business_category | string（3） | 是 | 根據(jù)您的營業(yè)執(zhí)照規(guī)定業(yè)務(wù)類別，請參考微信支付的業(yè)務(wù)類目列表 示例值：644 |
| MCC碼 | mcc | string(4) | 是 | Mcc碼，請參考商戶行業(yè)編碼 示例值：4214 |
| 公司注冊文件編號 | registration_certificate_number | string(50) | 是 | 公司注冊文件編號。 若商戶為自然人，請?zhí)峁┒禄蜇撠熑说腎D號。 若商戶為獨資經(jīng)營者，請?zhí)峁┆氋Y經(jīng)營的業(yè)務(wù)資質(zhì)證書編號。 示例值：5555-8888 |
| 公司注冊文件過期時間 | registration_certificate_date | string(10) | 是 | 公司注冊文件過期時間。 取值為過期的日期或取值為“PERMANENT”，“N/A”, 若取值為日期，格式為YYYY-MM-DD，比如2020-10-16。 若商戶為自然人，請?zhí)峁┒禄蜇撠熑说腎D號過期日期。 若商戶為獨資經(jīng)營者，請?zhí)峁┆氋Y經(jīng)營的業(yè)務(wù)資質(zhì)證書編號過期日期。 示例值：2020-10-16 |
| 公司注冊文件照片 | registration_certificate_copy | string(128) | 否 | 請?zhí)峁┕咀晕募膹陀〖Ｈ绻碳沂亲匀蝗耍▊€人），請?zhí)峁┒禄蜇撠熑说纳矸葑C復印件。如果商家是獨資經(jīng)營者（個體戶），請?zhí)峁I業(yè)執(zhí)照的復印件。取值為《上傳圖片API》返回的media ID。 示例值：w7yQFawBtja5uEdm_aoXokv2SDoEmHIPs |
| 業(yè)務(wù)類型 | business_type | string(7) | 是 | 取值為三種業(yè)務(wù)類型：ONLINE, OFFLINE 或BOTH 示例值：BOTH |
| APP下載鏈接 | app_download | string(128) | 是/否 | 商戶APP的下載地址，當業(yè)務(wù)類型取值為ONLINE或BOTH時，app_download, bus_website，office_account, mini_program四項中至少選擇一項傳入 示例值：https://download.qq.com |
| 業(yè)務(wù)網(wǎng)站 | business_website | string(128) | 是/否 | 當業(yè)務(wù)類型取值為ONLINE或BOTH時，app_download, bus_website，office_account, mini_program四項中至少選擇一項傳入 示例值：https://www.qq.com |
| 公眾號 | office_account | string(128) | 是/否 | 當業(yè)務(wù)類型取值為ONLINE或BOTH時，app_download, bus_website，office_account, mini_program四項中至少選擇一項傳入 示例值：wx8888888888888888 |
| 小程序 | mini_program | string(128) | 是/否 | 當業(yè)務(wù)類型取值為ONLINE或BOTH時，app_download, bus_website，office_account, mini_program四項中至少選擇一項傳入 示例值：wx8888888888888888 |
| 門店地址 | store_address | string(128) | 是/否 | 商戶門店地址，當業(yè)務(wù)類型取值為OFFLINE或BOTH時必傳 示例值：廣東省深圳市南山區(qū)科技中一道10000號 |
| 門店照片 | store_photos | string(1024) | 否 | 商戶門店照片，當業(yè)務(wù)類型取值為OFFLINE或BOTH時建議填寫（非必填）。至少上傳三張門店照片，取值為上傳圖片API返回的media ID。多個圖片，使用Json數(shù)組格式提交。 示例值： |
| 董事姓名 | 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) | 是 | 請指定客戶服務(wù)電話號碼。 請使用電話號碼前綴。前綴列表請參見附錄。 示例值：+86075586010000 |
| 聯(lián)系人姓名 | contact_name | string(64) | 是 | 聯(lián)系人姓名 示例值：李先生 |
| 聯(lián)系人電話 | contact_phone | string(32) | 是 | 聯(lián)系人電話 示例值：075586010000 |
| 聯(lián)系人郵箱 | contact_email | string(256) | 是 | 聯(lián)系人郵箱 示例值：test@test.com |
| 子商戶結(jié)算銀行賬戶 | settlement_bank_number | string(128) | 否 | 子商戶的結(jié)算銀行賬戶信息 示例值：555588889999 |
| 是否申請H5支付權(quán)限 | apply_h5_payment | string(4) | 否 | 是否申請H5支付權(quán)限，取值YES或NO。 示例值：YES |
| H5經(jīng)營網(wǎng)址 | h5_website_url | string(128) | 是/否 | apply_h5_payment為YES時必填。包含該子商戶的主營業(yè)務(wù)、銷售商品/服務(wù)及價格、用戶可在線下單購買的網(wǎng)址。 示例值：https://qq.com |
| H5支付域名 | h5_domains | string(512) | 是/否 | apply_h5_payment為YES時必填。拉起H5支付的域名，不超過5個；以json數(shù)組格式提交。 注意：提交的修改的域名列表會覆蓋已有支付域名列表。 示例值：["www.qq.com","www.weixin.com"] |
<xml>
<mch_id>1230000109</mch_id>
<app_id><![CDATA[wx7bc98d929da735fe]]></app_id>
<merchant_name><![CDATA[Merchant name]]></merchant_name>
<merchant_shortname><![CDATA[ABC]]></merchant_shortname>
<office_phone><![CDATA[075586010000]]></office_phone>
<business_category><![CDATA[343]]></business_category>
<merchant_remark><![CDATA[202012041]]></merchant_remark>
<merchant_country_code><![CDATA[344]]></merchant_country_code>
<contact_name><![CDATA[bob]]></contact_name>
<contact_phone><![CDATA[+8618688886666]]></contact_phone>
<contact_email><![CDATA[test@tencent.com]]></contact_email>
<merchant_type><![CDATA[INDIVIDUAL]]></merchant_type>
<registration_certificate_number><![CDATA[5555-8888]]></registration_certificate_number>
<registration_certificate_date><![CDATA[2025-08-27]]></registration_certificate_date>
<registration_certificate_copy><![CDATA[w7yQFawBtja5uEdm_aoXokv2SDoEmHIPs]]></registration_certificate_copy>
<business_type><![CDATA[BOTH]]></business_type>
<business_website><![CDATA[http://www.qq.com]]></business_website>
<store_address><![CDATA[First Street]]></store_address>
<mcc><![CDATA[5045]]></mcc>
<settlement_bank_number><![CDATA[55558888]]></settlement_bank_number>
<sign><![CDATA[C47005DF5722D862EFF30E7B8964AE17]]></sign>
</xml>| 字段名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 返回狀態(tài)碼 | return_code | string(16) | 是 | SUCCESS/FAIL 此字段是通信標識，非交易標識，交易是否成功需要查看result_code來判斷 示例值：SUCCESS |
| 返回信息 | return_msg | string(128) | 否 | 返回信息，如非空，為錯誤原因 簽名失敗 參數(shù)格式校驗錯誤 示例值：簽名失敗 |
當return_code為SUCCESS的時候，會包括以下字段：
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 業(yè)務(wù)返回碼 | result_code | string(32) | 是 | 業(yè)務(wù)返回碼，SUCCESS/FAIL 示例值：SUCCESS |
| 錯誤編碼 | err_code | string(32) | 否 | 詳細參見錯誤列表 示例值：參數(shù)格式校驗錯誤 |
| 錯誤描述 | err_code_des | string(128) | 否 | 錯誤信息描述 示例值：系統(tǒng)錯誤 |
| 子商戶號 | sub_mch_id | string(32) | 是 | 子商戶號，微信支付為該商戶創(chuàng)建的商戶號 示例值：12345678 |
| 簽名 | sign | string(32) | 是 | 參數(shù)簽名,詳見簽名方法 示例值：C380BEC2BFD727A4B6845133519F3AD6 |
| 驗證狀態(tài) | verification_status | string(32) | 是 | 描述子商戶的審核狀態(tài)： Under review： 微信支付審核中，子商戶暫無交易權(quán)限，無法發(fā)起交易（需至微信支付商戶平臺查詢子商戶審核狀態(tài)，審核通過后才可交易） Approved： 微信支付審核通過，子商戶可發(fā)起正常交易 示例值：Under Review |
| 驗證狀態(tài)描述 | description | string(128) | 否 | 審核狀態(tài)描述。 示例值：該子商戶需要通過審核才可生效。請登錄商戶平臺檢查審核狀態(tài)。 |
| H5支付權(quán)限狀態(tài) | h5_authorization_state | string(32) | 否 | apply_h5_payment為YES時返回，描述子商戶的H5支付權(quán)限狀態(tài)： APPROVED：已有H5權(quán)限 UNAUTHORIZED：未獲得H5權(quán)限，也未申請過H5權(quán)限 UNDER_REVIEW：H5權(quán)限申請當前在審核中 REJECTED：H5權(quán)限申請被駁回 UNDER_PUNISHMENT：曾經(jīng)申請并獲得H5權(quán)限，但當前權(quán)限被處罰，請聯(lián)系BD處理； APPLICATION_FAILED：H5權(quán)限申請單創(chuàng)建失敗 示例值：APPROVED |
<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<result_code><![CDATA[SUCCESS]]></result_code>
<sign><![CDATA[2FB58D2C8CF07E2097D628FA10F05287]]></sign>
<sub_mch_id><![CDATA[013467007045764]]></sub_mch_id>
<verification_status><![CDATA[Approved]]></verification_status>
</xml>| 錯誤編碼 | 描述 | 原因 | 解決方案 |
|---|---|---|---|
| INVALID_REQUEST | 請求錯誤 | 請使用HTTP POST 方式，檢查后重新嘗試。 | 請開發(fā)人員請求數(shù)據(jù) |
| INVALID_REQUEST | 請求異常 | XML格式異常，請檢查格式，重新嘗試 | |
| SIGNERROR | 簽名錯誤 | 簽名校驗失敗，請檢查簽名數(shù)據(jù)，重新嘗試。 | |
| INVALID_REQUEST | 請求錯誤 | 請使用字符集UTF-8. | |
| PARAM_ERROR | 參數(shù)錯誤 | 參數(shù)錯誤，請檢查重新嘗試。 例如：參數(shù)超過限定長度。 |
請檢查參數(shù) |
| PARAM_ERROR | 參數(shù)錯誤 | 參數(shù)錯誤，請檢查重新嘗試。 例如：參數(shù)格式錯誤。 |
|
| INVALID_REQUEST | 請求錯誤 | 沒有進件子商戶的權(quán)限。 | 請檢查權(quán)限 |
| INVALID_REQUEST | 請求錯誤 | 檢索客戶端證書序列號失敗&\160； 來自客戶端證書的可分辨名稱（DN）字段失敗&\160； 證書驗證失敗。 沒有攜帶證書。請檢查后重新嘗試。 |
請檢查證書 |
| INVALID_REQUEST | 請求錯誤 | 商戶信息校驗時發(fā)生系統(tǒng)錯誤。 輸入字段包含不適當?shù)男g(shù)語。檢查并再次輸入。 輸入字段包含不符合服務(wù)規(guī)則的不適當術(shù)語。檢查并再次輸入。 由于違規(guī)，權(quán)限被限制。有關(guān)詳細信息，請聯(lián)系客戶服務(wù)。 | 請檢查輸入信息或聯(lián)系微信支付 |
| SYSTEMERROR | 系統(tǒng)錯誤 | 系統(tǒng)錯誤 | 請聯(lián)系微信支付技術(shù)支持 |
| INVALID_REQUEST | H5支付權(quán)限申請失敗 | 商戶被處罰，不允許申請開通H5支付權(quán)限。 | 商戶支付權(quán)限被處罰，請先聯(lián)系運營人員解除。 |
| INVALID_REQUEST | H5支付權(quán)限申請失敗 | 提交的H5經(jīng)營網(wǎng)址或支付域名存在風險，請聯(lián)系對接BD處理。 | 經(jīng)營網(wǎng)址或者H5支付域名命中黑名單，請聯(lián)系運營人員申請豁免。 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證