最新更新時間：2020.1.08 版本說明
機構提交子商戶資料，微信支付系統(tǒng)會為每個子商戶創(chuàng)建子商戶號。
● 本接口請求的header需包含Idempotency-Key參數(shù)，它是一個由商戶側生成的唯一key，微信服務器使用該值來識別多次重試是否為同一請求，該字段長度64位，可包含字母和數(shù)字。
適用對象:機構模式
請求URL: https://api.mch.weixin.qq.com/hk/v3/merchants
請求方式: POST
接口規(guī)則: https://wechatpay-api.gitbook.io/wechatpay-api-v3
path 指該參數(shù)需在請求URL傳參
query 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 機構appid | sp_appid | string(32) | 是 | query機構在微信公眾平臺申請服務號對應的APPID 注意：僅適用于機構模式 示例值：wx8888888888888888 |
| 機構商戶號 | sp_mchid | string(32) | 是 | query微信支付分配的機構商戶號 注意：僅適用于機構模式 示例值：3200000001 |
| 子商戶全稱 | name | string(50) | 是 | query子商戶公司注冊的名稱 示例值：Merchant name |
| 子商戶簡稱 | shortname | string(20) | 是 | query子商戶簡稱，用于微信訂單詳情和支付成功頁展示 示例值：Merchant shortname |
| 公司電話 | office_phone | string(20) | 是 | query公司電話，該字段需進行加密處理，加密方法詳見下面說明 示例值：075586010000 |
| + 聯(lián)系人信息 | contact | object | 否 | query聯(lián)系人信息，詳細說明見 |
| 公司簡介 | introduction | string(256) | 是 | query公司簡介，主要說明公司經(jīng)營什么領域產(chǎn)品 特殊規(guī)則：最小長度取值為10。 示例值：主要經(jīng)營酒店餐飲 |
| 公司網(wǎng)站 | website | string(128) | 否 | query公司網(wǎng)站地址 示例值：http://xxx.home.page |
| 類目 | business_category | int | 是 | query參考附錄 示例值：101 |
| 子商戶唯一標識 | business_code | string(20) | 是 | query子商戶在機構下面的唯一標識 示例值：X000001 |
| 渠道號 | channel_id | string(32) | 否 | query機構在微信商戶管理后臺創(chuàng)建的渠道號，如有渠道號請?zhí)顚? 示例值：3200000001 |
敏感字段加密說明：
對于包含了敏感信息的參數(shù)，如聯(lián)系方式等，我們增加了“字段加密”的安全機制，保護敏感信息只能被數(shù)據(jù)的接收方看到。
加密步驟：
1、獲取微信支付平臺證書和對應的平臺證書序列號，詳細方法參考5.7下載平臺證書。 本接口請求http頭的“Wechatpay-Serial”需要傳平臺證書序列號。
2、使用微信支付平臺證書的公鑰，對于需要加密的參數(shù)值進行RSA加密。填充方案使用`RSAES-PKCS1-v1_5`。
3、加密后的密文，使用base64編碼后，作為請求中相應參數(shù)的值。
{
"sp_appid": "wx8888888888888888",
"sub_mchid": "3200000001",
"name": "Merchant name",
"shortname": "Merchant shortname",
"office_phone": "075586010000",
"contact": {
"name": "李先生",
"phone": "075586010000",
"email": "test@test.com"
}
"introduction": "主要經(jīng)營酒店餐飲",
"website": "http://xxx.home.page",
"business_category": 101,
"business_code": "X000001",
"channel_id": "3200000001"
}
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 子商戶號 | sub_mchid | string(32) | 是 | 微信支付分配的子商戶號 注意：僅適用于機構模式 示例值：1900000109 |
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 返回狀態(tài)碼 | code | string(32) | 是 | 錯誤碼，枚舉值見錯誤碼列表 示例值：INVALID_REQUEST |
| 返回信息 | message | string(256) | 是 | 返回信息，如非空，為錯誤原因 示例值：參數(shù)格式校驗錯誤 |
| + 詳細的錯誤描述 | detail | object | 否 | 當code為PARAM_ERROR時返回，詳細說明見下 |
| 錯誤碼 | 描述 | 解決方案 |
|---|---|---|
| PARAM_ERROR | 請求參數(shù)未按指引進行填寫 | 具體參數(shù)格式可以查看文檔 |
| SYSTEM_ERROR | 后臺系統(tǒng)返回錯誤 | 系統(tǒng)異常，請使用原參數(shù)重新發(fā)起 |
| INVALID_REQUEST | 商戶系統(tǒng)異常導致，商戶權限異常、重復請求支付、證書錯誤、頻率限制、商戶號不存在、appid和mchid不存在綁定關系、渠道號不對等 | 請根據(jù)接口返回的詳細錯誤描述信息檢查您的程序，具體可以查詢detail 字段返回的詳細信息 |
| INVALID_REQUEST | 沒有api創(chuàng)建子商戶的權限 | ?請登錄商戶管理后臺人工錄入子商戶信息 |
| INVALID_REQUEST | 商戶唯一標識已經(jīng)存在，請更換 | 針對不同的子商戶，請定義唯一的標識 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證