適用對(duì)象:機(jī)構(gòu)模式
請(qǐng)求URL: https://api.mch.weixin.qq.com/hk/v3/merchants/{sub_mchid}
請(qǐng)求方式: GET
接口規(guī)則: https://wechatpay-api.gitbook.io/wechatpay-api-v3
path 指該參數(shù)需在請(qǐng)求URL傳參
query 指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
機(jī)構(gòu)appid | sp_appid | string(32) | 是 | path 機(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(32) | 是 | path 微信支付分配的機(jī)構(gòu)商戶號(hào) 注意:僅適用于機(jī)構(gòu)模式 示例值:3200000001 |
子商戶號(hào) | sub_mchid | string(32) | 是 | path 子商戶號(hào) 示例值:20000100 |
https://api.mch.weixin.qq.com/hk/v3/merchants/{20000100}?sp_appid=wx8888888888888888&sp_mchid=1900000100
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
子商戶全稱 | name | string(50) | 是 | 子商戶公司注冊(cè)的名稱 示例值:Merchant name |
子商戶簡稱 | shortname | string(20) | 是 | 子商戶簡稱,用于微信訂單詳情和支付成功頁展示 示例值:Merchant shortname |
公司聯(lián)系方式 | office_phone | string(20) | 是 | 商戶聯(lián)系方式,用戶支付完成后展示給用戶的商家聯(lián)系方式 示例值:075586010000 |
公司簡介 | introduction | string(256) | 是 | 商戶簡介,主要經(jīng)營什么領(lǐng)域產(chǎn)品 特殊規(guī)則:最小長度取值為10。 示例值:主要經(jīng)營酒店餐飲 |
公司網(wǎng)站 | website | string(128) | 否 | 公司網(wǎng)站 示例值:http://xxx.home.page |
類目 | business_category | int | 是 | 參考附錄 示例值:101 |
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
返回狀態(tài)碼 | code | string(32) | 是 | 錯(cuò)誤碼,枚舉值見錯(cuò)誤碼列表 示例值:INVALID_REQUEST |
返回信息 | message | string(256) | 是 | 返回信息,如非空,為錯(cuò)誤原因 示例值:參數(shù)格式校驗(yàn)錯(cuò)誤 |
+ 詳細(xì)的錯(cuò)誤描述 | detail | object | 否 | 當(dāng)code為PARAM_ERROR時(shí)返回,詳細(xì)說明見下 |
錯(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ā)起 |
Mch_NOT_EXISTS | 對(duì)應(yīng)的子商戶沒有審批通過 | ?在創(chuàng)建子商戶5分鐘后調(diào)用查詢接口確認(rèn)是否成功,如果報(bào)子商戶不存在,請(qǐng)重新申請(qǐng) |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證