1  须知

   阅读卡券部分接口文档，请务必阅读微信公众平台开发者通用说明文档《微信开发者规范》和《微信公众号接口权限说明》两个章节，以获知微信公众平台接口的基本调用方法、开发者规范以及调用过程中异常问题的处理。

2 接口测试号申请 通过微信扫一扫获得一个全新的appid(已拥有卡券创建权限，包括朋友的券)和appsecret用于卡券接口调用。

注意：该appid创建的卡券不会被审核通过，仅限于小范围测试，开发者不可用于其他用途。

http://mp.weixin.qq.com/debug/

接口类型：基础支持

接口列表：获取access_token接口

注意事项：参数填写开发者的appid和secret

点击检查问题，即可返回access_token，access_token的有效期是两小时，两小时之后须重新获取

步骤二 上传卡券logo

页面地址：http://mp.weixin.qq.com/debug/

接口类型：基础支持

接口列表：上传图片素材接口

access_token: 上一步获得的access_token

buffer：你选择的图片

点击检查问题，即可获取图片url，在下一步创建卡劵的参数中需要

步骤三 创建卡券

页面地址：http://mp.weixin.qq.com/debug/

接口类型：卡劵接口

接口列表：创建卡劵接口

access_token:第一步获得的access_token

JSON示例：

{ 
"card": {
  "card_type": "GROUPON",
  "groupon": {
      "base_info": {
          "logo_url": 
"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmx ibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
          "brand_name":"微信餐厅",
          "code_type":"CODE_TYPE_TEXT",
          "title": "132元双人火锅套餐",
          "sub_title": "周末狂欢必备",
          "color": "Color010",
          "notice": "使用时向服务员出示此券",
          "service_phone": "020-88888888",
          "description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食",
          "date_info": {
              "type": "DATE_TYPE_FIX_TERM",
              "fixed_term": 15 ,
              "fixed_begin_term": 0
          },
          "sku": {
              "quantity": 500000
          },
          "get_limit": 3,
          "use_custom_code": false,
          "bind_openid": false,
          "can_share": true,
        "can_give_friend": true,
          "location_id_list" : [123, 12321, 345345],
          "custom_url_name": "立即使用",
          "custom_url": "http://www.qq.com",
          "custom_url_sub_title": "6个汉字tips",
          "promotion_url_name": "更多优惠",
        "promotion_url": "http://www.qq.com"
      },
      "deal_detail": "以下锅底2选1（有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸 菜鱼锅可选）：\n大锅1份 12元\n小锅2份 16元 "}
}
}

注意事项：date_info中用的是Unix时间戳，注意把begin_timestamp修改小于当前时间，end_timestamp修改成今天之后的时间，这样在后面核销卡劵测试才能成功

接口地址：创建卡券接口

步骤四 创建二维码投放

页面地址：http://mp.weixin.qq.com/debug/

接口类型：卡劵接口

接口列表：创建二维码ticket接口

access_token：第一步获得的access_token

JSON示例：

{
"action_name": "QR_CARD", 
"action_info": {
"card": {
"card_id": "po_2DjgJ2zrboM6SzK3qNuje5iWQ", 
   }
 }
}

接口地址：创建二维码接口

步骤五 显示二维码

在上一步的返回中点击字段show_qrcode_url字段中的链接，即可显示卡券领取二维码。

示例：https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQEr8ToAAAAAAAAAASxodHRwOi8vd2V********NjRjVuAAIE3kqwVQMEgDPhAQ==

打开微信扫一扫，然后领取卡劵，如果显示卡劵未通过审核，那么需要下一步设置测试白名单，如果可以领取就忽略第六步。

可扫描以下二维码体验微信卡券：

步骤六 设置测试白名单

页面地址：http://mp.weixin.qq.com/debug/

接口类型：卡劵接口

接口列表：设置测试白名单接口

access_token：第一步获得的access_token

JSON示例：

{ "username":["usr1","usr2"] }

注意事项：其中usr1，sur2是领取卡劵的微信号

接口地址：设置白名单接口

步骤七 核销卡劵

页面地址：http://mp.weixin.qq.com/debug/

接口类型：卡劵接口

接口列表：核销卡劵接口

access_token：第一步获得的access_token

JSON示例：

{ "code"："759733467744" }

注意事项：仅支持审核通过且在有效期内的卡劵 接口地址：核销接口

获取access_token接口获取,开发者需妥善保存并建立缓存机制。

jsapi_ticket 调用微信内网页调用微信原生功能的JS-SDK接口须使用的签名票据，详情见:JS-SDK部分

api_ticket

调用微信卡券接口时签名的临时票据，有效时间为7200s，

7200s内重复请求保持不变，获取api_ticket接口获取。

card_ext

可扩张卡券的附加信息，用于投放卡券是附带卡券基本信息。

outer_id

领券渠道的场景值。支持商户自定义场景值填入card_ext进行卡券投放，

当用户领取时会将相应场景值通过事件通知商户。

事件推送

在卡券通过审核、卡券被领取、卡券被删除、卡券被核销时，

均会推送事件通知开发者，接收地址为公众平台开发者中心填写的服务器URL。

自定义入口

通过API创建卡券支持商户自定义卡券详情页跳转外链的单元。

解码接口获取真实Code码。 假如指定的url为http://www.qq.com，用户点击时，跳转的url则为： http://www.qq.com?encrypt_code=ENCRYPT_CODE&card_id=CARDID&openid=xxxx&outer_str=xxxxx

卡券接口资料包：

- 创建&签名工具SDK；

- 卡券接口调用流程图；

- 新增接口特性说明；

- SDK for Android；

- SDK for iOS；