微信小店
微信门店
微信智能接口
微信设备功能

微信卡券接口说明

出自微信公众平台开发者文档
跳转到: 导航, 搜索

目录

卡券接口概述

微信公众平台本次增加了微信卡券功能,开放接口供商家使用。 支持开发者调用接口创建多种类型的卡券,通过下发消息、二维码、JS-SDK等方式进行投放,在用户使用时通过API接口或卡券商户助手完成核销。 同时支持接口获取统计数据,以及各个环节给予开发者事件推送。 接口调用流程图如下:

接口调用流程图.png

卡券测试沙箱机制

测试沙箱是一种测试账号生成机制,开发者可以登录接口测试号申请 通过微信扫一扫获得一个全新的appid(已拥有卡券(包括朋友的券)创建权限)和appsecret用于卡券接口调用,该appid创建的卡券不会被通过,仅限于小范围测试,开发者不可用于其他用途。

卡券HelloWorld

开发者须知

开发者可以通过debug工具,快速完成创建卡券、投放卡券和核销卡券的流程, 若要深入了解卡券接口,则需要对对应的部分的文档详细阅读。

获取access_token

debug页面获取

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

接口类型:基础支持

接口列表:获取access_token接口

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

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

接口地址:获取access_token接口

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

接口类型:基础支持

接口列表:上传logo接口

access_token: 上一步获得的access_token

buffer:你选择的图片

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

接口地址:上传Logo接口

创建卡券

debug页面创建

页面地址: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",
          "source": "大众点评"   
      },
      "deal_detail": "以下锅底2选1(有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸 菜鱼锅可选):\n大锅1份 12元\n小锅2份 16元 "}
}
}

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

接口地址:创建卡券接口

创建二维码投放

debug页面获取

页面地址: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=gQEr8ToAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xLy1YV21CQi1sc3dUS0p1M3NjRjVuAAIE3kqwVQMEgDPhAQ==

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

设置测试白名单

debug页面获取

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

接口类型:卡劵接口

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

access_token:第一步获得的access_token

json示例:

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

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

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

核销卡劵

debug页面获取

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

接口类型:卡劵接口

接口列表:核销卡劵接口

access_token:第一步获得的access_token

json: 示例:

{ "code":"759733467744" }

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


开发者注意事项

微信版本判断

由于微信6.0.2版本后才支持卡券功能模块,低版本用户调用JS-SDK无效。因此,微信团队建议商户通过user agent来确定用户当前的版本号后再调用添加至卡包JS-SDK接口。以iPhone版本为例,可以通过user agent可获取如下版本示例信息:

"Mozilla/5.0(iphone;CPU iphone OS 5_1_1 like Mac OS X)     
AppleWebKit/534.46(KHTML,like Geocko)Mobile/9B206 MicroMessenger/6.0.2 "

其中6.0.2为用户安装的微信版本号。商户可以判定版本号是否高于或者等于6.0.2。

卡券投放限制

公众号会话环境内仅支持调起该公众号域名下的卡券。未经平台允许不支持在公众号会话内推送其他商户的卡券,公众号会话外(如朋友圈、对话环境)无此限制。

特别注意事项

公众号的对话框中发生的行为以及从公众号对话框跳转的网页链接均处于该公众号的会话环境内。

编码规则

所有API接口POST的数据只支持utf8编码,否则会返回报错。

联系我们

遇到卡券开发问题,可以通过邮箱weixin_card@foxmail.com 联系我们。也可以加入开发者QQ交流群 512568283,验证请务必说明商家名及业务。

卡券术语介绍

以下是卡券开发过程中需要了解的关键概念:

参数名 描述
cardid 卡券ID。一个卡券ID对应一类卡券,包含了相应库存数量的Code码。
code 卡券Code码。一张卡券的唯一标识,核销卡券时使用此串码,支持商户自定义。
openid 用户在该公众号下的唯一身份。
access_token 调用接口的凭证,有效时间为7200s,通过获取access_token接口获取。
api_ticket 调用微信卡券接口时签名的临时票据,通过获取api_ticket接口获取。
card_ext 可扩张卡券的附加信息。
outer_id 领券渠道的场景值。支持商户自定义场景值填入card_ext进行卡券投放,当用户领取时会将相应场景值通过事件通知商户。
事件推送 卡券通过审核、卡券被领取、卡券被删除、卡券被核销时,均会推送事件通知开发者,接收地址为公众平台开发者中心填写的服务器URL。
自定义入口 通过API创建卡券支持商户自定义卡券详情页跳转外链的单元。

卡券资料包下载

开发者可下载卡券接口资料包


- 创建&签名工具SDK;

- 卡券接口调用流程图;

- 新增接口特性说明;

- SDK for Android;

- SDK for iOS;