創建卡券接口是微信卡券的基礎接口,用於創建一類新的卡券,獲取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 優惠券