更新日志

版本号	更新内容	更新时间
V1.1	1.限制共享券代金券类型标题传入，统一命名为xxx元代金券，xxx为减免金额字段； 2.礼品券更名为兑换券，限制标题传入，统一命名为：洗手液(商品名)+1(数量)+瓶（数量单位），对应gift_name,gift_num,和gift_unit字段。	2015-12-2
V1.2	1.新增朋友的券白名单接口，支持领取共享未通过审核的共享券，仅限白名单list内用户可见。 2.新增朋友的券测试沙箱机制，未在开放类目内的开发者可以通过沙箱测试号测试创建、领取共享券 3.新增接口充值库存、券点系列接口，开发者可以通过接口完成库存、券点的充值和管理。 4.支持接口创建有门槛朋友的券，目前支持“满减券”、“指定品类券”和“不与其他优惠共享”类型门槛。	2015-12-27
V1.3	1.根据开发者填入的不同门槛，卡券标题拼接方案变更； 2.支持开发者填入使用时段限制，比如：周一 10：00-20:59可用；周一至周五 10：00-20:59可用	2016-2-16
V1.4	新创建的朋友的券只能在生效前提前5天投放，否则不可领取	2016-4-12

上传图片接口，开发者需调用接口上传商家图标LOGO至微信服务器，获取相应logo_url，用于卡券创建。

注意事项：

1.上传的图片限制文件大小限制1MB，支持JPG 格式。

2.调用接口获取的url 仅支持在微信相关业务下使用，否则会做相应处理。

3.此处必须上传微信服务器返回的图片链接，否则报错；

门店接口文档，获取门店 ID 后填入创建卡券接口中的相应字段 location_id_list，即可设置该卡券的适用门店。

选取卡券背景颜色接口文档，选择适用色值，让优惠券变得更加个性，在步骤四创建卡券中将颜色名（如Color010）填入color字段。

上传图片接口获得的url 是 code_type 卡券的code类型
"CODE_TYPE_TEXT"，文本；
"CODE_TYPE_BARCODE"，一维码；

"CODE_TYPE_QRCODE"，二维码；
"CODE_TYPE_ONLY_QRCODE",二维码无code显示； 
"CODE_TYPE_ONLY_BARCODE",一维码无code显示；
"CODE_TYPE_NONE"无code类型

是 brand_name 商家名字,上限为12个汉字 是 color 券颜色，请参考

选取卡券背景颜色接口文档                

是 notice 使用提醒，上限为12个汉字（一句话描述，展示在首页，示例：请出示二维码核销卡券） 是 description 使用说明。长文本描述，可以分行，上限为1000个汉字 是 date_info 使用日期，有效期的信息，仅支持DATE_TYPE_FIX_TIME_RANGE 是 begin_timestamp DATE_TYPE_FIX_TIME_RANGE时专用，表示起用时间。从1970年1月1日00:00:00至起用时间的秒数，最终需转换为字符串形态传入，下同。（单位为秒） 是 end_timestamp DATE_TYPE_FIX_TIME_RANGE表示结束时间。从1970年1月1日00:00:00至起用时间的秒数，最终需转换为字符串形态传入。（单位为秒） 是 location_id_list 门店位置ID，请参考微信门店接口文档，朋友的券须至少传入一个可用poi_id,否则报错 是 can_share 是否支持分享到对话、朋友圈，与share_friends字段互斥，若创建朋友共享券此处应填入false,不可为空 是 can_give_friend 是否支持赠送，与share_friends字段互斥，若创建朋友共享券此处应填入false,不可为空 是 service_phone 客服电话 否 get_limit 领取限制，限制用户扫码或点击H5领取的次数 否 center_title 居中置顶的url标题，一般为快速核销或者快速买单，用于跳转商户自己开发的核销或者买单页面，9个中文字符以内。该cell仅限卡券状态正常，且处于有效期内的时候显示。 否 center_sub_title 居中置顶的url副标题，显示在标题下方，12个中文字符以内。该标题仅限卡券状态正常，且处于有效期内的时候显示。 否 center_url 居中置顶的url，该url仅限卡券状态正常，且处于有效期内的时候显示。 否 custom_url_name 商家自定义入口名称，与custom_url字段共同使用，长度限制在5个汉字内 否 custom_url 商家自定义入口跳转外链的地址链接,跳转页面内容需与自定义cell名称保持匹配 否 custom_url_sub_title 显示在入口右侧的tips，长度限制在6个汉字内 否 promotion_url_name 营销场景的自定义入口 否 promotion_url 入口跳转外链的地址链接。 否 promotion_url_sub_title 显示在入口右侧的tips，长度限制在6个汉字内 否

