在正式接入微信支付商家券服務(wù)前,你需要進行以下準(zhǔn)備步驟:
- 選擇接入模式:普通商戶或普通服務(wù)商
- 申請參數(shù):AppID、商戶號
- 操作指引
- AppID與商戶號(MCHID)綁定關(guān)系解釋
- 配置使用規(guī)則
# 1. 選擇接入模式
商戶需要判斷自己公司注冊區(qū)域適用的接入模式和自身實際情況,申請成為普通商戶或普通服務(wù)商:
- 普通商戶自行申請入駐微信支付,無需服務(wù)商協(xié)助。
- 普通服務(wù)商則自身無法作為一個普通商戶直接發(fā)起交易,其發(fā)起交易必須傳入相關(guān)特約商戶商戶號的參數(shù)信息。
具體接入模式介紹請參考接入模式文檔,并按照參考文檔完成相應(yīng)模式的接入。
# 2. 申請參數(shù)
請根據(jù)自身接入模式分別參考微信支付接入準(zhǔn)備-普通商戶或微信支付接入準(zhǔn)備-普通服務(wù)商中的參數(shù)申請 - 配置API key - 下載并配置商戶證書三個步驟申請接入?yún)?shù)。
# 3. 操作指引
# 3.1. 創(chuàng)建商家券
可通過調(diào)用創(chuàng)建商家券接口創(chuàng)建商家券,當(dāng)前支持創(chuàng)建的商家券類型包含滿減券、換購券和折扣券三種。
# 3.2. 發(fā)放商家券
當(dāng)前支持在商家小程序、H5、支付有禮、掃碼領(lǐng)券、小程序直播、搜一搜中派發(fā)商家券,具體操作流程和文檔請參見:微信支付券。
提示
商家的小程序需要先申請開通該發(fā)券插件的權(quán)限后,才可進行開發(fā)。申請審核1個工作日完成。
# 3.3. 核銷商家券
可通過調(diào)用核銷用戶券接口核銷用戶券。
# 3.4. 管理商家券
可通過調(diào)用查詢商家券批次信息、根據(jù)過濾條件查詢用戶券、查詢用戶券詳情接口管理商家券。
# 4. 綁定關(guān)系
# 4.1. 什么是綁定關(guān)系
- 對于服務(wù)商,想通過微信去觸達(dá)用戶、服務(wù)用戶,則需要以小程序、公眾號等形態(tài)去實現(xiàn),這時服務(wù)商需要在公眾平臺或開放平臺注冊賬號,每一個賬號背后都對應(yīng)一個開發(fā)者ID(AppID)。
- 出于安全隱私的角度,在服務(wù)商連接用戶時,微信不會直接把用戶的微信號(WechatId)予以暴露,而是通過OpenID去實現(xiàn)觸達(dá),實現(xiàn)服務(wù)。同一個微信用戶,在不同AppID下,OpenID不一樣。簡單理解:WechatID+AppID=OpenID。
- 同樣,對于服務(wù)商想要使用微信支付提供的服務(wù),比如支付體系接入,營銷優(yōu)惠券體系接入,都需要在微信支付側(cè)開立賬號,即開通商戶號(MCHID)。商戶號記錄交易資金往來,提供各種支付、營銷能力。
- 微信支付是在微信生態(tài)上的產(chǎn)品服務(wù)能力。所以涉及到與用戶的交互操作,比如公眾號支付的JSAPI下單,優(yōu)惠券發(fā)放等都需要公眾平臺AppID與商戶號MCHID打通交互。是否能做這樣的業(yè)務(wù)打通交互,即驗證AppID與MCHID之間是否有綁定關(guān)系。
# 4.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)模式 | 收單機構(gòu) | 模式4:MCHID(收單機構(gòu))- AppID |
間聯(lián)模式 | 渠道商 | 模式5:MCHID(渠道商)- AppID |
間聯(lián)模式 | 特約商戶 | 模式6:MCHID(收單機構(gòu))- mchid(特約商戶)-SubAPPID |
# 4.3. 如何綁定
# 4.3.1. MCHID-AppID
該模式更多適用于普通普通商戶、普通服務(wù)商、渠道商操作本商戶號與AppID的綁定關(guān)系。
已綁定AppID信息查看與新增綁定關(guān)系: (適用于普通商戶【模式1】、普通服務(wù)商特約商戶【模式1】、普通服務(wù)商【模式2】、渠道商【模式5】)
登錄微信服務(wù)商平臺 (opens new window)> 產(chǎn)品中心 > AppID賬號管理 > 我關(guān)聯(lián)的AppID賬號
綁定操作指引: 點擊查看 (opens new window)
注意
Westore商戶接入微信支付,其申請得到商戶號123,Westore有自己的小程序AppID為ABC。完成對應(yīng)操作,即可創(chuàng)建123(MCHID)---ABC(AppID)的綁定關(guān)系。
# 4.3.2. MCHID-mchid-SubAPPID
該模式更多適用于普通模式下特約商戶模式、間聯(lián)模式下特約商戶操作商戶號與AppID的綁定關(guān)系。
服務(wù)商管理特約商戶已綁定SubAPPID和新增綁定關(guān)系:(適用于普通服務(wù)商【模式3】、渠道商【模式6】)
登錄服務(wù)商平臺 (opens new window) > 服務(wù)商功能 > 特約商戶管理 > 開發(fā)配置 > 特約商戶AppID配置
特約商戶查看服務(wù)商為其配置的SubAPPID:(適用于普通服務(wù)商特約商戶【模式3】)
登錄服務(wù)商平臺 (opens new window) > 產(chǎn)品中心 > AppID賬號管理 > 服務(wù)商為我關(guān)聯(lián)的AppID賬號
綁定操作指引:點擊查看 (opens new window)
注意
Westore商戶由服務(wù)商XXX(商戶號456)接入微信支付,其申請得到商戶號123,Westore有自己的小程序AppID為ABC。完成對應(yīng)操作,即可創(chuàng)建456(服務(wù)商MCHID)---123(特約商戶MCHID)---ABC(SubAPPID)的綁定關(guān)系。
# 5. 配置使用規(guī)則
# 5.1. 創(chuàng)建商家券
商家券創(chuàng)建API接口文檔:點擊查看
調(diào)用該API接口的商戶號,即V3接口頭部參數(shù)簽名中的商戶號,即為商家券批次的創(chuàng)建商戶號。整個接口調(diào)用中:
- 涉及的商戶號有
- 批次創(chuàng)建商戶號(接口簽名商戶號)、批次歸屬商戶號(belong_merchant);
- 涉及的AppID有
- 立即使用跳轉(zhuǎn)小程序(以下統(tǒng)稱:use_method_appid)、自定義入口小程序以及公眾號(以下統(tǒng)稱:custom_entrance_appid)、事件通知AppID(以下統(tǒng)稱:notify_config_appid);
# 5.1.1. 普通服務(wù)商模式
- 商戶號校驗:
- 批次創(chuàng)建商戶號 = 普通服務(wù)商;批次歸屬商戶號 = 特約商戶商戶號;校驗創(chuàng)建商戶號與歸屬商戶號之間是否有服務(wù)商與特約商戶的父子受理關(guān)系;
- AppID校驗:(AppID滿足以下任一模式均可)
- 模式1,即MCHID(特約商戶,歸屬商戶號)--- AppID;
- 模式2,即MCHID(普通服務(wù)商,創(chuàng)建商戶號)--- AppID;
- 模式3,即MCHID(普通服務(wù)商,創(chuàng)建商戶號)--- mchid(特約商戶,歸屬商戶號)---SubAPPID;
# 5.1.2. 間聯(lián)渠道商模式
該模式適用于渠道商給特約商戶制券。
- 商戶號校驗:
- 批次創(chuàng)建商戶號 = 渠道商;批次歸屬商戶號 = 特約商戶商戶號;校驗創(chuàng)建商戶號與歸屬商戶號之間是否有渠道商與特約商戶的渠道拓展關(guān)系;
- AppID校驗:(AppID滿足以下任一模式均可)
- 模式5,即MCHID(渠道商,創(chuàng)建商戶號)--- AppID;
- 模式6,即MCHID(收單機構(gòu))--- mchid(特約商戶,歸屬商戶號)---SubAPPID;
# 5.2. 發(fā)放商家券(小程序發(fā)券&H5發(fā)券)
商家券小程序發(fā)券接口文檔:點擊查看
商家券H5發(fā)券接口文檔:點擊查看
- 涉及的商戶號有:
- 調(diào)用該API接口的商戶號,即為商家券批次的發(fā)放商戶號。
- 涉及的AppID有:
- 接入小程序插件的小程序AppID,或H5發(fā)券接口中傳入的OpenID背后的AppID,以下統(tǒng)稱為發(fā)券場景AppID。
# 5.2.1. 普通服務(wù)商模式
該模式適用于普通服務(wù)商給特約商戶,并給特約商戶發(fā)券。
- 商戶號校驗:
- 批次發(fā)放商戶號 = 批次創(chuàng)建商戶號 = 普通服務(wù)商;
- AppID校驗:(AppID滿足以下任一模式均可)
- 模式1,即MCHID(特約商戶,歸屬商戶號)--- AppID(發(fā)券場景AppID);
- 模式2,即MCHID(普通服務(wù)商,創(chuàng)建商戶號=發(fā)放商戶號)--- AppID(發(fā)券場景AppID);
- 模式3,即MCHID(普通服務(wù)商,創(chuàng)建商戶號=發(fā)放商戶號)--- mchid(特約商戶,歸屬商戶號)---SubAPPID(發(fā)券場景AppID);
# 5.2.2. 間聯(lián)渠道商模式
該模式適用于渠道商給特約商戶,并給特約商戶發(fā)券。
- 商戶號校驗:
- 批次發(fā)放商戶號 = 批次創(chuàng)建商戶號 = 渠道商;
- AppID校驗:(AppID滿足以下任一模式均可)
- 模式5,即MCHID(渠道商,創(chuàng)建商戶號=發(fā)放商戶號)--- AppID(發(fā)券場景AppID);
- 模式6,即MCHID(收單機構(gòu))--- mchid(特約商戶,歸屬商戶號)---SubAPPID(發(fā)券場景AppID);
# 5.3. 查詢用戶卡包里商家券
根據(jù)過濾條件查詢用戶券API接口文檔:點擊查看
查詢用戶單張券API接口文檔:點擊查看
- 涉及的商戶號有:
- 調(diào)用該API接口的商戶號,即為商家券批次的發(fā)放查詢商戶號(以下統(tǒng)稱為批次查詢商戶號)。接口內(nèi)部還涉及批次的創(chuàng)建商戶號(creator_merchant)、批次發(fā)放商戶號(sender_merchant)、批次歸屬商戶號(belong_merchant);
- 涉及的AppID有:
- 因為查用戶卡包的券信息,涉及用戶信息的交互,就需要用戶OpenID,因此需要傳入用戶身份識別AppID(以下統(tǒng)稱為用戶識別AppID),有如下校驗規(guī)則:
# 5.3.1. 普通服務(wù)商模式
該模式適用于普通服務(wù)商給特約商戶制券發(fā)券,并查券的場景。
- 商戶號校驗:
- 批次查詢商戶號= 批次發(fā)放商戶號 = 批次創(chuàng)建商戶號 = 普通服務(wù)商;
- 批次歸屬商戶號 = 特約商戶號;
- AppID校驗:(AppID滿足以下任一模式均可)
- 模式1,即MCHID(特約商戶,歸屬商戶號)--- AppID(用戶識別AppID);
- 模式2,即MCHID(普通服務(wù)商,查詢商戶號=創(chuàng)建商戶號=發(fā)放商戶號)--- AppID(用戶識別AppID);
- 模式3,即MCHID(普通服務(wù)商,查詢商戶號=創(chuàng)建商戶號=發(fā)放商戶號)--- mchid(特約商戶,歸屬商戶號)---SubAPPID(用戶識別AppID);
# 5.3.2. 間聯(lián)渠道商模式
該模式適用于渠道商給特約商戶,并給特約商戶發(fā)券查券。
- 商戶號校驗:
- 批次查詢商戶號= 批次發(fā)放商戶號 = 批次創(chuàng)建商戶號 = 渠道商;
- 批次歸屬商戶號 = 特約商戶號;
- AppID校驗:(AppID滿足以下任一模式均可)
- 模式5,即MCHID(渠道商,查詢商戶號=創(chuàng)建商戶號=發(fā)放商戶號)--- AppID(用戶識別AppID);
- 模式6,即MCHID(收單機構(gòu))--- mchid(特約商戶,歸屬商戶號)---SubAPPID(用戶識別AppID);
# 5.4. 核銷商家券
核銷用戶商家券接口文檔:點擊查看
- 涉及的商戶號有:
- 調(diào)用該API接口的商戶號,即為商家券批次的核銷商戶號。當(dāng)前商家券的規(guī)則是誰制券誰核銷,所以無論任何模式下,核銷商戶號一定等于批次創(chuàng)建商戶號。
- 涉及的AppID有:
- 同樣因為涉及用戶信息的交互,就需要用戶OpenID,因此需要傳入用戶身份識別AppID(以下統(tǒng)稱為用戶識別AppID),有如下校驗規(guī)則:
# 5.4.1. 普通服務(wù)商模式
該模式適用于普通服務(wù)商給特約商戶制券發(fā)券,并核券的場景。
- 商戶號校驗:
- 批次核銷商戶號 = 批次創(chuàng)建商戶號 = 普通服務(wù)商;
- AppID校驗:(AppID滿足以下任一模式均可)
- 模式1,即MCHID(特約商戶,歸屬商戶號)--- AppID(用戶識別AppID);
- 模式2,即MCHID(普通服務(wù)商,創(chuàng)建商戶號)--- AppID(用戶識別AppID);
- 模式3,即MCHID(普通服務(wù)商,創(chuàng)建商戶號)--- mchid(特約商戶,歸屬商戶號)---SubAPPID(用戶識別AppID);
# 5.4.2. 間聯(lián)渠道商模式
該模式適用于渠道商給特約商戶,并核券場景。
- 商戶號校驗:
- 批次核銷商戶號 = 批次創(chuàng)建商戶號 = 渠道商;
- AppID校驗:(AppID滿足以下任一模式均可)
- 模式5,即MCHID(渠道商,創(chuàng)建商戶號)--- AppID(用戶識別AppID);
- 模式6,即MCHID(收單機構(gòu))--- mchid(特約商戶,歸屬商戶號)---SubAPPID(用戶識別AppID);