查詢子商戶API
最新更新時(shí)間：2024.03.27 版本說明
用于機(jī)構(gòu)查詢子商戶創(chuàng)建是否成功，接口只提供單個(gè)子商戶信息查詢。
1. 接口說明
適用對(duì)象:機(jī)構(gòu)模式
請(qǐng)求URL: https://apihk.mch.weixin.qq.com/v3/global/merchants/{sub_mchid}
請(qǐng)求方式: GET
Path指該參數(shù)為路徑參數(shù)
Query指該參數(shù)為URL參數(shù)
Body指該參數(shù)需在請(qǐng)求JSON傳參
2. 請(qǐng)求參數(shù)
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 機(jī)構(gòu)appid | sp_appid | string[1,32] | 是 | Query機(jī)構(gòu)在微信公眾平臺(tái)申請(qǐng)服務(wù)號(hào)對(duì)應(yīng)的APPID 注意：僅適用于機(jī)構(gòu)模式 示例值：wx8888888888888888 |
| 機(jī)構(gòu)商戶號(hào) | sp_mchid | string[1,32] | 是 | Query微信支付分配的機(jī)構(gòu)商戶號(hào) 注意：僅適用于機(jī)構(gòu)模式 示例值：3200000001 |
| 子商戶號(hào) | sub_mchid | string[1,32] | 是 | Path子商戶號(hào) 示例值：20000100 |
請(qǐng)求示例
https://apihk.mch.weixin.qq.com/v3/global/merchants/{20000100}?sp_appid=wx8888888888888888&sp_mchid=1900000100
3. 返回參數(shù)
正常返回
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 子商戶號(hào) | sub_mchid | string(32) | 是 | 微信支付分配的子商戶號(hào) 示例值：20000100 |
| 子商戶全稱 | name | string(128) | 是 | 子商戶公司注冊(cè)的名稱 示例值：Merchant name |
| 子商戶簡(jiǎn)稱 | shortname | string(64) | 是 | 子商戶簡(jiǎn)稱，用于微信訂單詳情和支付成功頁展示 示例值：Merchant shortname |
| 公司聯(lián)系方式 | office_phone | string(32) | 是 | 商戶聯(lián)系方式，用戶支付完成后展示給用戶的商家聯(lián)系方式 示例值：075586010000 |
| 注冊(cè)國(guó)家或區(qū)域 | merchant_country_code | string(3) | 是 | 子商戶公司注冊(cè)的國(guó)家或區(qū)域 示例值：344 |
| 類目 | business_category | int | 是 | 參考附錄，詳見商業(yè)類目列表 示例值：101 |
| 聯(lián)系人信息 | contact | object | 是 | 聯(lián)系人信息，詳細(xì)說明見 |
| 商戶類型 | merchant_type | string[1,10] | 是 | 取值ENTERPRISE或INDIVIDUAL 若商戶為自然人或獨(dú)資經(jīng)營(yíng)者，請(qǐng)選擇INDIVIDUAL。 示例值：ENTERPRISE |
| 公司注冊(cè)文件編號(hào) | registration_certificate_number | string[1,50] | 是 | 公司注冊(cè)文件編號(hào)。 若商戶為自然人，請(qǐng)?zhí)峁┒禄蜇?fù)責(zé)人的ID號(hào)。 若商戶為獨(dú)資經(jīng)營(yíng)者，請(qǐng)?zhí)峁┆?dú)資經(jīng)營(yíng)的業(yè)務(wù)資質(zhì)證書編號(hào)。 示例值：5555-8888 |
| 公司注冊(cè)文件過期時(shí)間 | registration_certificate_date | string[1,10] | 是 | 公司注冊(cè)文件過期時(shí)間。 取值為過期的日期或取值為“PERMANENT”，“N/A”, 若取值為日期，格式為YYYY-MM-DD，比如2020-10-16。 若商戶為自然人，請(qǐng)?zhí)峁┒禄蜇?fù)責(zé)人的ID號(hào)過期日期。 若商戶為獨(dú)資經(jīng)營(yíng)者，請(qǐng)?zhí)峁┆?dú)資經(jīng)營(yíng)的業(yè)務(wù)資質(zhì)證書編號(hào)過期日期。 示例值：2020-10-16 |
| 子商戶銀行結(jié)算賬戶信息 | settlement_bank_number | string[1,128] | 否 | 子商戶的結(jié)算銀行賬戶信息 示例值：555588889999 |
| 業(yè)務(wù)信息 | business | object | 是 | 業(yè)務(wù)信息，具體請(qǐng)參考business對(duì)象列表 |
| 董事信息 | director | object | 是/否 | 董事信息，當(dāng)商戶類型為ENTERPRISE必傳，具體請(qǐng)參考director對(duì)象列表 |
| 負(fù)責(zé)人信息 | principal | object | 是/否 | 負(fù)責(zé)人信息，當(dāng)商戶類型為INDIVIDUAL必傳，具體請(qǐng)參考principal對(duì)象列表 |
| H5支付權(quán)限詳情 | h5_payment | object | 否 | BodyH5支付權(quán)限詳情 |
| 子商戶狀態(tài)信息 | sub_merchant_state | object | 否 | Body子商戶狀態(tài)信息 |
異常返回
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 返回狀態(tài)碼 | code | string[1, 32] | 是 | 錯(cuò)誤碼，枚舉值見錯(cuò)誤碼列表 示例值：INVALID_REQUEST |
| 返回信息 | message | string[1, 256] | 是 | 返回信息，如非空，為錯(cuò)誤原因 示例值：參數(shù)格式校驗(yàn)錯(cuò)誤 |
| 詳細(xì)的錯(cuò)誤描述 | detail | object | 否 | 當(dāng)code為PARAM_ERROR時(shí)返回，詳細(xì)說明見下 |
返回示例
{
"sub_mchid": "20000100",
"name": "test mcherchan_name",
"shortname": "mcherchan_name",
"office_phone": "075586010000",
"merchant_introduction": "hotel and restaurant",
"business_category": 644,
"contact": {
"name": "Bob Zhang",
"phone": "+8613633334444"
},
"principal": {
"principal_name": "Bob",
"principal_id_number": "5555-8888"
},
"h5_payment": {
"h5_authorization_state": "APPROVED"
},
"sub_merchant_state": {
"sub_merchant_status": "OPERATING"
}
}4. 錯(cuò)誤碼
| 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|
| PARAM_ERROR | 請(qǐng)求參數(shù)未按指引進(jìn)行填寫 | 具體參數(shù)格式可以查看文檔 |
| INVALID_REQUEST | 商戶系統(tǒng)異常導(dǎo)致，商戶權(quán)限異常、重復(fù)請(qǐng)求支付、證書錯(cuò)誤、頻率限制、商戶號(hào)不存在、appid和mchid不存在綁定關(guān)系、渠道號(hào)不對(duì)等 | 請(qǐng)根據(jù)接口返回的詳細(xì)錯(cuò)誤描述信息檢查您的程序 |
| SYSTEM_ERROR | 后臺(tái)系統(tǒng)返回錯(cuò)誤 | 系統(tǒng)異常，請(qǐng)使用原參數(shù)重新發(fā)起 |
頁面導(dǎo)航
