最新更新時(shí)間:2024.03.27版本說明
用于機(jī)構(gòu)子商戶創(chuàng)建成功后,接口提供子商戶信息修改
● 與入駐子商戶API相比,該API刪除了merchant_remark參數(shù),增加了sub_mch_id參數(shù)。
適用對(duì)象:機(jī)構(gòu)模式
請(qǐng)求URL: https://api.mch.weixin.qq.com/secapi/mch/modifyInstitutionsub
請(qǐng)求方式: POST
是否需要證書: 是
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
機(jī)構(gòu)appid | app_id | string(32) | 是 | 機(jī)構(gòu)在微信公眾平臺(tái)申請(qǐng)服務(wù)號(hào)對(duì)應(yīng)的APPID (該字段不支持修改) 示例值:wx8888888888888888 |
機(jī)構(gòu)商戶號(hào) | mch_id | string(32) | 是 | 微信支付分配的機(jī)構(gòu)商戶號(hào) (該字段不支持修改) 示例值:3200000001 |
子商戶號(hào) | sub_mch_id | string(32) | 是 | 子商戶號(hào),微信支付為該商戶創(chuàng)建的商戶號(hào)(該字段不支持修改) 示例值:12345678 |
簽名 | sign | string(32) | 是 | 參數(shù)簽名。詳見簽名方法 示例值:C380BEC2BFD727A4B6845133519F3AD6 |
子商戶全稱 | merchant_name | string(128) | 是 | 子商戶公司注冊(cè)的名稱 示例值:Merchant name |
渠道編號(hào) | channel_id | string(20) | 否 | 機(jī)構(gòu)合作渠道的編號(hào),通過商戶平臺(tái)創(chuàng)建 示例值:101 |
子商戶簡(jiǎn)稱 | merchant_shortname | string(64) | 是 | 子商戶簡(jiǎn)稱,用于微信訂單詳情和支付成功頁(yè)展示 示例值:Merchant shortname |
注冊(cè)國(guó)家或區(qū)域 | merchant_country_code | string(3) | 是 | 公司所注冊(cè)的國(guó)家或區(qū)域,詳見國(guó)家/地區(qū)代碼 示例值:344 |
商戶類型 | merchant_type | string(10) | 是 | 取值ENTERPRISE或INDIVIDUAL 示例值:ENTERPRISE |
業(yè)務(wù)類目 | business_category | string(3) | 是 | 參考附錄,詳見業(yè)務(wù)類目列表 示例值:343 |
MCC碼 | mcc | string(4) | 是 | Mcc碼,請(qǐng)參考商戶行業(yè)編碼 示例值:4214 |
公司注冊(cè)文件編號(hào) | registration_certificate_number | string(50) | 是 | 公司注冊(cè)文件編號(hào) 示例值:5555-8888 |
公司注冊(cè)文件過期時(shí)間 | registration_certificate_date | string(10) | 是 | 公司注冊(cè)文件過期時(shí)間。取值為過期的日期或取值為“PERMANENT” , “N/A”, 若取值為日期,格式為YYYY-MM-DD,比如:2020-10-16。 示例值:2020-10-16 |
公司注冊(cè)文件照片 | registration_certificate_copy | string(128) | 否 | 公司注冊(cè)文件的照片,取值為上傳文件API返回的media ID. 示例值:aoGhHuxkrIaqB4GzPCeo963zXKcO2hDVD8AjXIpgrj |
業(yè)務(wù)類型 | business_type | string(7) | 是 | 取值為三種業(yè)務(wù)類型:ONLINE, OFFLINE 或BOTH 示例值:BOTH |
APP下載鏈接 | app_download | string(128) | 是/否 | 商戶APP的下載地址,當(dāng)業(yè)務(wù)類型取值為ONLINE或BOTH時(shí),app_download, bus_website,office_account, mini_program四項(xiàng)中至少選擇一項(xiàng)傳入 示例值:https://download.qq.com |
業(yè)務(wù)網(wǎng)站 | business_website | string(128) | 是/否 | 當(dāng)業(yè)務(wù)類型取值為ONLINE或BOTH時(shí),app_download, bus_website,office_account, mini_program四項(xiàng)中至少選擇一項(xiàng)傳入 示例值:https://www.qq.com |
公眾號(hào) | office_account | string(128) | 是/否 | 當(dāng)業(yè)務(wù)類型取值為ONLINE或BOTH時(shí),app_download, bus_website,office_account, mini_program四項(xiàng)中至少選擇一項(xiàng)傳入 示例值:wx8888888888888888 |
小程序 | mini_program | string(128) | 是/否 | 當(dāng)業(yè)務(wù)類型取值為ONLINE或BOTH時(shí),app_download, bus_website,office_account, mini_program四項(xiàng)中至少選擇一項(xiàng)傳入 示例值:wx8888888888888888 |
門店地址 | store_address | string(128) | 是/否 | 商戶門店地址,當(dāng)業(yè)務(wù)類型取值為OFFLINE或BOTH時(shí)必傳 示例值:廣東省深圳市南山區(qū)科技中一道10000號(hào) |
門店照片 | store_photos | string(1024) | 否 | 商戶門店照片,當(dāng)業(yè)務(wù)類型取值為OFFLINE或BOTH時(shí)建議填寫(非必填)。至少上傳三張門店照片,取值為上傳圖片API返回的media ID。多個(gè)圖片,使用Json數(shù)組格式提交。 示例值:["1beSM1UtWFrTTtCNYOrlllzaoIwc-RjARO-AP_QprCc","1beSM1UtWFrTTtCNYOrlliXeq8spgRNG46iLYGMaeqc","1beSM1UtWFrTTtCNYOrllooH4tOjn3F-NKYa_K6dAV8"] |
董事姓名 | director_name | string(128) | 否 | 董事姓名,當(dāng)商戶類型為ENTERPRISE時(shí)選擇填入 示例值:Bob Zhang |
董事證件號(hào)碼 | director_id_number | string(128) | 否 | 董事證件號(hào)碼,當(dāng)商戶類型為ENTERPRISE時(shí)選擇填入 示例值:5555—8888 |
負(fù)責(zé)人姓名 | principal_name | string(128) | 否 | 負(fù)責(zé)人姓名。當(dāng)商戶類型為INDIVIDUAL時(shí)選擇填入 示例值:Bob Zhang |
負(fù)責(zé)人證件號(hào) | principal_id_number | string(128) | 否 | 負(fù)責(zé)人證件號(hào)碼。當(dāng)商戶類型為INDIVIDUAL時(shí)選擇填入 示例值:5555—8888 |
公司電話 | office_phone | string(32) | 是 | 公司電話 示例值:075586010000 |
聯(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 |
是否申請(qǐng)H5支付權(quán)限 | apply_h5_payment | string(4) | 否 | 是否申請(qǐng)H5支付權(quán)限,取值YES或NO。 如已有H5支付權(quán)限但需要修改H5支付域名,需要填寫為YES。 示例值:YES |
H5經(jīng)營(yíng)網(wǎng)址 | h5_website_url | string(128) | 是/否 | apply_h5_payment為YES時(shí)必填。包含該子商戶的主營(yíng)業(yè)務(wù)、銷售商品/服務(wù)及價(jià)格、用戶可在線下單購(gòu)買的網(wǎng)址。 示例值:https://qq.com |
H5支付域名 | h5_domains | string(512) | 是/否 | 子商戶的結(jié)算銀行賬戶信息 示例值:["www.qq.com","www.weixin.com"] |
<xml>
<mch_id>1230000109</mch_id>
<mch_id>12345678</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>
<apply_h5_payment><![CDATA[YES]]></apply_h5_payment>
<h5_website_url><![CDATA[http://www.qq.com]]></h5_website_url>
<h5_domains><![CDATA[["www.qq.com","www.weixin.com"]]]></h5_domains>
<sign><![CDATA[C47005DF5722D862EFF30E7B8964AE17]]></sign>
</xml>
字段名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
返回狀態(tài)碼 | return_code | string(16) | 是 | SUCCESS/FAIL 此字段是通信標(biāo)識(shí),非交易標(biāo)識(shí),交易是否成功需要查看result_code來(lái)判斷 示例值:SUCCESS |
返回信息 | return_msg | string(128) | 否 | 返回信息,如非空,為錯(cuò)誤原因 簽名失敗 參數(shù)格式校驗(yàn)錯(cuò)誤 示例值:簽名失敗 |
當(dāng)return_code為SUCCESS的時(shí)候,會(huì)包括以下字段:
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
業(yè)務(wù)返回碼 | result_code | string(32) | 是 | 業(yè)務(wù)返回碼,SUCCESS/FAIL 示例值:SUCCESS |
錯(cuò)誤編碼 | err_code | string(32) | 否 | 詳細(xì)參見錯(cuò)誤列表 示例值:參數(shù)格式校驗(yàn)錯(cuò)誤 |
錯(cuò)誤描述 | err_code_des | string(128) | 否 | 錯(cuò)誤信息描述 示例值:系統(tǒng)錯(cuò)誤 |
子商戶號(hào) | sub_mch_id | string(32) | 是 | 子商戶號(hào),微信支付為該商戶創(chuàng)建的商戶號(hào) 示例值:12345678 |
簽名 | sign | string(32) | 是 | 參數(shù)簽名,詳見簽名方法 示例值:C380BEC2BFD727A4B6845133519F3AD6 |
H5支付權(quán)限狀態(tài) | h5_authorization_state | string(32) | 否 | apply_h5_payment為YES時(shí)返回,描述子商戶的H5支付權(quán)限狀態(tài): APPROVED:已有H5權(quán)限 UNAUTHORIZED:未獲得H5權(quán)限,也未申請(qǐng)過H5權(quán)限 UNDER_REVIEW:H5權(quán)限申請(qǐng)當(dāng)前在審核中 REJECTED:H5權(quán)限申請(qǐng)被駁回 UNDER_PUNISHMENT:曾經(jīng)申請(qǐng)并獲得H5權(quán)限,但當(dāng)前權(quán)限被處罰,請(qǐng)聯(lián)系BD處理; APPLICATION_FAILED:H5權(quán)限申請(qǐng)單創(chuàng)建失敗 示例值:APPROVED |
<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>
</xml>
錯(cuò)誤編碼 | 描述 | 原因 | 解決方案 |
---|---|---|---|
INVALID_REQUEST | 請(qǐng)求錯(cuò)誤 | 請(qǐng)使用HTTP POST 方式,檢查后重新嘗試。 | 請(qǐng)開發(fā)人員請(qǐng)求數(shù)據(jù) |
INVALID_REQUEST | 請(qǐng)求異常 | XML格式異常,請(qǐng)檢查格式,重新嘗試 | |
SIGNERROR | 簽名錯(cuò)誤 | 簽名校驗(yàn)失敗,請(qǐng)檢查簽名數(shù)據(jù),重新嘗試。 | |
INVALID_REQUEST | 請(qǐng)求錯(cuò)誤 | 請(qǐng)使用字符集UTF-8. | |
PARAM_ERROR | 參數(shù)錯(cuò)誤 | 參數(shù)錯(cuò)誤,請(qǐng)檢查重新嘗試。 例如:參數(shù)超過限定長(zhǎng)度。 |
請(qǐng)檢查參數(shù) |
PARAM_ERROR | 參數(shù)錯(cuò)誤 | 參數(shù)錯(cuò)誤,請(qǐng)檢查重新嘗試。 例如:參數(shù)格式錯(cuò)誤。 |
|
INVALID_REQUEST | 請(qǐng)求錯(cuò)誤 | 沒有進(jìn)件子商戶的權(quán)限。 | 請(qǐng)檢查權(quán)限 |
INVALID_REQUEST | 請(qǐng)求錯(cuò)誤 | 檢索客戶端證書序列號(hào)失敗&\160; 來(lái)自客戶端證書的可分辨名稱(DN)字段失敗&\160; 證書驗(yàn)證失敗。 沒有攜帶證書。請(qǐng)檢查后重新嘗試。 |
請(qǐng)檢查證書 |
INVALID_REQUEST | 請(qǐng)求錯(cuò)誤 | 商戶信息校驗(yàn)時(shí)發(fā)生系統(tǒng)錯(cuò)誤。 輸入字段包含不適當(dāng)?shù)男g(shù)語(yǔ)。檢查并再次輸入。 輸入字段包含不符合服務(wù)規(guī)則的不適當(dāng)術(shù)語(yǔ)。檢查并再次輸入。 由于違規(guī),權(quán)限被限制。有關(guān)詳細(xì)信息,請(qǐng)聯(lián)系客戶服務(wù)。 | 請(qǐng)檢查輸入信息或聯(lián)系微信支付 |
SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)錯(cuò)誤 | 請(qǐng)聯(lián)系微信支付技術(shù)支持 |
INVALID_REQUEST | H5支付權(quán)限申請(qǐng)失敗 | 子商戶未通過審核,無(wú)法修改。 | 請(qǐng)耐心等待,在審核通過后再次提交。 |
INVALID_REQUEST | H5支付權(quán)限申請(qǐng)失敗 | 商戶被處罰,不允許申請(qǐng)開通H5支付權(quán)限。 | 商戶支付權(quán)限被處罰,請(qǐng)先聯(lián)系運(yùn)營(yíng)人員解除。 |
INVALID_REQUEST | H5支付權(quán)限申請(qǐng)失敗 | 提交的H5經(jīng)營(yíng)網(wǎng)址或支付域名存在風(fēng)險(xiǎn),請(qǐng)聯(lián)系對(duì)接BD處理。 | 經(jīng)營(yíng)網(wǎng)址或者H5支付域名命中黑名單,請(qǐng)聯(lián)系運(yùn)營(yíng)人員申請(qǐng)豁免。 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證