浅谈微信卡券功能开发（2）

               

回顾

    继续介绍NODEJS开发微信卡券功能，昨天简单演示了微信接口的Access Token的原理和用法，还有门店的添加和查询，今天我们将介绍卡券的创建以及核销的最基本的流程。

    本文将使用NodeJS作为开发语言，以wechat-card，和官方文档为主进行演示。

 

创建卡券

    昨天我们已经添加完成门店，接下来我们将要创建卡券。微信的API接口为：

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

    使用wechat-card module可以按照以下操作：

1 2 3 4 5 6 7 8 9 10 11 12 13

var  card = {      card_type:  "DISCOUNT" ,      base_info: {          // ...      },      special_info: {          // ...      } };   wxCard.card.createCard(card,  function (err, cardId) {        // 创建成功后，返回卡券的ID });

    这里有需要特别说明的，card_type为卡券的类型，wechat-card module目前只支持DISCOUNT(折扣券), CASH(现金券), GENERAL_COUPON(普通优惠券), GIFT(礼品券), GROUPON(团购券), LUCK_MONEY(红包)，其他类型的大家可以按照官方文档进行操作。

    卡券的配置参数中，可以分为三个类型的参数，一是card_type，即卡券类型；二是base_info，即基本信息，所有类型的卡券都会包含这部分参数，具体的参数请参见wechat-card文档或者官方文档；三是每种类型的卡券特有的参数，wechat-card中将这类参数归为special_info。

    在base_info中，分为必须参数和可选参数，具体参见文档，这里有几个要特别说明的配置字段：

    1. color: 这个字段来设置卡券的背景颜色，我们要特别说明这个字段的原因是，这里的颜色不是我们可以随意设置的，微信提供了一组颜色代码，我们必须从中选择一个。我们可以通过接口来获取到微信提供的颜色列表：

1 2 3 4

// 微信提供的接口为：https://api.weixin.qq.com/card/getcolors?access_token=TOKEN<br> wxCard.basic.getColorList( function (err, colors) {      // colors 的格式: [{name: 'Color010', value: '#55bd47' }, ...] });

    2. use_custom_code： 这个字段用来标明该卡券是否使用自定义CODE。这里我们先提前介绍下Code，我们创建一类卡券，比如我们创建了折扣券，其中包含了100的库存量，即有100个用户可以领取，那么每个人领取到的就是一个Code，然后使用卡券，实质上是使用Code。use_custom_code默认值为false，即不使用自定义Code，当为false时， 每次领取卡券，微信会自动生成一个12位的数字作为Code。如果为true，那么我们在发放卡券的时候就需要自定义Code，这个我们在之后会详述。

    3. url_name_type： 这个字段不是必须的，他的作用是在卡券界面上添加一个自定义的CELL，和这个字段相配的是custom_url，这两个字段必须同时出现或者不出现。实现的效果是点击自定义Cell跳转到custom_url的链接。

    在添加卡券成功后，接口返回卡券的ID。

 

发放卡券

    在创建完成卡券之后，商户需要发放卡券让用户领取，微信目前提供的发放卡券形式有以下几种：(本文只列举微信公开接口，合作接口使用请自行参照文档)

    1. 二维码

    流程是商户可以通过微信提供的接口生成二维码的Ticket，然后使用Ticket生成二维码，用户通过微信扫描二维码进入卡券领取界面领取卡券。涉及到的接口有：

1 2 3 4 5

// 创建二维码Ticket https: //api.weixin.qq.com/card/qrcode/create?access_token=TOKEN   // 使用Ticket生成二维码 https: //mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET

    使用 wechat-card 生成二维码的步骤很简单，只需要一个步骤：

1 2 3

createCardQRCode( "qz_aAidkesdkncsn_AedfZek" ,  function (err, url) {