Advanced_info（卡券高级信息）字段

新增门槛字段，代金券类型（CASH）的卡券可以与满减门槛（least_cost字段）、指定品类可用/不可用门槛（accept_category/reject_category）不与其他优惠共享门槛组合使用。

兑换券类型（GIFT）的卡券可以与满减门槛（least_cost字段）、买送门槛（object_use_for字段）和不与其他优惠共享门槛组合使用。

字段	说明	是否必填
advanced_info	创建优惠券特有的高级字段	是
use_condition	使用门槛（条件）字段	否
accept_category	指定可用的商品类目，仅用于代金券类型，填入后将在券面拼写适用于xxx，标题自动拼为xxx减50元（若仅填入5个字），50元代金券（填入5个字以上）。	否
reject_category	指定不可用的商品类目，仅用于代金券类型，填入后将在券面拼写不适用于xxx。	否
least_cost	满减门槛字段，可用于兑换券和代金券，填入后将在全面拼写消费满xx元可用，标题自动拼为满xx减xx/满xx送xx(gift_name)	否
object_use_for	购买xx可用类型门槛，仅用于兑换，填入后自动拼写购买xxx可用，标题自动拼为买xx送xx(gift_name)	否
can_use_with_other_discount	不可以与其他类型共享门槛，填写false时系统将在使用须知里拼写不可与其他优惠共享，默认为true	否
abstract	封面摘要结构体名称	是
abstract	封面摘要简介。	是
icon_url_list	封面图片列表，仅支持填入一个封面图片链接，上传图片接口上传获取图片获得链接，填写非CDN链接会报错，并在此填入。建议图片尺寸像素850*350	是
text_image_list	图文列表，显示在详情内页，优惠券券开发者须至少传入一组图文列表	是
image_url	图片链接，必须调用上传图片接口上传图片获得链接，并在此填入，否则报错	是
text	图文描述，5000字以内	是
business_service	商家服务类型： BIZ_SERVICE_DELIVER 外卖服务；BIZ_SERVICE_FREE_PARK 停车位；BIZ_SERVICE_WITH_PET 可带宠物；BIZ_SERVICE_FREE_WIFI 免费wifi，可多选	否
time_limit	使用时段限制	否
type	限制类型枚举值：支持填入 MONDAY 周一 TUESDAY 周二 WEDNESDAY 周三 THURSDAY 周四 FRIDAY 周五 SATURDAY 周六 SUNDAY 周日 HOLIDAY 假期通用 此处只控制显示，不控制实际使用逻辑，不填默认不显示	否
begin_hour	当前type类型下的起始时间（小时），如当前结构体内填写了MONDAY，此处填写了10，则此处表示周一 10:00可用	否
begin_minute	当前type类型下的起始时间（分钟），如当前结构体内填写了MONDAY，begin_hour填写10，此处填写了59，则此处表示周一 10:59可用	否
end_hour	当前type类型下的结束时间（小时），如当前结构体内填写了MONDAY，此处填写了20，则此处表示周一 10:00-20:00可用	否
end_minute	当前type类型下的结束时间（分钟），如当前结构体内填写了MONDAY，begin_hour填写10，此处填写了59，则此处表示周一 10:59-00:59可用	否
consume_share_self_num	核销后送券的数量，可设置核销后送本卡券的数量，限制传入1张，与consume_share_card_list字段互斥	否
consume_share_card_list	核销后赠送其他卡券的列表，与consume_share_self_num字段互斥	否
card_id	核销后赠送的其他卡券card_id，目前仅支持填入一个共享券card_id，此处必须填入共享券	否
num	核销后赠送的该card_id数目，目前仅支持填1	否
share_friends	是否支持分享给朋友使用，填写true优惠券才可被共享	是

注意事项：

1.门槛字段用于拼接标题以及券面的优惠说明，请开发者务必按照要求选择填写，以免造成不必要的麻烦。 

