在正式接入微信支付商家券服務(wù)前，你需要進(jìn)行以下準(zhǔn)備步驟：

1. 選擇接入模式：普通商戶(hù)或普通服務(wù)商
2. 申請(qǐng)參數(shù)：AppID、商戶(hù)號(hào)
3. 操作指引
4. AppID與商戶(hù)號(hào)（MCHID）綁定關(guān)系解釋
5. 配置使用規(guī)則

# 1. 選擇接入模式

商戶(hù)需要判斷自己公司注冊(cè)區(qū)域適用的接入模式和自身實(shí)際情況，申請(qǐng)成為普通商戶(hù)或普通服務(wù)商：

• 普通商戶(hù)自行申請(qǐng)入駐微信支付，無(wú)需服務(wù)商協(xié)助。
• 普通服務(wù)商則自身無(wú)法作為一個(gè)普通商戶(hù)直接發(fā)起交易，其發(fā)起交易必須傳入相關(guān)特約商戶(hù)商戶(hù)號(hào)的參數(shù)信息。

具體接入模式介紹請(qǐng)參考接入模式文檔，并按照參考文檔完成相應(yīng)模式的接入。

# 2. 申請(qǐng)參數(shù)

請(qǐng)根據(jù)自身接入模式分別參考微信支付接入準(zhǔn)備-普通商戶(hù)或微信支付接入準(zhǔn)備-普通服務(wù)商中的參數(shù)申請(qǐng) - 配置API key - 下載并配置商戶(hù)證書(shū)三個(gè)步驟申請(qǐng)接入?yún)?shù)。

# 3. 操作指引

# 3.1. 創(chuàng)建商家券

可通過(guò)調(diào)用創(chuàng)建商家券接口創(chuàng)建商家券，當(dāng)前支持創(chuàng)建的商家券類(lèi)型包含滿(mǎn)減券、換購(gòu)券和折扣券三種。

# 3.2. 發(fā)放商家券

當(dāng)前支持在商家小程序、H5、支付有禮、掃碼領(lǐng)券、小程序直播、搜一搜中派發(fā)商家券，具體操作流程和文檔請(qǐng)參見(jiàn)：微信支付券。

# 3.3. 核銷(xiāo)商家券

可通過(guò)調(diào)用核銷(xiāo)用戶(hù)券接口核銷(xiāo)用戶(hù)券。

# 3.4. 管理商家券

可通過(guò)調(diào)用查詢(xún)商家券批次信息、根據(jù)過(guò)濾條件查詢(xún)用戶(hù)券、查詢(xún)用戶(hù)券詳情接口管理商家券。

# 4. AppID與商戶(hù)號(hào)（MCHID）綁定關(guān)系解釋

# 4.1. 什么是綁定關(guān)系

• 對(duì)于商戶(hù)，想通過(guò)微信去觸達(dá)用戶(hù)、服務(wù)用戶(hù)，則需要以小程序、公眾號(hào)等形態(tài)去實(shí)現(xiàn)，這時(shí)商戶(hù)需要在公眾平臺(tái)或開(kāi)放平臺(tái)注冊(cè)賬號(hào)，每一個(gè)賬號(hào)背后都對(duì)應(yīng)一個(gè)開(kāi)發(fā)者ID（AppID）。
• 出于安全隱私的角度，在商戶(hù)連接用戶(hù)時(shí)，微信不會(huì)直接把用戶(hù)的微信號(hào)（WechatId）予以暴露，而是通過(guò)OpenID去實(shí)現(xiàn)觸達(dá)，實(shí)現(xiàn)服務(wù)。同一個(gè)微信用戶(hù)，在不同AppID下，OpenID不一樣。簡(jiǎn)單理解：WechatID+AppID=OpenID。
• 同樣，對(duì)于商戶(hù)想要使用微信支付提供的服務(wù)，比如支付體系接入，營(yíng)銷(xiāo)優(yōu)惠券體系接入，都需要在微信支付側(cè)開(kāi)立賬號(hào)，即開(kāi)通商戶(hù)號(hào)（MCHID）。商戶(hù)號(hào)記錄交易資金往來(lái)，提供各種支付、營(yíng)銷(xiāo)能力。
• 微信支付是在微信生態(tài)上的產(chǎn)品服務(wù)能力。所以涉及到與用戶(hù)的交互操作，比如公眾號(hào)支付的JSAPI下單，優(yōu)惠券發(fā)放等都需要公眾平臺(tái)AppID與商戶(hù)號(hào)MCHID打通交互。是否能做這樣的業(yè)務(wù)打通交互，即驗(yàn)證AppID與MCHID之間是否有綁定關(guān)系。

