一、創(chuàng)建卡券

---

1、步驟一：上傳卡券圖片素材

https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN

使用到微信的 CDN

2、步驟二：設(shè)置卡券適用門(mén)店

location_id_list

3、步驟三：選取卡券背景顏色

color 固定有十四種

4、步驟四：創(chuàng)建卡券

https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

base_info（卡券基礎(chǔ)信息）字段 - 必填字段

base_info（卡券基礎(chǔ)信息）字段 - 非必填字段

Advanced_info（卡券高級(jí)信息）字段

填入時(shí)間限制字段（time_limit）,只控制顯示，不控制實(shí)際使用邏輯，不填默認(rèn)不顯示。

創(chuàng)建成功后該卡券會(huì)自動(dòng)提交審核，審核結(jié)果將通過(guò)事件通知商戶。開(kāi)發(fā)者可調(diào)用設(shè)置白名單接口設(shè)置用戶白名單，領(lǐng)取未通過(guò)審核的卡券，測(cè)試整個(gè)卡券的使用流程。

https://api.weixin.qq.com/card/testwhitelist/set?access_token=TOKEN

1.同時(shí)支持“openid”、“username”兩種字段設(shè)置白名單，總數(shù)上限為10個(gè)。

2.設(shè)置測(cè)試白名單接口為全量設(shè)置，即測(cè)試名單發(fā)生變化時(shí)需調(diào)用該接口重新傳入所有測(cè)試人員的ID。

（1）厘清概念

卡券分card_id 與Code碼，前者相當(dāng)于 java 的類(lèi)，后者相當(dāng)于 實(shí)例化對(duì)象。

（2）卡券類(lèi)型

卡券類(lèi)型有基本的四種：（還有其他的，如會(huì)員卡和電影票等等，見(jiàn)文章后面）

團(tuán)購(gòu)券"card_type": "GROUPON",

代金券 "card_type": "CASH",

折扣券"card_type": "DISCOUNT",

兌換券"card_type": "GIFT",

（3）code碼類(lèi)型

use_custom_code、 get_custom_code_mode

code碼類(lèi)型有三種：

非自定義code碼 （微信后臺(tái)隨機(jī)分配 - 默認(rèn)）

自定義code碼

導(dǎo)入code模式

（4）卡券的展示碼型

code_type

卡券的展示碼型有四種：

二維碼/一維碼顯示code

二維碼不顯示code

僅code類(lèi)型

無(wú)code類(lèi)型

（5）卡券詳情頁(yè)支持有三個(gè)入口做自定義跳轉(zhuǎn)

使用場(chǎng)景入口

服務(wù)場(chǎng)景入口

營(yíng)銷(xiāo)場(chǎng)景入口

跳轉(zhuǎn)外鏈會(huì)自動(dòng)帶參數(shù)：http://www.qq.com?encrypt_code=ENCRYPT_CODE&card_id=CARDID

其中 encrypt_code為加密碼，需調(diào)用解碼接口獲取真實(shí)Code碼。

5、快速買(mǎi)單（可自助核銷(xiāo)）

略

二、投放卡券

---

"outer_str" : "12b"

當(dāng)用戶領(lǐng)取卡券時(shí)會(huì)將相應(yīng)設(shè)值的outer_id帶入領(lǐng)取事件中，推送至開(kāi)發(fā)者服務(wù)器。

1、創(chuàng)建二維碼接口

https://api.weixin.qq.com/card/qrcode/create?access_token=TOKEN

掃碼領(lǐng)一張 or 多張 (最多支持同時(shí)領(lǐng)5張)

2、H5 線上發(fā)券（JS-SDK 接口）

需要獲取api_ticket:

https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=wx_card

注意跟JS-SDK 里的 jsapi_ticket 不一樣，后者這樣獲取：https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi

（1）拉取適用卡券列表并獲取用戶選擇信息 chooseCard

（2）批量添加卡券接口 addCard

（3）查看微信卡包中的卡券接口 openCard

3、卡券貨架

卡券貨架支持開(kāi)發(fā)者通過(guò)調(diào)用接口生成一個(gè)卡券領(lǐng)取H5頁(yè)面（微信幫你生成），并獲取頁(yè)面鏈接，進(jìn)行卡券投放動(dòng)作。

4、群發(fā)卡券（僅支持非自定義code的卡券）

圖文消息群發(fā)

根據(jù)用戶分組群發(fā)

根據(jù)OpenID列表群發(fā)

客服消息下發(fā)

三、核銷(xiāo)卡券

---

在用戶使用券之后讓卡券從用戶的微信客戶端消失的過(guò)程，這個(gè)步驟稱(chēng)為核銷(xiāo)。