2.填入时间限制字段（time_limit）,只控制显示，不控制实际使用逻辑，不填默认不显示。

返回数据

{  "errcode": 0,  "errmsg": "ok",  "card_id": "pbLatjtQrAGz1Iaz08qB_H3NSBrc" }

字段说明

字段名	说明
错误码	错误码，0为正常，40071为格式错误，请对比JSON示例排查错误
errmsg	错误信息
card_id	卡券id

卡券事件推送机制

卡券全局错误码

什么是券点？）兑换，券点分为免费券点和付费券点，免费券点由微信平台赠送产生，而付费券点由开发者充值产生。

什么是券点？            

Wi-Fi和微信摇一摇摇一摇周边（iBeacon）

事件推送中会带上此自定义场景值。

注意事项：

1.若开发者填写了is_unique_code为true，需要保证卡券已审核通过并有库存，否则会报错。

返回数据

数据示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "ticket": "gQHB8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0JIV3lhX3psZmlvSDZmWGVMMTZvAAIEsNnKVQMEIAMAAA==",
    "expire_seconds": 1800,
    "url": "http://weixin.qq.com/q/BHWya_zlfioH6fXeL16o",
    "show_qrcode_url": " https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQH98DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0czVzRlSWpsamlyM2plWTNKVktvAAIE6SfgVQMEgDPhAQ%3D%3D"
}

参数名	描述
errcode	错误码
errmsg	错误信息
ticket	获取的二维码ticket，凭借此ticket调用通过ticket换取二维码接口可以在有效时间内换取二维码。
url	二维码图片解析后的地址，开发者可根据该地址自行生成需要的二维码图片
show_qrcode_url	二维码显示地址，点击后跳转二维码页面

判断用户客户端版本、批量添加卡券接口。

微信支付             45021 赠券规则列表长度高于10个 减少赠券规则列表的个数 47001 创建JSON结构错误 针对报错信息提示的位置对比示例排查

更多错误码，请见卡券全局错误码

调起适用于门店的卡券列表并获取用户选择列表JS SDK

卡券核销事件推送

当用户使用优惠券后，商家可通过JS SDK再次赠送一张卡券。https://res.wx.qq.com/open/js/jweixin-1.1.0.js

详情请见核销后再次赠送卡券接口

帮助

错误码

错误码	说明	排错指引
40003	Invalid opened，缺少openid	核销时用户的卡券未处于展示（mark）状态，朋友的券规定，券必须处于展示（mark）状态时，才允许被核销
40056	无效code	Code尚未被领取
40075	错误的encrypt码	请检查加密码是否拼写正确，请检查在url中取出encrypt_code（加密code）在post之前是否做过urlencode
40078	该Code已经被删除或者转赠中	建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销
40079	卡券过期	建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销
40099	Code已经被核销	建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销
40127	该Code已经被删除、置为失效或者转赠成功	建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销

更多错误码，请见卡券全局错误码

常见问题

1、为什么JSSDK拉起卡券列表中没有卡券？

A:JSSDK拉不起卡券一般为签名错误和筛选条件错误，两种情况。 签名错误是指卡券签名错误，建议用http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=cardsign调试 筛选条件错误是指shopid/cardid/和cardtype传参有误，比如传入了cash类型的cardtype,但是实际上用户卡包中无此类型卡券。

2、为什么要调用mark住接口？

A：由于朋友的券会出现在不同的用户列表中，所以在同一时刻可能有多个用户同时进入开发者开发的核销页面或者下单、支付页面，会出现用户付款但是没有成功核销卡券的情况，所以我们约定必须在卡券核销之前调用mark住接口将code与当前的openid锁定。 其本质是将code与当前使用者锁定的一个锁、 比如快速买单和商城下单的场景可以在支付前调用mark接口，如果mark失败则停止支付，而开发了自主核销页面的开发者可以选择在核销之前mark住code，从而避免冲突的发生。

朋友的券管理接口

更新朋友的券信息接口

接口说明

创建朋友的券成功之后开发者可调用该接口更改卡券信息，某些需要修改后送审的字段开发者需慎重处理

开发者注意事项

1. 更改卡券的部分字段后会重新提交审核，详情见字段说明，更新成功后可通过调用查看卡券详情接口核查更新结果；

