微信支付-子商戶進(jìn)件開發(fā)者文檔

返回上一層子商戶進(jìn)件 / 查詢子商戶API

查詢子商戶

最新更新時間：2024.03.27 版本說明

用于機構(gòu)查詢子商戶創(chuàng)建是否成功，接口只提供單個子商戶信息查詢。

接口說明

適用對象:機構(gòu)模式

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

請求方式: POST

是否需要證書: 是

請求參數(shù)

參數(shù)名	變量	類型	必填	描述
機構(gòu)appid	app_id	string(32)	是	機構(gòu)在微信公眾平臺申請服務(wù)號對應(yīng)的APPID 示例值：wx8888888888888888
機構(gòu)商戶號	mch_id	string(32)	是	微信支付分配的機構(gòu)商戶號示例值：3200000001
子商戶號	sub_mch_id	string(32)	是	子商戶號示例值：20000100
簽名	sign	string(32)	是	參數(shù)簽名，詳見簽名方法示例值：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>

返回參數(shù)

正常返回

字段名	變量	類型	必填	描述
返回狀態(tài)碼	return_code	string(16)	是	SUCCESS/FAIL 此字段是通信標(biāo)識，非交易標(biāo)識，交易是否成功需要查看result_code來判斷示例值：SUCCESS
返回信息	return_msg	string(128)	否	返回信息，如非空，為錯誤原因簽名失敗參數(shù)格式校驗錯誤示例值：簽名失敗

當(dāng)return_code為SUCCESS的時候，會包括以下字段：