1、線下

（1）查詢Code接口

https://api.weixin.qq.com/card/code/get?access_token=TOKEN

我們強(qiáng)烈建議開(kāi)發(fā)者在調(diào)用核銷(xiāo)code接口之前調(diào)用查詢code接口，并在核銷(xiāo)之前對(duì)非法狀態(tài)的code(如轉(zhuǎn)贈(zèng)中、已刪除、已核銷(xiāo)等)做出處理。

（2）核銷(xiāo)Code接口

https://api.weixin.qq.com/card/code/consume?access_token=TOKEN

此操作不可逆。

2、線上

（1）拉取卡券列表接口（JS-SDK）

獲取到前端用戶要核銷(xiāo)哪張券，只不過(guò)把 code 加密成了encrypt_code

（2）Code解碼接口

后臺(tái)把從前端獲取的encrypt_code解碼成明文的 code：

https://api.weixin.qq.com/card/code/decrypt?access_token=TOKEN

然后接下來(lái)的第（3）（4）對(duì)應(yīng)著上面1、線下的（1）（2）兩步

四、管理卡券

---

1、獲取用戶已領(lǐng)取的卡券

可查所有的，可查某個(gè)卡下的：

https://api.weixin.qq.com/card/user/getcardlist?access_token=TOKEN

2、查看卡券詳情

查看一張：https://api.weixin.qq.com/card/get?access_token=TOKEN

查看多張： https://api.weixin.qq.com/card/batchget?access_token=TOKEN

3、更改卡券信息

https://api.weixin.qq.com/card/update?access_token=TOKEN

只支持部分字段的更新，詳細(xì)看文檔

有的字段更新后會(huì)重新進(jìn)入審核狀態(tài)

若開(kāi)發(fā)者置空某些字段，可直接在更新時(shí)傳“”（空）

4、修改卡券庫(kù)存

https://api.weixin.qq.com/card/modifystock?access_token=TOKEN

5、更改卡券Code（只針對(duì)自定義Code的卡券）

https://api.weixin.qq.com/card/code/update?access_token=TOKEN

為避免用戶疑惑，建議僅在發(fā)生轉(zhuǎn)贈(zèng)行為后更改。

6、刪除卡券接口

針對(duì) card_id

刪除卡券不能刪除已被用戶領(lǐng)取，保存在微信客戶端中的卡券。

https://api.weixin.qq.com/card/delete?access_token=TOKEN

7、設(shè)置卡券失效接口

針對(duì) card_id 和 code （都必填）

https://api.weixin.qq.com/card/code/unavailable?access_token=TOKEN

操作不可逆，小心客訴.

8、統(tǒng)計(jì)卡券數(shù)據(jù)

（1）拉取所有卡券概況數(shù)據(jù)

https://api.weixin.qq.com/datacube/getcardbizuininfo?access_token=ACCESS_TOKEN

范圍的話只能拉取非當(dāng)天之前的數(shù)據(jù)

（2）獲取具體券數(shù)據(jù)

https://api.weixin.qq.com/datacube/getcardcardinfo?access_token=ACCESS_TOKEN

（3）拉取會(huì)員概況數(shù)據(jù)

https://api.weixin.qq.com/datacube/getcardmembercardinfo?access_token=ACCESS_TOKEN

（4）拉取單張會(huì)員卡數(shù)據(jù)

https://api.weixin.qq.com/datacube/getcardmembercarddetail?access_token=ACCESS_TOKEN

五、卡券事件推送

---

1、針對(duì)卡券

審核事件推送

領(lǐng)取事件推送

轉(zhuǎn)贈(zèng)事件推送

刪除事件推送

核銷(xiāo)事件推送

買(mǎi)單事件推送

從卡券進(jìn)入公眾號(hào)會(huì)話事件推送

庫(kù)存報(bào)警事件（當(dāng)某個(gè)card_id的初始庫(kù)存數(shù)大于200且當(dāng)前庫(kù)存小于等于100時(shí)，用戶嘗試領(lǐng)券會(huì)觸發(fā)發(fā)送事件給商戶，事件每隔12h發(fā)送一次。）

2、針對(duì)會(huì)員卡

會(huì)員卡激活事件推送

進(jìn)入會(huì)員卡事件推送

會(huì)員卡內(nèi)容更新事件（如會(huì)員卡積分余額發(fā)生變動(dòng)）

3、其他

券點(diǎn)流水詳情事件（如當(dāng)商戶朋友的券券點(diǎn)發(fā)生變動(dòng)時(shí)）

六、卡券-小程序打通