2. 仅填入需要更新的字段，许多开发者在调用该接口时会填入brandname（品牌名称）等不支持修改的字段，导致更新不成功。

3. 调用该接口后更改卡券信息后，请务必调用查看卡券详情接口验证是否已成功更改。

接口调用请求说明

http请求方式: POST https://api.weixin.qq.com/card/update?access_token=TOKEN

参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
POST数据	是	JSON数据

POST示例

{
    "card_id": "pbLatjgOY1_Cxi3mnWBThtG90HGg",
    "cash": {
        "base_info": {
            "code_type": "CODE_TYPE_TEXT",
            "color": "Color010",
            "service_phone": "020-88888888",
            "description": "不可与其他优惠同享如需团购券发票，请在消费时向商户提出",
            "can_share": false,
            "can_give_friend": false,
            "location_id_list": [
                272981040,
                400183234
            ],
            "custom_url_name": "立即使用",
            "custom_url": "http://www.qq.com ",
            "custom_url_sub_title": "6个汉字tips",
            "promotion_url_name": "更多优惠",
            "promotion_url": "http://www.qq.com"
        },
        "advanced_info": {
            "time_limit": [
                {
                    "type": "MONDAY"
                },
                {
                    "type": "HOLIDAY"
                }
            ],
            "text_image_list": [
                {
                    "image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0",
                    "text": "此菜品精选食材，以独特的烹饪方法，最大程度地刺激食客的味蕾"
                },
                {
                    "image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0",
                    "text": "此菜品迎合大众口味，老少皆宜，营养均衡"
                }
            ],
            "business_service": [
                "BIZ_SERVICE_FREE_WIFI",
                "BIZ_SERVICE_WITH_PET",
                "BIZ_SERVICE_FREE_PARK",
                "BIZ_SERVICE_DELIVER"
            ],
            "consume_share_card_list": [
                {
                    "card_id": "pbLatjpvp0Xq6jtgRRxCKtudkBz8k",
                    "num": 1
                }
            ],
            "consume_share_self_num": 0,
            "abstract": {
                "abstract": "微信餐厅推出多种新季菜品，期待您的光临",
                "icon_url_list": [
                    "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0"
                ]
            }
        }
    }
}

字段说明

Base_info（卡券基础信息）字段修改：

参数名	是否提审	类型	示例值	描述
base_info	-	JSON结构		卡券基础信息字段。
logo_url	是	string(128)	http://mmbiz.qpic.cn/	卡券的商户logo，建议像素为300*300。
notice	是	string（48）	请出示二维码核销卡券。	使用提醒，字数上限为16个汉字。
description	是	string（3072）	不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食。	使用说明。
service_phone	否	string（24）	40012234	客服电话。
color	是	string（3072）	Color010	卡券颜色。
location_id_list	否	string（3072）	1234,2314	支持更新适用门店列表。
center_title	否	string（18）	快速使用	顶部居中的自定义cell。
center_sub_title	否	string（24）	点击快速核销卡券	顶部居中的自定义cell说明。
center_url	否	string（128）	www.qq.com	顶部居中的自定义cell的跳转链接。
location_id_list	否	string（3072）	1234,2314	支持更新适用门店列表。
custom_url_name	否	string（16）	立即使用	自定义跳转入口的名字。
custom_url	否	string（128）	www.qq.com	自定义跳转的URL。
custom_url_sub_title	否	string（18）	更多惊喜	显示在入口右侧的提示语。
promotion_url_name	否	string（16）	产品介绍。	营销场景的自定义入口名称。
promotion_url	否	string（128）	www.qq.com；	入口跳转外链的地址链接。
promotion_url_sub_title	否	string（18）	卖场大优惠。	显示在营销入口右侧的提示语。
code_type	否	string（16）	CODE_TYPE_TEXT。	Code码展示类型，"CODE_TYPE_TEXT"，文本；"CODE_TYPE_BARCODE"，一维码 ；"CODE_TYPE_QRCODE"，二维码；"CODE_TYPE_ONLY_QRCODE",二维码无code显示；"CODE_TYPE_ONLY_BARCODE",一维码无code显示；"CODE_TYPE_NONE"，无code类型
get_limit	否	int	1	每人可领券的数量限制。
can_share	否	bool	false	卡券原生领取页面是否可分享。
can_give_friend	否	bool	false	卡券是否可转赠。
date_info	否	Json结构	见上述示例	使用日期，有效期的信息，有效期时间修改仅支持有效区间的扩大。
type	否	string	DATE_TYPE_FIX_TIME_RANGE	有效期类型，仅支持更改type为DATE_TYPE_FIX_TIME_RANGE 的时间戳。
begin_timestamp	否	unsigned int	14300000	固定日期区间专用，表示起用时间。（单位为秒）
end_timestamp	否	unsigned int	15300000	固定日期区间专用，表示结束时间。最长可将卡券有效期延长至三个月。

