商家券接入前準備
1.選擇接入模式
商戶/服務商在接入前首先要判斷自己公司注冊區(qū)域適用的接入模式，微信支付目前提供兩種接入方式：直連模式和服務商模式。
● 直連模式：
信息、資金流：微信支付—>直連商戶
直連模式，商戶自行申請入駐微信支付，無需服務商協(xié)助。（商戶平臺申請）成為直連商戶
直連模式相關說明詳見：直連模式介紹
● 服務商模式：
—— 信息流 —— 資金流
服務商模式，商戶申請成為微信支付服務商，服務商自身無法作為一個直連商戶直接發(fā)起交易，其發(fā)起交易必須傳入相關特約商戶商戶號的參數(shù)信息。（服務商平臺申請）成為服務商
請結(jié)合自身實際情況來選擇接入模式。
2.參數(shù)申請
-
1申請APPID
由于微信支付的產(chǎn)品體系全部搭載于微信的社交體系之上，所以直連商戶或服務商接入微信支付之前，都需要有一個微信社交載體，該載體對應的ID即為APPID。
目前服務商的社交載體只能是公眾號，服務商可通過公眾平臺完成公眾號注冊申請。
公眾號申請成功后，服務商可登錄公眾號平臺即可獲取對應的APPID，具體查閱目錄為 【開發(fā)-> 基本配置-> 公眾號開發(fā)信息】，如下圖所示。通常情況下，一個服務商只需申請一個公眾號即可。
-
2申請mchid
服務商的收款賬號即是mchid，申請mchid和APPID的操作互不影響，可以并行操作，申請地址如下： 商戶號申請指引
mchid申請成功后，微信支付將下發(fā)通知郵件至機構(gòu)填寫的聯(lián)系郵箱，內(nèi)容包含申請成功的mchid及其登錄賬號密碼，請妥善保存。
注意：一個mchid只能對應一個結(jié)算幣種，若需要使用多個幣種收款，需要申請對應數(shù)量的mchid。
-
3綁定APPID及mchid
APPID和mchid全部申請完畢后，需要建立兩者之間的綁定關系。
服務商可登錄服務商平臺，【產(chǎn)品中心-> AppID管理】目錄下即可完成綁定。
服務商模式下，一個APPID下可綁定多個mchid，一個mchid可綁定3個APPID。
-
4入駐子商戶
上述步驟操作完成后，即會向服務商開放入駐子商戶權(quán)限。
服務商可登錄服務商平臺進入【服務商功能】界面完成子商戶入駐。
-
完成
3.配置API key
API v3密鑰主要用于平臺證書解密、回調(diào)信息解密，具體使用方式可參見接口規(guī)則文檔中證書和回調(diào)報文解密章節(jié)。
請根據(jù)以下步驟配置API key：
-
1登錄微信服務商平臺，進入【賬戶中心 > API安全】目錄，設置APIV3密鑰。
-
2在彈出窗口中點擊【已溝通】。
-
3輸入API密鑰，內(nèi)容為32位字符，包括數(shù)字及大小寫字母。點擊獲取短信驗證碼。
-
4輸入短信驗證碼，點擊【確認】即設置成功。
-
完成
4.下載并配置商戶證書
商戶API證書具體使用說明可參見接口規(guī)則文檔中私鑰和證書章節(jié)
服務商可登錄微信服務商平臺，在【賬戶中心 -> API安全】目錄下載證書
以下為具體下載步驟：
-
1從2018年底開始，微信支付新入駐機構(gòu)及商戶都將使用CA簽發(fā)證書，在證書申請頁面上點擊“申請證書”。
-
2在彈出窗口中點擊“確定”。
-
3在彈出窗口內(nèi)點擊“下載證書工具”按鈕下載證書工具。
-
4安裝證書工具并打開，選擇證書需要存儲的路徑后點擊“申請證書”。
-
5在證書工具中，將復制的商戶信息粘貼并點擊“下一步”。
-
6獲取請求串
-
7生成證書串
步驟1 在【商戶平臺】-“復制證書串”環(huán)節(jié)，點擊“復制證書串”按鈕后；
步驟2 在【證書工具】-“復制請求串”環(huán)節(jié)，點擊“下一步”按鈕進入“粘貼證書串”環(huán)節(jié)；
步驟3 在【證書工具】-“粘貼證書串”環(huán)節(jié)，點擊“粘貼”按鈕后；
步驟4 點擊“下一步”按鈕，進入【證書工具】-“生成證書”環(huán)節(jié)
-
8在【證書工具】-“生成證書”環(huán)節(jié)，已完成申請證書流程，點擊“查看證書文件夾”，查看已生成的證書文件。
-
完成
5. 操作指引
5.1. 創(chuàng)建商家券
可通過調(diào)用“創(chuàng)建商家券”接口創(chuàng)建商家券，當前支持創(chuàng)建的商家券類型包含滿減券、換購券和折扣券三種。
5.2. 發(fā)放商家券
當前支持在商家小程序、H5、支付有禮、掃碼領券、小程序直播、搜一搜中派發(fā)商家券，具體操作流程和文檔請參見：微信支付券。
說明：商家的小程序需要先申請開通該發(fā)券插件的權(quán)限后，才可進行開發(fā)。申請審核1個工作日完成。
5.3. 核銷商家券
可通過調(diào)用“核銷用戶券”接口核銷用戶券。
5.4. 管理商家券
可通過調(diào)用“查詢商家券批次信息”、“根據(jù)過濾條件查詢用戶券”、“查詢用戶券詳情”接口管理商家券。
6. APPID與商戶號（MCHID）綁定關系解釋
6.1. 什么是綁定關系
對于服務商，想通過微信去觸達用戶、服務用戶，則需要以小程序、公眾號等形態(tài)去實現(xiàn)，這時服務商需要在公眾平臺或開放平臺注冊賬號，每一個賬號背后都對應一個開發(fā)者ID（APPID）。
出于安全隱私的角度，在服務商連接用戶時，微信不會直接把用戶的微信號（WechatId）予以暴露，而是通過OPENID去實現(xiàn)觸達，實現(xiàn)服務。同一個微信用戶，在不同APPID下，openid不一樣。簡單理解：WechatID+APPID=OPENID。
同樣，對于服務商想要使用微信支付提供的服務，比如支付體系接入，營銷優(yōu)惠券體系接入，都需要在微信支付側(cè)開立賬號，即開通商戶號（MCHID）。商戶號記錄交易資金往來，提供各種支付、營銷能力。
微信支付是在微信生態(tài)上的產(chǎn)品服務能力。所以涉及到與用戶的交互操作，比如公眾號支付的JSAPI下單，優(yōu)惠券發(fā)放等都需要公眾平臺APPID與商戶號MCHID打通交互。是否能做這樣的業(yè)務打通交互，即驗證APPID與MCHID之間是否有綁定關系。
6.2. 綁定模式
以本商戶號為視角，有以下綁定關系：
| 業(yè)務模式 | 商戶角色 | MCHID與APPID綁定關系模式 |
|---|---|---|
| 直連模式 | 直連商戶 | 模式1：MCHID（直連商戶）- APPID |
| 普通服務商 | 模式2：MCHID（普通服務商）- APPID | |
| 特約商戶 （直連角色） |
模式1：MCHID（特約商戶）- APPID | |
| 特約商戶 （普通服務商下特約商戶角色） | 模式3：MCHID（普通服務商）- mchid（特約商戶）-SubAPPID | |
| 間聯(lián)模式 | 收單機構(gòu) | 模式4：MCHID（收單機構(gòu)）- APPID |
| 渠道商 | 模式5：MCHID（渠道商）- APPID | |
| 特約商戶 | 模式6：MCHID（收單機構(gòu)）- mchid（特約商戶）-SubAPPID |
6.3. 如何綁定
6.3.1. MCHID-APPID
該模式更多適用于直連商戶、普通服務商、渠道商操作本商戶號與APPID的綁定關系。
已綁定APPID信息查看與新增綁定關系：（適用于普通直連商戶【模式1】、普通服務商特約商戶【模式1】、普通服務商【模式2】、渠道商【模式5】）
登錄微信服務商平臺> 產(chǎn)品中心 > APPID賬號管理 > 我關聯(lián)的APPID賬號
綁定操作指引：點擊查看
注意：Westore商戶接入微信支付，其申請得到商戶號123，Westore有自己的小程序APPID為ABC。完成對應操作，即可創(chuàng)建123（MCHID）---ABC（APPID）的綁定關系。
6.3.2.MCHID-mchid-SubAPPID
該模式更多適用于普通模式下特約商戶模式、間聯(lián)模式下特約商戶操作商戶號與APPID的綁定關系。
服務商管理特約商戶已綁定SubAPPID和新增綁定關系：（適用于普通服務商【模式3】、渠道商【模式6】）
登錄微信服務商平臺 > 服務商功能 > 特約商戶管理 > 開發(fā)配置 > 特約商戶APPID配置
特約商戶查看服務商為其配置的SubAPPID：（適用于普通服務商特約商戶【模式3】）
登錄微信服務商平臺 > 產(chǎn)品中心 > APPID賬號管理 > 服務商為我關聯(lián)的APPID賬號
綁定操作指引：點擊查看
注意：Westore商戶由服務商XXX（商戶號456）接入微信支付，其申請得到商戶號123，Westore有自己的小程序APPID為ABC。完成對應操作，即可創(chuàng)建456（服務商MCHID）---123（特約商戶MCHID）---ABC（SubAPPID）的綁定關系。
7. 商家券業(yè)務中APPID配置使用規(guī)則
7.1.創(chuàng)建商家券
商家券創(chuàng)建API接口文檔：點擊查看
調(diào)用該API接口的商戶號，即V3接口頭部參數(shù)簽名中的商戶號，即為商家券批次的創(chuàng)建商戶號。整個接口調(diào)用中：
1) 涉及的商戶號有
批次創(chuàng)建商戶號（接口簽名商戶號）、批次歸屬商戶號（belong_merchant）；
2） 涉及的APPID有
立即使用跳轉(zhuǎn)小程序（以下統(tǒng)稱：use_method_appid）、自定義入口小程序以及公眾號（以下統(tǒng)稱：custom_entrance_appid）、事件通知APPID（以下統(tǒng)稱：notify_config_appid）；
7.1.1. 直連商戶模式
該模式適用于商戶自己給自己制券。
1）商戶號校驗：
創(chuàng)建商戶號與歸屬商戶號是同一個商戶號，即批次創(chuàng)建商戶號 = 批次歸屬商戶號；
2）APPID校驗：
模式1，即MCHID（直連商戶，歸屬商戶號）--- APPID；
7.1.2. 普通服務商模式
1）商戶號校驗：
批次創(chuàng)建商戶號 = 普通服務商；批次歸屬商戶號 = 特約商戶商戶號；校驗創(chuàng)建商戶號與歸屬商戶號之間是否有服務商與特約商戶的父子受理關系；
2）APPID校驗：（APPID滿足以下任一模式均可）
模式1，即MCHID（特約商戶，歸屬商戶號）--- APPID；
模式2，即MCHID（普通服務商，創(chuàng)建商戶號）--- APPID；
模式3，即MCHID（普通服務商，創(chuàng)建商戶號）--- mchid（特約商戶，歸屬商戶號）---SubAPPID；
7.1.3. 間聯(lián)渠道商模式
該模式適用于渠道商給特約商戶制券。
1）商戶號校驗：
批次創(chuàng)建商戶號 = 渠道商；批次歸屬商戶號 = 特約商戶商戶號；校驗創(chuàng)建商戶號與歸屬商戶號之間是否有渠道商與特約商戶的渠道拓展關系；
2）APPID校驗：（APPID滿足以下任一模式均可）
模式5，即MCHID（渠道商，創(chuàng)建商戶號）--- APPID；
模式6，即MCHID（收單機構(gòu)）--- mchid（特約商戶，歸屬商戶號）---SubAPPID；
7.2. 發(fā)放商家券（小程序發(fā)券&H5發(fā)券）
商家券小程序發(fā)券接口文檔：點擊查看
商家券H5發(fā)券接口文檔：點擊查看
1） 涉及的商戶號有：
調(diào)用該API接口的商戶號，即為商家券批次的發(fā)放商戶號。
2） 涉及的APPID有：
接入小程序插件的小程序APPID，或H5發(fā)券接口中傳入的OPENID背后的APPID，以下統(tǒng)稱為發(fā)券場景APPID。
7.2.1. 直連商戶模式
該模式適用于商戶自己制券自己發(fā)券。
1）商戶號校驗：
即誰制券誰調(diào)用接口發(fā)券，該模式會校驗制券商戶號是否未發(fā)放批次的創(chuàng)建商戶號，即發(fā)券商戶號 = 批次創(chuàng)建商戶號；
2）APPID校驗：
模式1，即MCHID（直連商戶，批次歸屬商戶號=批次發(fā)放商戶號）--- APPID（發(fā)券場景APPID）；
7.2.2. 普通服務商模式
該模式適用于普通服務商給特約商戶，并給特約商戶發(fā)券。
1）商戶號校驗：
批次發(fā)放商戶號 = 批次創(chuàng)建商戶號 = 普通服務商；
2）APPID校驗：（APPID滿足以下任一模式均可）
模式1，即MCHID（特約商戶，歸屬商戶號）--- APPID（發(fā)券場景APPPID）；
模式2，即MCHID（普通服務商，創(chuàng)建商戶號=發(fā)放商戶號）--- APPID（發(fā)券場景APPID）；
模式3，即MCHID（普通服務商，創(chuàng)建商戶號=發(fā)放商戶號）--- mchid（特約商戶，歸屬商戶號）---SubAPPID（發(fā)券場景APPID）；
7.2.3. 間聯(lián)渠道商模式
該模式適用于渠道商給特約商戶，并給特約商戶發(fā)券。
1）商戶號校驗：
批次發(fā)放商戶號 = 批次創(chuàng)建商戶號 = 渠道商；
2）APPID校驗：（APPID滿足以下任一模式均可）
模式5，即MCHID（渠道商，創(chuàng)建商戶號=發(fā)放商戶號）--- APPID（發(fā)券場景APPPID）；
模式6，即MCHID（收單機構(gòu)）--- mchid（特約商戶，歸屬商戶號）---SubAPPID（發(fā)券場景APPID）；
7.3. 查詢用戶卡包里商家券
根據(jù)過濾條件查詢用戶券API接口文檔：點擊查看
查詢用戶單張券API接口文檔：點擊查看
1) 涉及的商戶號有：
調(diào)用該API接口的商戶號，即為商家券批次的發(fā)放查詢商戶號（以下統(tǒng)稱為批次查詢商戶號）。接口內(nèi)部還涉及批次的創(chuàng)建商戶號（creator_merchant）、批次發(fā)放商戶號（sender_merchant）、批次歸屬商戶號（belong_merchant）；
2) 涉及的APPID有：
因為查用戶卡包的券信息，涉及用戶信息的交互，就需要用戶OPENID，因此需要傳入用戶身份識別APPID（以下統(tǒng)稱為用戶識別APPID），有如下校驗規(guī)則：
7.3.1. 直連商戶模式
該模式適用于商戶自己查詢自己發(fā)的券 or 自己創(chuàng)建的券 or 歸屬于自己的券。
1）商戶號校驗
批次查詢商戶號 = 批次創(chuàng)建商戶號 = 批次歸屬商戶號 = 批次發(fā)放商戶號；
2）APPID校驗
模式1，即MCHID（直連商戶，批次發(fā)放商戶號=批次創(chuàng)建商戶號=批次歸屬商戶號=批次查詢商戶號）--- APPID（用戶識別APPID）；
7.3.2. 普通服務商模式
該模式適用于普通服務商給特約商戶制券發(fā)券，并查券的場景。
1）商戶號校驗：
批次查詢商戶號= 批次發(fā)放商戶號 = 批次創(chuàng)建商戶號 = 普通服務商；
批次歸屬商戶號 = 特約商戶號；
2）APPID校驗：（APPID滿足以下任一模式均可）
模式1，即MCHID（特約商戶，歸屬商戶號）--- APPID（用戶識別APPID）；
模式2，即MCHID（普通服務商，查詢商戶號=創(chuàng)建商戶號=發(fā)放商戶號）--- APPID（用戶識別APPID）；
模式3，即MCHID（普通服務商，查詢商戶號=創(chuàng)建商戶號=發(fā)放商戶號）--- mchid（特約商戶，歸屬商戶號）---SubAPPID（用戶識別APPID）；
7.3.3. 間聯(lián)渠道商模式
該模式適用于渠道商給特約商戶，并給特約商戶發(fā)券查券。
1）商戶號校驗：
批次查詢商戶號= 批次發(fā)放商戶號 = 批次創(chuàng)建商戶號 = 渠道商；
批次歸屬商戶號 = 特約商戶號；
2）APPID校驗：（APPID滿足以下任一模式均可）
模式5，即MCHID（渠道商，查詢商戶號=創(chuàng)建商戶號=發(fā)放商戶號）--- APPID（用戶識別APPID）；
模式6，即MCHID（收單機構(gòu)）--- mchid（特約商戶，歸屬商戶號）---SubAPPID（用戶識別APPID）；
7.4. 核銷商家券
核銷用戶商家券接口文檔：點擊查看
1)、涉及的商戶號有：
調(diào)用該API接口的商戶號，即為商家券批次的核銷商戶號。當前商家券的規(guī)則是誰制券誰核銷，所以無論任何模式下，核銷商戶號一定等于批次創(chuàng)建商戶號。
2） 涉及的APPID有：
同樣因為涉及用戶信息的交互，就需要用戶OPENID，因此需要傳入用戶身份識別APPID（以下統(tǒng)稱為用戶識別APPID），有如下校驗規(guī)則：
7.4.1. 直連商戶模式
該模式適用于商戶核銷券。
1）商戶號校驗
批次核銷商戶號 = 批次創(chuàng)建商戶號；
2）APPID校驗
模式1，即MCHID（直連商戶，批次歸屬商戶號）--- APPID（用戶識別APPID）；
7.4.2. 普通服務商模式
該模式適用于普通服務商給特約商戶制券發(fā)券，并核券的場景。
1）商戶號校驗：
批次核銷商戶號 = 批次創(chuàng)建商戶號 = 普通服務商；
2）APPID校驗：（APPID滿足以下任一模式均可）
模式1，即MCHID（特約商戶，歸屬商戶號）--- APPID（用戶識別APPID）；
模式2，即MCHID（普通服務商，創(chuàng)建商戶號）--- APPID（用戶識別APPID）；
模式3，即MCHID（普通服務商，創(chuàng)建商戶號）--- mchid（特約商戶，歸屬商戶號）---SubAPPID（用戶識別APPID）；
7.4.3. 間聯(lián)渠道商模式
該模式適用于渠道商給特約商戶，并核券場景。
1）商戶號校驗：
批次核銷商戶號 = 批次創(chuàng)建商戶號 = 渠道商；
2）APPID校驗：（APPID滿足以下任一模式均可）
模式5，即MCHID（渠道商，創(chuàng)建商戶號）--- APPID（用戶識別APPID）；
模式6，即MCHID（收單機構(gòu)）--- mchid（特約商戶，歸屬商戶號）---SubAPPID（用戶識別APPID）；