# 4.2. 綁定模式

以本商戶(hù)號(hào)為視角，有以下綁定關(guān)系：

業(yè)務(wù)模式	商戶(hù)角色	MCHID與AppID綁定關(guān)系模式
直連模式	普通商戶(hù)	模式1：MCHID（普通商戶(hù)）- AppID
直連模式	普通服務(wù)商	模式2：MCHID（普通服務(wù)商）- AppID
直連模式	特約商戶(hù)（直連角色）	模式1：MCHID（特約商戶(hù)）- AppID
直連模式	特約商戶(hù)（普通服務(wù)商下特約商戶(hù)角色）	模式3：MCHID（普通服務(wù)商）- mchid（特約商戶(hù)）-SubAPPID
間聯(lián)模式	收單機(jī)構(gòu)	模式4：MCHID（收單機(jī)構(gòu)）- AppID
間聯(lián)模式	渠道商	模式5：MCHID（渠道商）- AppID
間聯(lián)模式	特約商戶(hù)	模式6：MCHID（收單機(jī)構(gòu)）- mchid（特約商戶(hù)）-SubAPPID

# 4.3. 如何綁定

# 4.3.1. MCHID-AppID

已綁定AppID信息查看與新增綁定關(guān)系： （適用于普通商戶(hù)【模式1】、普通服務(wù)商特約商戶(hù)【模式1】、普通服務(wù)商【模式2】、渠道商【模式5】）

登錄商戶(hù)平臺(tái) (opens new window)> 產(chǎn)品中心 > AppID賬號(hào)管理 > 我關(guān)聯(lián)的AppID賬號(hào)

綁定操作指引： 點(diǎn)擊查看 (opens new window)

# 5. 配置使用規(guī)則

# 5.1. 創(chuàng)建商家券

商家券創(chuàng)建API接口文檔：點(diǎn)擊查看

調(diào)用該API接口的商戶(hù)號(hào)，即V3接口頭部參數(shù)簽名中的商戶(hù)號(hào)，即為商家券批次的創(chuàng)建商戶(hù)號(hào)。整個(gè)接口調(diào)用中：

• 涉及的商戶(hù)號(hào)有
  • 批次創(chuàng)建商戶(hù)號(hào)（接口簽名商戶(hù)號(hào)）、批次歸屬商戶(hù)號(hào)（belong_merchant）；
• 涉及的AppID有
  • 立即使用跳轉(zhuǎn)小程序（以下統(tǒng)稱(chēng)：use_method_appid）、自定義入口小程序以及公眾號(hào)（以下統(tǒng)稱(chēng)：custom_entrance_appid）、事件通知AppID（以下統(tǒng)稱(chēng)：notify_config_appid）；

# 5.1.1. 普通商戶(hù)模式

該模式適用于商戶(hù)自己給自己制券。

• 商戶(hù)號(hào)校驗(yàn)：
  • 創(chuàng)建商戶(hù)號(hào)與歸屬商戶(hù)號(hào)是同一個(gè)商戶(hù)號(hào)，即批次創(chuàng)建商戶(hù)號(hào) = 批次歸屬商戶(hù)號(hào)；
• AppID校驗(yàn)：
  • 模式1，即MCHID（普通商戶(hù)，歸屬商戶(hù)號(hào)）--- AppID；

# 5.2. 發(fā)放商家券（小程序發(fā)券&H5發(fā)券）

商家券小程序發(fā)券接口文檔：點(diǎn)擊查看

商家券H5發(fā)券接口文檔：點(diǎn)擊查看

• 涉及的商戶(hù)號(hào)有：
  • 調(diào)用該API接口的商戶(hù)號(hào)，即為商家券批次的發(fā)放商戶(hù)號(hào)。
• 涉及的AppID有：
  • 接入小程序插件的小程序AppID，或H5發(fā)券接口中傳入的OpenID背后的AppID，以下統(tǒng)稱(chēng)為發(fā)券場(chǎng)景AppID。

