创建卡券接口是微信卡券的基础接口,用于创建一类新的卡券,获取card_id。创建成功并通过审核后,商家可以通过文档提供的其他接口将卡券下发给用户,每次成功领取,库存数量会相应扣除。
创建卡券的接口如下。
https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
创建卡券时,POST数据示例如下。
{
"card":{
"card_type":"GROUPON",
"groupon":{
"base_info":{
"logo_url":"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaH
qkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
"brand_name":"微信餐厅",
"code_type":"CODE_TYPE_TEXT",
"title":"132元双人火锅套餐",
"color":"Color010",
"notice":"使用时向服务员出示此券",
"service_phone":"020-88888888",
"description":"不可与其他优惠同享 如需团购券发票,请在消费时向商户提出店内均
可使用,仅限堂食",
"date_info":{
"type":"DATE_TYPE_FIX_TIME_RANGE",
"begin_timestamp":1397577600,
"end_timestamp":1472724261
},
"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
],
"center_title":"顶部居中按钮",
"center_sub_title":"按钮下方的wording",
"center_url":"www.qq.com",
"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":"大众点评"
},
"advanced_info":{
"use_condition":{
"accept_category":"鞋类",
"reject_category":"阿迪达斯",
"can_use_with_other_discount":true
},
"abstract":{
"abstract":"微信餐厅推出多种新季菜品,期待您的光临",
"icon_url_list":[
"http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz
1bjiaoOYA027iasqSG0sj piby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0"
]
},
"text_image_list":[
{
"image_url":"http:// mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn
97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6Ijl
kY9YnDsfw/0",
"text":"此菜品精选食材,以独特的烹饪方法,最大程度地刺激食客的味蕾"
},
{
"image_url":"http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn
97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj piby4vce3AtaPu6cIhBHkt6Ijl
kY9YnDsfw/0",
"text":"此菜品迎合大众口味,老少皆宜,营养均衡"
}
],
"time_limit":[
{
"type":"MONDAY",
"begin_hour":0,
"end_hour":10,
"begin_minute":10,
"end_minute":59
},
{
"type":"HOLIDAY"
}
],
"business_service":[
"BIZ_SERVICE_FREE_WIFI",
"BIZ_SERVICE_WITH_PET",
"BIZ_SERVICE_FREE_PARK",
"BIZ_SERVICE_DELIVER"
]
},
"deal_detail":"以下锅底2选1(有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸菜鱼
锅可选): 大锅1份 12元 小锅2份 16元 "
}
}
}
上述数据可以分为两个部分,即base_info(卡券基础信息)和Advanced_info(卡券高级信息)。
其中,基础信息的参数说明如表16-4所示。
表16-4 基础信息的参数说明
高级信息的参数说明如表16-5所示。
表16-5 高级信息的参数说明
正确创建时,返回的数据示例如下。
{
"errcode":0,
"errmsg":"ok",
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
上述数据的参数说明如表16-6所示。
表16-6 创建卡券接口返回参数说明
图16-1至图16-5分别展示了团购券、代金券、折扣券、兑换券(礼品券)、优惠券等的效果图。
图16-1 团购券
图16-2 代金券
图16-3 折扣券
图16-4 兑换券
图16-5 优惠券