適用對象:機(jī)構(gòu)模式
請求URL: https://api.mch.weixin.qq.com/hk/v3/merchants/{sub_mchid}
請求方式: GET
接口規(guī)則: https://wechatpay-api.gitbook.io/wechatpay-api-v3
是否需要證書: 是
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 機(jī)構(gòu)appid | sp_appid | string(32) | 是 | query 機(jī)構(gòu)在微信公眾平臺申請服務(wù)號對應(yīng)的APPID 注意：僅適用于機(jī)構(gòu)模式 示例值：wx8888888888888888 |
| 機(jī)構(gòu)商戶號 | sp_mchid | string(32) | 是 | query 微信支付分配的機(jī)構(gòu)商戶號 注意：僅適用于機(jī)構(gòu)模式 示例值：3200000001 |
| 子商戶號 | sub_mchid | string(32) | 是 | path 子商戶號 示例值：20000100 |
https://api.mch.weixin.qq.com/hk/v3/merchants/{20000100}?sp_appid=wx8888888888888888&sp_mchid=1900000100
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 子商戶號 | sub_mchid | string(32) | 是 | 微信支付分配的子商戶號 示例值：20000100 |
| 子商戶全稱 | name | string(128) | 是 | 子商戶公司注冊的名稱 示例值：Merchant name |
| 子商戶簡稱 | shortname | string(64) | 是 | 子商戶簡稱，用于微信訂單詳情和支付成功頁展示 示例值：Merchant shortname |
| 公司聯(lián)系方式 | office_phone | string(32) | 是 | 商戶聯(lián)系方式，用戶支付完成后展示給用戶的商家聯(lián)系方式 示例值：075586010000 |
| 冊國家或區(qū)域 | merchant_country_code | string(3) | 是 | 子商戶公司注冊的國家或區(qū)域 示例值：344 |
| 類目 | business_category | int | 是 | 參考附錄，詳見商業(yè)類目列表 示例值：101 |
| + 聯(lián)系人信息 | contact | object | 否 | 聯(lián)系人信息，詳見對象說明 |
| 商戶類型 | merchant_type | string(10) | 否 | 取值ENTERPRISE或INDIVIDUAL 示例值：ENTERPRISE |
| 公司注冊文件編號 | registration_certificate_number | string(50) | 否 | 公司注冊文件編號，當(dāng)商戶類型取值為ENTERPRISE時(shí)必填 示例值：5555-8888 |
| 公司注冊文件過期時(shí)間 | registration_certificate_date | string(10) | 否 | 公司注冊文件過期時(shí)間。取值為過期的日期或取值為“PERMANENT” , “N/A”, 若取值為日期，格式為YYYY-MM-DD，比如2020-10-16。當(dāng)商戶類型為ENTERPRISE時(shí)必填。 示例值：2020-10-16 |
| 子商戶結(jié)算賬戶 | settlement_bank_number | string(128) | 否 | 子商戶結(jié)算賬戶信息 示例值：555588889999 |
| + 業(yè)務(wù)信息 | business | object | 否 | 參考對象說明 |
| + 董事信息 | director | object | 否 | 董事信息，參考對象說明 |
| + 負(fù)責(zé)人信息 | principal | object | 否 | 負(fù)責(zé)人信息，當(dāng)商戶類型為INDIVIDUAL必傳，具體請參考principal對象列表 |
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 返回狀態(tài)碼 | code | string(32) | 是 | 錯誤碼，枚舉值見錯誤碼列表 示例值：INVALID_REQUEST |
| 返回信息 | message | string(256) | 是 | 返回信息，如非空，為錯誤原因 示例值：參數(shù)格式校驗(yàn)錯誤 |
| + 詳細(xì)的錯誤描述 | 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",
"email":"test@test.com"
},
"principal":{
"principal_name":"Bob",
"principal_id_number":"5555-8888"
},
}
| 錯誤碼 | 描述 | 解決方案 |
|---|---|---|
| PARAM_ERROR | 請求參數(shù)未按指引進(jìn)行填寫 | 具體參數(shù)格式可以查看文檔 |
| INVALID_REQUEST | 商戶系統(tǒng)異常導(dǎo)致，商戶權(quán)限異常、重復(fù)請求支付、證書錯誤、頻率限制、商戶號不存在、appid和mchid不存在綁定關(guān)系、渠道號不對等 | 請根據(jù)接口返回的詳細(xì)錯誤描述信息檢查您的程序 |
| SYSTEM_ERROR | 后臺系統(tǒng)返回錯誤 | 系統(tǒng)異常，請使用原參數(shù)重新發(fā)起 |
| Mch_NOT_EXISTS | 對應(yīng)的子商戶沒有審批通過 | ?在創(chuàng)建子商戶5分鐘后調(diào)用查詢接口確認(rèn)是否成功，如果報(bào)子商戶不存在，請重新申請 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證