Advanced_info（卡券高级信息）字段修改：

特别注意，以下支持更新的字段不在基本信息base_info的结构中。

参数名	是否提审	类型	示例值	描述
advanced_info	是	JSON结构
abstract	否	JSON结构	优惠详情摘要字段。
abstract	否	string(60)	简介。	本券限领一张，不能与其他优惠共同使用。
icon_url_list	否	string(3072)	图片列表，仅支持填入一个封面图片链接，上传图片接口上传获取图片获得链接，填写非CDN链接会报错，并在此填入。建议图片尺寸像素900*375	http://mmbiz.qpic.cn/mmbiz/xxxxx
text_image_list	否	string(3072)	图文列表，显示在详情内页，优惠券券开发者须至少传入一组图文列表
image_url	否	string(3072)	图片链接，必须调用上传图片接口上传图片获得链接，并在此填入，否则报错	http://mmbiz.qpic.cn/mmbiz/xxxxx
text	否	string(3072)	图文描述，5000字以内	一般为商品详情介绍
business_service	否	string(24)	商家服务类型 可多选,此处仅控制展示，不填则不显示	BIZ_SERVICE_DELIVER 外卖服务；BIZ_SERVICE_FREE_PARK 停车位；BIZ_SERVICE_WITH_PET 可带宠物；BIZ_SERVICE_FREE_WIFI 免费Wi-Fi
time_limit	是	string(24)	使用时段限制
type	是	string（24）	MONDAY 周一 TUESDAY 周二 WEDNESDAY 周三 THURSDAY 周四 FRIDAY 周五 SATURDAY 周六 SUNDAY 周日 HOLIDAY 假期通用	限制类型，可多选,此处仅控制展示，不填则不显示
consume_share_self_num	是	int	核销后送券的数量，可设置核销后送本券的数量，限制传入1张，与consume_share_card_list互斥	1
consume_share_card_list	是	JSON	核销后赠送其他卡券的列表
card_id	是	string（24）	pbLatjhvf1xBtaOIhYOCnp7Wv4DA	核销后赠送的其他卡券card_id，目前仅支持填入一个共享券card_id，注意此处必须填入共享券
num	是	unsigned int	1	核销后赠送的该card_id数目，目前仅支持填1

返回数据说明

数据示例：

{"errcode":0, "errmsg":"ok", "send_check":false}

参数名	描述
errcode	错误码，0为正常。
errmsg	错误信息。
send_check	是否提交审核，false为修改后不会重新提审，true为修改字段后重新提审，该卡券的状态变为审核中。

拉取朋友的券数据接口

接口简介及开发注意事项

为支持开发者调用API查看卡券相关数据，微信卡券团队封装数据接口并面向具备卡券功能权限的开发者开放使用。开发者调用该接口可获取本商户下的所有卡券相关的总数据以及指定卡券的相关数据。

拉取卡券概况数据接口

接口说明

支持调用该接口拉取本商户的总体数据情况，包括时间区间内的各指标总量。

接口调用请求说明

http请求方式: POST https://api.weixin.qq.com/datacube/getcardbizuininfo?access_token=ACCESS_TOKEN

请求参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
POST数据	是	Json数据

POST数据

{
    "begin_date": "2015-06-15",
    //请开发者按示例格式填写日期，否则会报错dateformaterror"end_date": "2015-06-30",
    "cond_source": 0
}

参数说明：

字段	说明	是否必填	类型	示例值
begin_date	查询数据的起始时间。	是	string(16)	2015-06-15
end_date	查询数据的截至时间。	是	string(16)	2015-06-30
cond_source	卡券来源，0为公众平台创建的卡券数据、1是API创建的卡券数据	是	unsigned int	0

返回数据说明 数据示例：