參數(shù)名	變量	類型	必填	描述
業(yè)務(wù)返回碼	result_code	string(16)	是	業(yè)務(wù)結(jié)果 SUCCESS/FAIL 示例值：SUCCESS
錯誤編碼	err_code	string(32)	否	詳細(xì)參見錯誤列表示例值：SYSTEMERROR
錯誤描述	err_code_des	string(128)	否	錯誤信息描述示例值：系統(tǒng)錯誤
簽名	sign	string(32)	是	簽名信息示例值：C380BEC2BFD727A4B6845133519F3AD6
子商戶號	sub_mch_id	string(32)	是	微信支付系統(tǒng)生成的子商戶號示例值：1234567
子商戶名稱	merchant_name	string(128)	是	子商戶公司注冊的名稱示例值：7-11
子商戶簡稱	merchant_shortname	string(64)	是	子商戶簡稱，用于微信訂單詳情和支付成功頁展示示例值：Merchant shortname
注冊國家或區(qū)域	merchant_country_code	string(3)	否	公司所注冊的國家或區(qū)域，詳見國家/地區(qū)代碼示例值：344
業(yè)務(wù)類目	business_category	string(10)	是	業(yè)務(wù)類目，詳見業(yè)務(wù)類目列表示例值：101
MCC	mcc	string(4)	否	Mcc碼，請參考商戶行業(yè)編碼示例值：075586010000
公司聯(lián)系電話	office_phone	string(32)	是	商戶聯(lián)系方式，用戶支付完成后展示給用戶的商家聯(lián)系方式示例值：075586010000
聯(lián)系人姓名	contact_name	string(64)	否	聯(lián)系人姓名示例值：張三
聯(lián)系人手機	contact_phone	string(32)	否	聯(lián)系人手機示例值：1800000000
聯(lián)系人郵箱	contact_email	string(256)	否	聯(lián)系人郵箱示例值：test@test.com
子商戶唯一標(biāo)識	merchant_remark	string(20)	是	機構(gòu)為商戶備注的信息，可以是商戶在機構(gòu)系統(tǒng)的商戶編號示例值：ABC1234567
業(yè)務(wù)類型	business_type	string(7)	否	取值為三種業(yè)務(wù)類型：ONLINE, OFFLINE 或BOTH 示例值：BOTH
商戶類型	merchant_type	string(10)	否	取值ENTERPRISE或INDIVIDUAL 示例值：ENTERPRISE
公司注冊文件編號	registration_certificate_number	string(50)	否	公司注冊文件編號，當(dāng)商戶類型取值為ENTERPRISE時必填示例值：5555-8888
公司注冊文件過期時間	registration_certificate_date	string(10)	否	公司注冊文件過期時間。取值為過期的日期或取值為“PERMANENT” , “N/A”, 若取值為日期，格式為YYYY-MM-DD，比如：2020-10-16。當(dāng)商戶類型為ENTERPRISE時必填。示例值：2020-10-16
APP下載鏈接	app_download	string(128)	否	商戶APP的下載地址示例值：https://download.qq.com
業(yè)務(wù)網(wǎng)站	business_website	string(128)	否	商戶的業(yè)務(wù)網(wǎng)站地址示例值：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
負(fù)責(zé)人姓名	principal_name	string(128)	否	負(fù)責(zé)人姓名示例值：Bob Zhang
負(fù)責(zé)人證件編號	principal_id_number	string(128)	否	負(fù)責(zé)人證件編號示例值：5555-8888
子商戶結(jié)算銀行賬戶	settlement_bank_number	string(128)	否	子商戶結(jié)算銀行賬戶信息示例值：555588889999
渠道編號	channel_id	string(20)	否	機構(gòu)合作渠道的編號，通過商戶平臺創(chuàng)建示例值：101
H5支付權(quán)限狀態(tài)	h5_authorization_state	string(32)	否	描述子商戶的H5支付權(quán)限狀態(tài)： APPROVED：已有H5權(quán)限； UNAUTHORIZED：未獲得H5權(quán)限，也未申請過H5權(quán)限； UNDER_REVIEW：H5權(quán)限申請當(dāng)前在審核中； REJECTED：H5權(quán)限申請被駁回，請于h5_audit_reject_detail字段查看駁回原因； UNDER_PUNISHMENT：曾經(jīng)申請并獲得H5權(quán)限，但當(dāng)前權(quán)限被處罰，請聯(lián)系BD處理； APPLICATION_FAILED：H5權(quán)限申請單創(chuàng)建失敗，請于h5_audit_reject_detail字段查看失敗原因示例值：APPROVED
H5駁回詳情	h5_audit_reject_detail	string(1024)	否	H5支付權(quán)限狀態(tài)為REJECTED或APPLICATION_FAILED時返回；申請單被駁回的原因或申請失敗原因。示例值：商戶證書無效
子商戶狀態(tài)	sub_mch_status	string(32)	是	子商戶狀態(tài)，表示當(dāng)前該子商戶在微信支付系統(tǒng)內(nèi)的狀態(tài)： OPERATING：正常；子商戶權(quán)限正常，可發(fā)起交易； PENDING：待處理；子商戶資料未通過日常審核，需要機構(gòu)登錄微信支付商戶平臺查看和處理。子商戶權(quán)限正常，可發(fā)起交易； DEACTIVATED：已停用；該子商戶被機構(gòu)自主停用，無支付權(quán)限，不能發(fā)起交易； CLOSED：已關(guān)閉；該子商戶被微信支付關(guān)閉支付權(quán)限，不能發(fā)起交易； INCOMPLETE_APPLICATION：未完成入駐；子商戶入駐申請未完成，無支付權(quán)限，不能發(fā)起交易。請于application_status字段查看入駐申請狀態(tài) 示例值：OPERATING
子商戶入駐狀態(tài)	application_status	string(32)	否	子商戶狀態(tài)為 INCOMPLETE_APPLICATION時返回；子商戶入駐申請狀態(tài)： UNDER_REVIEW：審核中；微信支付正在審核該子商戶的入駐申請，請耐心等待；建議每隔一天查詢一次子商戶狀態(tài)，直至子商戶流轉(zhuǎn)到其他狀態(tài)； REJECTED：已駁回；該子商戶的入駐申請被微信支付駁回，請于application_rejected_detail字段查看駁回原因示例值：UNDER_REVIEW
子商戶入駐駁回詳情	application_reject_detail	string(4096)	否	子商戶入駐狀態(tài)為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 方式，檢查后重新嘗試。	請開發(fā)人員請求數(shù)據(jù)
INVALID_REQUEST	請求異常	XML格式異常，請檢查格式，重新嘗試
SIGNERROR	簽名錯誤	簽名校驗失敗，請檢查簽名數(shù)據(jù)，重新嘗試。
INVALID_REQUEST	請求錯誤	請使用字符集UTF-8.
PARAM_ERROR	參數(shù)錯誤	參數(shù)錯誤，請檢查重新嘗試。例如：參數(shù)超過限定長度。	請檢查參數(shù)
PARAM_ERROR	參數(shù)錯誤	參數(shù)錯誤，請檢查重新嘗試。例如：參數(shù)格式錯誤。	請檢查參數(shù)
INVALID_REQUEST	請求錯誤	沒有進(jìn)件子商戶的權(quán)限。	請檢查權(quán)限
INVALID_REQUEST	請求錯誤	檢索客戶端證書序列號失敗&\160；來自客戶端證書的可分辨名稱（DN）字段失敗&\160；證書驗證失敗。沒有攜帶證書。請檢查后重新嘗試。	請檢查證書
INVALID_REQUEST	請求錯誤	商戶信息校驗時發(fā)生系統(tǒng)錯誤。輸入字段包含不適當(dāng)?shù)男g(shù)語。檢查并再次輸入。輸入字段包含不符合服務(wù)規(guī)則的不適當(dāng)術(shù)語。檢查并再次輸入。由于違規(guī)，權(quán)限被限制。有關(guān)詳細(xì)信息，請聯(lián)系客戶服務(wù)。	請檢查輸入信息或聯(lián)系微信支付
SYSTEMERROR	系統(tǒng)錯誤	系統(tǒng)錯誤	請聯(lián)系微信支付技術(shù)支持

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

子商戶進(jìn)件API

查詢子商戶

接口說明

請求參數(shù)

請求示例：

返回參數(shù)

正常返回

返回示例：

錯誤碼

版本說明