# 5.2.1. 普通商戶(hù)模式

該模式適用于商戶(hù)自己制券自己發(fā)券。

• 商戶(hù)號(hào)校驗(yàn)：
  • 即誰(shuí)制券誰(shuí)調(diào)用接口發(fā)券，該模式會(huì)校驗(yàn)制券商戶(hù)號(hào)是否未發(fā)放批次的創(chuàng)建商戶(hù)號(hào)，即發(fā)券商戶(hù)號(hào) = 批次創(chuàng)建商戶(hù)號(hào)；
• AppID校驗(yàn)：
  • 模式1，即MCHID（普通商戶(hù)，批次歸屬商戶(hù)號(hào)=批次發(fā)放商戶(hù)號(hào)）--- AppID（發(fā)券場(chǎng)景AppID）；

# 5.3. 查詢(xún)用戶(hù)卡包里商家券

根據(jù)過(guò)濾條件查詢(xún)用戶(hù)券API接口文檔：點(diǎn)擊查看

查詢(xún)用戶(hù)單張券API接口文檔：點(diǎn)擊查看

• 涉及的商戶(hù)號(hào)有：
  • 調(diào)用該API接口的商戶(hù)號(hào)，即為商家券批次的發(fā)放查詢(xún)商戶(hù)號(hào)（以下統(tǒng)稱(chēng)為批次查詢(xún)商戶(hù)號(hào)）。接口內(nèi)部還涉及批次的創(chuàng)建商戶(hù)號(hào)（creator_merchant）、批次發(fā)放商戶(hù)號(hào)（sender_merchant）、批次歸屬商戶(hù)號(hào)（belong_merchant）；
• 涉及的AppID有：
  • 因?yàn)椴橛脩?hù)卡包的券信息，涉及用戶(hù)信息的交互，就需要用戶(hù)OpenID，因此需要傳入用戶(hù)身份識(shí)別AppID（以下統(tǒng)稱(chēng)為用戶(hù)識(shí)別AppID），有如下校驗(yàn)規(guī)則：

# 5.3.1. 普通商戶(hù)模式

該模式適用于商戶(hù)自己查詢(xún)自己發(fā)的券 or 自己創(chuàng)建的券 or 歸屬于自己的券。

• 商戶(hù)號(hào)校驗(yàn)
  • 批次查詢(xún)商戶(hù)號(hào) = 批次創(chuàng)建商戶(hù)號(hào) = 批次歸屬商戶(hù)號(hào) = 批次發(fā)放商戶(hù)號(hào)；
• AppID校驗(yàn)
  • 模式1，即MCHID（普通商戶(hù)，批次發(fā)放商戶(hù)號(hào)=批次創(chuàng)建商戶(hù)號(hào)=批次歸屬商戶(hù)號(hào)=批次查詢(xún)商戶(hù)號(hào)）--- AppID（用戶(hù)識(shí)別AppID）；

# 5.4. 核銷(xiāo)商家券

核銷(xiāo)用戶(hù)商家券接口文檔：點(diǎn)擊查看

• 涉及的商戶(hù)號(hào)有：
  • 調(diào)用該API接口的商戶(hù)號(hào)，即為商家券批次的核銷(xiāo)商戶(hù)號(hào)。當(dāng)前商家券的規(guī)則是誰(shuí)制券誰(shuí)核銷(xiāo)，所以無(wú)論任何模式下，核銷(xiāo)商戶(hù)號(hào)一定等于批次創(chuàng)建商戶(hù)號(hào)。
• 涉及的AppID有：
  • 同樣因?yàn)樯婕坝脩?hù)信息的交互，就需要用戶(hù)OpenID，因此需要傳入用戶(hù)身份識(shí)別AppID（以下統(tǒng)稱(chēng)為用戶(hù)識(shí)別AppID），有如下校驗(yàn)規(guī)則：

# 5.4.1. 普通商戶(hù)模式

該模式適用于商戶(hù)核銷(xiāo)券。

• 商戶(hù)號(hào)校驗(yàn)
  • 批次核銷(xiāo)商戶(hù)號(hào) = 批次創(chuàng)建商戶(hù)號(hào)；
• AppID校驗(yàn)
  • 模式1，即MCHID（普通商戶(hù)，批次歸屬商戶(hù)號(hào)）--- AppID（用戶(hù)識(shí)別AppID）；