- ·上一篇文章:微信平台会员卡专区(二)
- ·下一篇文章:微信特殊票券
微信优惠券 朋友的券专区
code是string(20)1231231需核销的Code码。返回数据数据示例:{ "errcode": 0, "errmsg": "ok", "card": { "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc" }, "openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA"}参数名描述errcode错误码。errmsg错误信息。openid用户在该公众号内的唯一身份标识。card_id卡券ID。线上核销Code接口线上核销code接口与普通的核销code接口不同,开发者须传入当前使用该卡券顾客的openid才可以核销。接口调用请求说明http请求方式: POST https://api.weixin.qq.com/card/code/consume?access_token=TOKEN参数说明参数是否必须说明POST数据是Json数据access_token是调用接口凭证POST数据{"code": "12312313", "openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA" }参数名必填类型示例值描述code是string(20)1231231需核销的Code码。openid是string(20)oFS7Fjl0WsZ9AMZqrI80nbIq8xrA当前卡券使用者的openid,通常通过网页授权登录或自定义url跳转参数获得。返回数据数据示例: {"errcode":0,"errmsg":"ok","card":{"card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc"},"openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA"}参数名描述errcode错误码。errmsg错误信息。openid用户在该公众号内的唯一身份标识。card_id卡券ID。注意:1.只有在线上核销的场景时,调用核销接口才需要传openid参数; 2.线下核销的场景下,核销接口传递的参数仅为code,无需openid;核销事件推送卡券被核销时,微信会把这个事件推送到开发者填写的URL。 点击查看卡券核销事件推送当用户使用优惠券后,商家可通过JS SDK再次赠送一张卡券。核销后再次赠送卡券接口(JS SDK)该接口仅限6.3.6以上版本客户端使用,且须配置1.1.0的js文件https://res.wx.qq.com/open/js/jweixin-1.1.0.js详情请见核销后再次赠送卡券接口帮助错误码错误码说明排错指引40003Invalid opened,缺少openid核销时用户的卡券未处于展示(mark)状态,朋友的券规定,券必须处于展示(mark)状态时,才允许被核销40056无效codeCode尚未被领取40075错误的encrypt码请检查加密码是否拼写正确,请检查在url中取出encrypt_code(加密code)在post之前是否做过urlencode40078该Code已经被删除或者转赠中建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销40079卡券过期建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销40099Code已经被核销建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销40127该Code已经被删除、置为失效或者转赠成功建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销更多错误码,请见卡券全局错误码常见问题1、为什么JSSDK拉起卡券列表中没有卡券?A:JSSDK拉不起卡券一般为签名错误和筛选条件错误,两种情况。 签名错误是指卡券签名错误,建议用http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=cardsign调试 筛选条件错误是指shopid/cardid/和cardtype传参有误,比如传入了cash类型的cardtype,但是实际上用户卡包中无此类型卡券。2、为什么要调用mark住接口?A:由于朋友的券会出现在不同的用户列表中,所以在同一时刻可能有多个用户同时进入开发者开发的核销页面或者下单、支付页面,会出现用户付款但是没有成功核销卡券的情况,所以我们约定必须在卡券核销之前调用mark住接口将code与当前的openid锁定。 其本质是将code与当前使用者锁定的一个锁、 比如快速买单和商城下单的场景可以在支付前调用mark接口,如果mark失败则停止支付,而开发了自主核销页面的开发者可以选择在核销之前mark住code,从而避免冲突的发生。朋友的券管理接口更新朋友的券信息接口接口说明创建朋友的券成功之后开发者可调用该接口更改卡券信息,某些需要修改后送审的字段开发者需慎重处理开发者注意事项1. 更改卡券的部分字段后会重新提交审核,详情见字段说明,更新成功后可通过调用查看卡券详情接口核查更新结果;2. 仅填入需要更新的字段,许多开发者在调用该接口时会填入brandname(品牌名称)等不支持修改的字段,导致更新不成功。3. 调用该接口后更改卡券信息后,请务必调用查看卡券详情接口验证是否已成功更改。接口调用请求说明http请求方式: POST https://api.weixin.qq.com/card/update?access_token=TOKEN参数说明参数是否必须说明access_token是调用接口凭证POST数据是JSON数据POST示例{ "card_id": "pbLatjgOY1_Cxi3mnWBThtG90HGg", "cash": { "base_info": { "code_type": "CODE_TYPE_TEXT", "color": "Color010", "service_phone": "020-88888888", "description": "不可与其他优惠同享如需团购券发票,请在消费时向商户提出", "can_share": false, "can_give_friend": false, "location_id_list": [ 272981040, 400183234 ], "custom_url_name": "立即使用", "custom_url": "http://www.qq.com ", "custom_url_sub_title": "6个汉字tips", "promotion_url_name": "更多优惠", "promotion_url": "http://www.qq.com" }, "advanced_info": { "time_limit": [ { "type": "MONDAY" }, { "type": "HOLIDAY" } ], "text_image_list": [ { "image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0", "text": "此菜品精选食材,以独特的烹饪方法,最大程度地刺激食客的味蕾" }, { "image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0", "text": "此菜品迎合大众口味,老少皆宜,营养均衡" } ], "business_service": [ "BIZ_SERVICE_FREE_WIFI", "BIZ_SERVICE_WITH_PET", "BIZ_SERVICE_FREE_PARK", "BIZ_SERVICE_DELIVER" ], "consume_share_card_list": [ { "card_id": "pbLatjpvp0Xq6jtgRRxCKtudkBz8k", "num": 1 } ], "consume_share_self_num": 0, "abstract": { "abstract": "微信餐厅推出多种新季菜品,期待您的光临", "icon_url_list": [ "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0" ] } } }}字段说明Base_info(卡券基础信息)字段修改:参数名是否提审类型示例值描述base_info-JSO
微信优惠券 朋友的券专区