---

1、小程序內(nèi)領(lǐng)取卡券

wx.addcard

2、小程序內(nèi)查看卡券

wx.opencard

3、卡券內(nèi)跳轉(zhuǎn)小程序

略

4、小程序開(kāi)（會(huì)員）卡組件

見(jiàn)下文

六、朋友的券（朋友共享的優(yōu)惠券）

“一人領(lǐng)取多人共享”

略

七、立減金

---

小程序社交立減金是一款幫助商家快速生成具備裂變傳播屬性的小程序經(jīng)營(yíng)工具，用戶通過(guò)支付、掃碼等場(chǎng)景可以參與社交立減金活動(dòng)，將社交立減金禮包分享至朋友后自己可獲取一份，朋友在會(huì)話中可隨機(jī)獲取社交立減金，并直達(dá)商家小程序使用。

略

八、特殊票券

---

1、會(huì)議/演出門(mén)票

（1）創(chuàng)建會(huì)議門(mén)票

https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

"card_type": "MEETING_TICKET"

（2）更新會(huì)議門(mén)票

https://api.weixin.qq.com/card/meetingticket/updateuser?access_token=TOKEN

2、景區(qū)門(mén)票

（1）創(chuàng)建景區(qū)門(mén)票

https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

"card_type": "SCENIC_TICKET"

3、電影票

（1）創(chuàng)建電影票

https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

"card_type": "MOVIE_TICKET"

（2）更新電影票

https://api.weixin.qq.com/card/meetingticket/updateuser?access_token=TOKEN

4、飛機(jī)票

飛機(jī)票與其他卡券相比具有更強(qiáng)的時(shí)效性和特殊性，故機(jī)票生成后無(wú)需經(jīng)過(guò)微信審核，即時(shí)生效。

（1）創(chuàng)建飛機(jī)票接口

https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

"card_type": "BOARDING_PASS"

（2）更新飛機(jī)票信息接口

https://api.weixin.qq.com/card/boardingpass/checkin?access_token=TOKEN

九、會(huì)員卡

---

1、創(chuàng)建會(huì)員卡

https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

"card_type": "MEMBER_CARD"

2、激活會(huì)員卡

需要用到小程序開(kāi)（會(huì)員）卡組件，分跳轉(zhuǎn)型和非跳轉(zhuǎn)型。

通過(guò)創(chuàng)建會(huì)員卡時(shí)傳的activate_url、auto_activate和wx_activate決定。

（1）方法一：自動(dòng)激活（非跳轉(zhuǎn)型）

"auto_activate": true

（2）方法二：普通一鍵激活（非跳轉(zhuǎn)型）

步驟一：在創(chuàng)建卡券接口時(shí)填入字段

"wx_activate": true

步驟二：設(shè)置開(kāi)卡字段

設(shè)置用戶激活時(shí)需要填寫(xiě)的選項(xiàng)：

https://api.weixin.qq.com/card/membercard/activateuserform/set?access_token=TOKEN

步驟三：接收推送通知

步驟四：調(diào)用接口激活會(huì)員卡

https://api.weixin.qq.com/card/membercard/activate?access_token=TOKEN

（3）方法三：跳轉(zhuǎn)型一鍵激活（跳轉(zhuǎn)型）

支持用戶在提交會(huì)員開(kāi)卡資料后跳轉(zhuǎn)至商戶自定義的網(wǎng)頁(yè)。

步驟一：在創(chuàng)建卡券接口時(shí)填入字段

"wx_activate": true,

"wx_activate_after_submit" : true,

"wx_activate_after_submit_url" : "https://qq.com"

步驟二：設(shè)置開(kāi)卡字段

步驟三：獲取用戶提交資料

微信會(huì)在跳轉(zhuǎn)url后拼接獲取用戶填寫(xiě)信息的參數(shù)，或者通過(guò)接口拿到：

https://api.weixin.qq.com/card/membercard/activatetempinfo/get?access_token=TOKEN

步驟四：調(diào)用接口激活會(huì)員卡

https://api.weixin.qq.com/card/membercard/activate?access_token=TOKEN

3、更新會(huì)員信息

https://api.weixin.qq.com/card/membercard/updateuser?access_token=TOKEN

---

參考資料

微信官方文檔
https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141229

轉(zhuǎn)載于:https://www.cnblogs.com/xjnotxj/p/10283808.html

與50位技術(shù)專(zhuān)家面對(duì)面20年技術(shù)見(jiàn)證，附贈(zèng)技術(shù)全景圖

總結(jié)

以上是生活随笔為你收集整理的微信卡券 - 微信公众平台 整理笔记的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。