{
    "list": [
        {
            "ref_date": "2015-06-23",
            "view_cnt": 1,
            "view_user": 1,
            "receive_cnt": 1,
            "receive_user": 1,
            "verify_cnt": 0,
            "verify_user": 0,
            "given_cnt": 0,
            "given_user": 0,
            "expire_cnt": 0,
            "expire_user": 0
        }
    ]
}

字段说明：

字段	说明
ref_date	日期信息
view_cnt	浏览次数
view_user	浏览人数
receive_cnt	领取次数
receive_user	领取人数
verify_cnt	使用次数
verify_user	使用人数
given_cnt	转赠次数
given_user	转赠人数
expire_cnt	过期次数
expire_user	过期人数

注意：

1. 查询时间区间需<=62天，否则报错{errcode: 61501，errmsg: "date range error"}；

2. 传入时间格式需严格参照示例填写”2015-06-15”，否则报错{errcode":61500,"errmsg":"date format error"}

获取朋友的券数据接口

接口说明

支持开发者调用该接口拉取朋友的券在固定时间区间内的相关数据。

接口调用请求说明

http请求方式: POST https://api.weixin.qq.com/datacube/getcardcardinfo?access_token=ACCESS_TOKEN

请求参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
POST数据	是	Json数据

POST数据

{
    "begin_date": "2015-06-15",
    "end_date": "2015-06-30",
    "cond_source": 0,
    "card_id": "po8pktyDLmakNY2fn2VyhkiEPqGE"
}

参数说明：

字段	说明	是否必填	类型	示例值
begin_date	查询数据的起始时间。	是	string(16)	2015-06-15
end_date	查询数据的截至时间。	是	string(16)	2015-06-30
cond_source	卡券来源，0为公众平台创建的卡券数据、1是API创建的卡券数据	是	unsigned int	0
card_id	卡券ID。填写后，指定拉出该卡券的相关数据。	否	string(32)	po8pktyDLmakNY2fn2VyhkiEPqGE

返回数据说明 数据示例：

{
    "list": [
        {
            "ref_date": "2015-06-23",
            "card_id": "po8pktyDLmakNY2fn2VyhkiEPqGE",
            "card_type": 3,
            "view_cnt": 1,
            "view_user": 1,
            "receive_cnt": 1,
            "receive_user": 1,
            "verify_cnt": 0,
            "verify_user": 0,
            "given_cnt": 0,
            "given_user": 0,
            "expire_cnt": 0,
            "expire_user": 0
        }
    ]
}

字段说明：

字段	说明
ref_date	日期信息
card_id	卡券ID
card_type	cardtype:0：折扣券，1：代金券，2：礼品券，3：优惠券，4：团购券（暂不支持拉取特殊票券类型数据，电影票、飞机票、会议门票、景区门票）
view_cnt	浏览次数
view_user	浏览人数
receive_cnt	领取次数
receive_user	领取人数
verify_cnt	使用次数
verify_user	使用人数
given_cnt	转赠次数
given_user	转赠人数
expire_cnt	过期次数
expire_user	过期人数

注意：

1. 查询时间区间需<=62天，否则报错{"errcode:" 61501，errmsg: "date range error"}；

2. 传入时间格式需严格参照示例填写如”2015-06-15”，否则报错｛"errcode":"date format error"｝

我是第三方开发者/服务商

朋友的券目前率先开通了MP流程，同样支持接口创建朋友的券。目前第三方/服务商可以利用现有能力帮助没有开发能力的商户创建、投放并核销朋友的券，并管理朋友的券数据。

第三方/服务商可以通过以下流程完成朋友的券基本流程：

1、第三方/服务商须登录微信开放平台申请成为公众号第三方平台，并全网发布。
2、商户通过公众号授权将公众账号的卡券权限集授权给第三方代调用接口。
3、开发者根据垂直行业特点，帮助商户完成创建朋友的券、投放朋友的券、 接口兑换库存、充值券点、核销朋友的券并完成朋友的券数据管理。
4、对于有能力的开发者可以融合第三方授权授权和第三方协助制券等模式搭建自己的 卡券平台供子商户使用。

交流反馈

朋友的券开发者可以加入开发者交流五群、六群（QQ群）：512568283、205482166，若开发过程中遇到问题，也可以发送邮件到weixin_card@foxmail.com 反馈。