一、創(chuàng)建卡券

---

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

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

使用到微信的 CDN

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

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é)果將通過事件通知商戶。開發(fā)者可調(diào)用設(shè)置白名單接口設(shè)置用戶白名單，領(lǐng)取未通過審核的卡券，測(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 的類，后者相當(dāng)于 實(shí)例化對(duì)象。

（2）卡券類型

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

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

代金券 "card_type": "CASH",

折扣券"card_type": "DISCOUNT",

兌換券"card_type": "GIFT",

（3）code碼類型

use_custom_code、 get_custom_code_mode

code碼類型有三種：

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

自定義code碼

導(dǎo)入code模式

（4）卡券的展示碼型

code_type

卡券的展示碼型有四種：

二維碼/一維碼顯示code

二維碼不顯示code

僅code類型

無code類型

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

使用場(chǎng)景入口

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

營(yíng)銷場(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、快速買單（可自助核銷）

略

二、投放卡券

---

"outer_str" : "12b"

當(dāng)用戶領(lǐng)取卡券時(shí)會(huì)將相應(yīng)設(shè)值的outer_id帶入領(lǐng)取事件中，推送至開發(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、卡券貨架

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

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

圖文消息群發(fā)

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

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

客服消息下發(fā)

三、核銷卡券

---

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

1、線下

（1）查詢Code接口

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

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

（2）核銷Code接口

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

此操作不可逆。

2、線上

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

獲取到前端用戶要核銷哪張券，只不過把 code 加密成了encrypt_code

（2）Code解碼接口

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

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

然后接下來的第（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)

若開發(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)事件推送

刪除事件推送

核銷事件推送

買單事件推送

從卡券進(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、小程序開（會(huì)員）卡組件

見下文

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

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

略

七、立減金

---

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

略

八、特殊票券

---

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

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

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

"card_type": "MEETING_TICKET"

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

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

2、景區(qū)門票

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

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ī)票生成后無需經(jīng)過微信審核，即時(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ì)員卡

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

通過創(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è)置開卡字段

設(shè)置用戶激活時(shí)需要填寫的選項(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ì)員開卡資料后跳轉(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è)置開卡字段

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

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

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ù)專家面對(duì)面20年技術(shù)見證，附贈(zèng)技術(shù)全景圖

總結(jié)

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

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