创建卡券接口是微信卡券的基础接口,用于创建一类新的卡券,获取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 优惠券