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