微信平台开发者创建卡券
ess_token是调用接口凭证请求数据调用示例(使用curl命令,用FORM表单方式上传一个图片):curl –Fbuffer=@test.jpg 返回数据返回正确的示例:{"url":"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0"}返回错误的示例{"errcode":40009,"errmsg":"invalid image size"} 参数说明参数名描述errcode错误码errmsg错误信息url商户图片url,用于创建卡券接口中填入。特别注意:该链接仅用于微信相关业务,不支持引用。2.4 步骤二:设置卡券适用门店请点击查看微信门店接口文档,获取门店 ID 后填入创建卡券接口中的相应字段 location_id_list,即可设置该卡券的适用门店。2.5 步骤三:选取卡券背景颜色选择适用色值,在步骤四:创建卡券中将颜色名(如Color010)填入color字段。目前微信提供包括以上十种色值的共计十四种色值供开发者使用。背景颜色名称色值Color010#63b359Color020#2c9f67Color030#509fc9Color040#5885cfColor050#9062c0Color060#d09a45Color070#e4b138Color080#ee903cColor081#f08500Color082#a9d92dColor090#dd6549Color100#cc463dColor101#cf3e36Color102#5E66712.6 步骤四:创建卡券创建卡券接口是微信卡券的基础接口,用于创建一类新的卡券,获取card_id,创建成功并通过审核后,商家可以通过文档提供的其他接口将卡券下发给用户,每次成功领取,库存数量相应扣除。开发者须知1.需自定义Code码的商家必须在创建卡券时候,设定use_custom_code为true,且在调用投放卡券接口时填入指定的Code码。指定OpenID同理。特别注意:在公众平台创建的卡券均为非自定义Code类型。2.can_share字段指领取卡券原生页面是否可分享,建议指定Code码、指定OpenID等强限制条件的卡券填写false。3.特别注意:编码方式仅支持使用UTF-8,否则会报错。4.创建成功后该卡券会自动提交审核,审核结果将通过事件通知商户。开发者可调用设置白名单接口设置用户白名单,领取未通过审核的卡券,测试整个卡券的使用流程。接口调用请求说明HTTP请求方式: POSTURL: https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN参数说明参数是否必须说明access_token是调用接口凭证POST数据是Json数据POST数据示例{ "card": { "card_type": "GROUPON", "groupon": { "base_info": { "logo_url": "http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0", "brand_name": "微信餐厅", "code_type": "CODE_TYPE_TEXT", "title": "132元双人火锅套餐", "color": "Color010", "notice": "使用时向服务员出示此券", "service_phone": "020-88888888", "description": "不可与其他优惠同享\n如需团购券发票,请在消费时向商户提出\n店内均可使用,仅限堂食", "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/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj piby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0" ] }, "text_image_list": [ { "image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0", "text": "此菜品精选食材,以独特的烹饪方法,最大程度地刺激食 客的味蕾" }, { "image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj piby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/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(有菌王锅、麻辣锅、大骨锅、番茄锅、清补 凉锅、酸菜鱼锅可选):\n大锅1份 12元\n小锅2份 16元 " } }}字段示图 团购券参数名必填类型示例值描述card_type是string(24)GROUPON团购券类型。base_info是JSON结构见上述示例。基本的卡券数据,见下表,所有卡券类型通用。deal_detail是string(3072)双人套餐\n -进口红酒一支。\n孜然牛肉一份。团购券专用,团购详情。JSON示例{ "card": { "card_type": "GROUPON", "groupon": { "base_info": { ················ }, "advanced_info": { ················ }, "deal_detail": "示例" } }}代金券参数名必填类型示例值描述card_type是string(24)CASH代金券类型。base_info是JSON结构见上述示例。基本的卡券数据,见下表,所有卡券通用。least_cost是int10000代金券专用,表示起用金额(单位为分),如果无起用门槛则填0。reduce_cost是int10000代金券专用,表示减免金额。(单位为分)JSON示例{ "card": { "card_type": "CASH", "cash": { "base_info": { ················ }, "advanced_info": { ················ }, "least_cost": 1000, "reduce_cost": 100, } }}折扣券参数名必填类型示例值描述card_type是string(24)DISCOUNT折扣券类型。base_info是Json结构见上述示例。基本的卡券数据,见下表,所有卡券通用。discount是int30折扣券专用,表示打折额度(百分比)。填30就是七折。JSON示例
微信平台开发者创建卡券