微信平台投放卡券

由 如此轻盈 创建，Carrie 最后一次修改 2016-09-27 更新日志版本号更新内容更新时间V1.11.新增卡券货架创建接口，支持开发者调用接口创建卡券货架进行卡券投放2. 新增导入code接口，支持自定义code开发者通过导入code通过群发、客服等渠道 派发卡券2015-8-12V1.2新增扫描二维码批量领取接口，用户扫描二维码可以同时领取多张卡券2015-8-311 创建二维码接口开发者可调用该接口生成一张卡券二维码供用户扫码后添加卡券到卡包。自定义Code码的卡券调用接口时，POST数据中需指定code，非自定义code不需指定，指定openid同理。指定后的二维码只能被用户扫描领取一次。获取二维码ticket后，开发者可用通过ticket换取二维码接口。接口调用请求说明HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/qrcode/create?access_token=TOKEN参数说明参数是否必须说明POST数据是JSON数据access_token是调用接口凭证POST数据 开发者可以设置扫描二维码领取单张卡券，此时POST数据为： {"action_name": "QR_CARD", "expire_seconds": 1800,"action_info": {"card": {"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc", "code": "198374613512","openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA","is_unique_code": false ,"outer_str":"12b"  } }}当开发者设置扫描二维码领取多张卡券，此时POST数据为：{"action_name": "QR_MULTIPLE_CARD", "action_info": {"multiple_card": {"card_list": [{"card_id": "p1Pj9jgj3BcomSgtuW8B1wl-wo88","code":"2392583481","outer_str":"12b"}, {"card_id": "p1Pj9jgj3BcomSgtuW8B1wl-wo98","code":"2392583482","outer_str":"12b"}]}}}参数说明参数名必填类型示例值描述code是string(20)110201201245卡券Code码,use_custom_code字段为true的卡券必须填写，非自定义code和导入code模式的卡券不必填写。card_id否string(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc卡券ID。openid否string(32)oXch-jkrxp42VQu8ldweCwDt97qo指定领取者的openid，只有该用户能领取。bind_openid字段为true的卡券必须填写，非指定openid不必填写。expire_seconds否unsigned int60指定二维码的有效时间，范围是60 ~ 1800秒。不填默认为365天有效is_unique_code否boolfalse指定下发二维码，生成的二维码随机分配一个code，领取后不可再次扫描。填写true或false。默认false，注意填写该字段时，卡券须通过审核且库存不为0。outer_id否int12领取场景值，用于领取渠道的数据统计，默认值为0，字段类型为整型，长度限制为60位数字。用户领取卡券后触发的事件推送中会带上此自定义场景值。outer_str否string(128)13bouter_id字段升级版本，字符串类型，用户首次领卡时，会通过领取事件推送给商户；对于会员卡的二维码，用户每次扫码打开会员卡后点击任何url，会将该值拼入url中，方便开发者定位扫码来源返回数据{ "errcode": 0, "errmsg": "ok", "ticket":      "gQHB8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0JIV3lhX3psZmlvSDZmWGVMMTZvAAIEsNnKVQMEIAMAAA==",//获取ticket后需调用换取二维码接口获取二维码图片，详情见字段说明。 "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二维码显示地址，点击后跳转二维码页面注意事项：1.自定义code的卡券，生成的二维码每次只能领取一次，若开发者想要使用自己的串码系统并且想要用微信的二维码投放，须先将自定义code导入；2.领取多张的二维码一次最多填入5个card_id，否则报错。2 HTML5线上发券（JS-SDK接口）微信 JS-SDK 仅支持在微信内置浏览器中使用,其他浏览器调用无效。微信提供addCard接口供商户前端网页调用,用于将一张或多张卡券添加到用户卡包。详情见批量添加卡券接口。3 通过卡券货架投放卡券卡券货架简介卡券货架支持开发者通过调用接口生成一个卡券领取H5页面，并获取页面链接，进行卡券投放动作。 目前卡券货架仅支持非自定义code的卡券，自定义code的卡券需先调用导入code接口将code导入才能正常使用。3.1 创建货架接口接口说明开发者需调用该接口创建货架链接，用于卡券投放。创建货架时需填写投放路径的场景字段。接口调用请求说明HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/landingpage/create?access_token=$TOKEN请求参数说明参数是否必须说明access_token是调用接口凭证buffer是文件的数据流POST数据{  "banner":"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7h  icFN",   "page_title": "惠城优惠大派送",   "can_share": true,   "scene": "SCENE_NEAR_BY",   "card_list": [       {           "card_id": "pXch-jnOlGtbuWwIO2NDftZeynRE",           "thumb_url": "www.qq.com/a.jpg"       },       {           "card_id": "pXch-jnAN-ZBoRbiwgqBZ1RV60fI",           "thumb_url": "www.qq.com/b.jpg"       }   ]}参数说明字段说明是否必填banner页面的banner图片链接，须调用，建议尺寸为640*300。是title页面的title。是can_share页面是否可以分享,填入true/false是scene投放页面的场景值；SCENE_NEAR_BY 附近 SCENE_MENU自定义菜单 SCENE_QRCODE二维码 SCENE_ARTICLE公众号文章 SCENE_H5h5页面 SCENE_IVR自动回复 SCENE_CARD_CUSTOM_CELL卡券自定义cell是card_list卡券列表，每个item有两个字段是card_id所要在页面投放的card_id是thumb_url缩略图url是返回数据说明{     "errcode":0,     "errmsg":"ok",     "url":"www.test.url",     "page_id":1 }字段说明字段说明errcode错误码，0为正常。errmsg错误信息。url货架链接。page_id货架ID。货架的唯一标识。4 群发卡券请开发者特别注意，目前群发卡券接口仅支持投放非自定义Code码的卡券。自定义code码的商户若想使用该功能需调用导入code接口将自定义code先导入微信服务器。4.1 导入自定义code(仅对自定义code商户)