微信优惠券 朋友的券专区

时间内换取二维码。url二维码图片解析后的地址，开发者可根据该地址自行生成需要的二维码图片show_qrcode_url二维码显示地址，点击后跳转二维码页面获取JSAPI_TICKET接口接口调用请求说明http请求方式: GET https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi返回数据{    "errcode": 0,    "errmsg": "ok",    "ticket": "bxLdikRXVbTPdHSM05e5u5sUoXNKd8-41ZO3MhKoyN5OfkWITDGgnr2fwJ0m9E8NYzWKVZvdVtaUgWvsdshFKA",    "expires_in": 7200}参数名描述errcode错误码errmsg错误信息ticket获取的JSAPI_TICKETexpires_in有效时间，ticket有效时间为2小时，2小时内不变获取卡券API_TICKET接口接口调用请求说明http请求方式: GET https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=wx_card返回数据{    "errcode": 0,    "errmsg": "ok",    "ticket": "bxLdikRXVbTPdHSM05e5u5sUoXNKdvsdshFKA",    "expires_in": 7200}参数名描述errcode错误码errmsg错误信息ticket获取的卡券API_TICKETexpires_in有效时间，ticket有效时间为2小时，2小时内不变批量添加卡券（addcard）接口朋友的券领取须指引用户升级到最新的微信客户端版本，最低版本要求为：iOS微信版本为6.3.6及以上，Android微信版本为6.3.7及以上。 开发者可以判断用户版本后调用addcard接口，请点击查看判断用户客户端版本、批量添加卡券接口。卡券领取事件用户领取朋友的券后，会有事件推送到开发者服务器。 帮助错误码错误码说明排错指引40053JSON结构错误card_id或者参数名有误，请对比示例排查43008当前账号未开通支付权限或未开通支付后送券接口权限，无法设置支付后送朋友的券功能前往开通微信支付            45021赠券规则列表长度高于10个减少赠券规则列表的个数47001创建JSON结构错误针对报错信息提示的位置对比示例排查更多错误码，请见卡券全局错误码常见问题1.如何区分领取渠道？开发者可以在生成二维码或者H5添加卡券时，填入outer_id(自定义渠道值),这个数值会随领取事件推送至开发者服务器，从而使得开发者可以区分每一个code（卡券串码）的投放渠道。2.为什么长按二维码不能领取卡券？目前朋友的券仅支持线下渠道投放，对于线上的场景（如长按二维码领取、公众号群发）等做了限制。朋友的券核销接口说明此处介绍朋友的券的核销方式，分为线上和线下核销两部分，下面分不同的场景介绍。案例介绍线下核销机具扫码核销场景介绍具有机具和开发能力的商户可以通过机具扫码进行卡券核销，开发者可以通过机具扫码获得卡券code之后，调用核销code接口将卡券进行核销，方便快捷。接口调用流程API列表步骤API名称用途API属性1查询code接口            查询code状态，获知当前卡券是否可以核销管理卡券2线下核销code接口            设置卡券门店并通过审核获得poiid，用于创建时填入location_list字段核销卡券3卡券核销事件            获得当前卡券的使用人、code和card_id等信息事件推送网页工具核销场景介绍若开发者没有能力进行机具开发，可以开发一个核销员端使用的网页进行朋友的券的核销，当用户出示二维码时。接口调用流程API列表步骤API名称用途API属性1查询code接口            查询code状态，获知当前卡券是否可以核销管理卡券2线下核销code接口            设置卡券门店并通过审核获得poiid，用于创建时填入location_list字段核销卡券3卡券核销事件            获得当前卡券的使用人、code和card_id等信息事件推送卡券商户助手核销场景介绍手机核销助手是基于“卡券商户助手“公众号的官方卡券核销工具，同样支持朋友的券的核销。快速体验步骤一：关注“微信卡券商户助手”步骤二：进入【微信公众号后台】-【卡券功能】-【卡券核销】-【添加核销员】，为自己的微信号设置核销员权限，并选择已有的门店。步骤三：用另一台手机领取自己创建的朋友的券，展开二维码并用已设置为核销员的手机扫码或者输码核销卡券。公众号商户后台核销商户可以在电脑登录公众号商户后要，【卡券功能】-【卡券核销】-【网页核销】直接核销核销卡券。线上核销线上核销涉及的接口与线下核销接口略有不同，线上核销接口需要消费者跳转至H5网页，所以可能会出现两个用户同时使用同一张卡券的情况，我们约定，对于没有点击卡券上的“出示使用”的核销，开发者先调用占用（mark）接口，将一个code(卡券串码)与一个openid（用户身份识别码）关联，保证该code不被另外的人使用。网页快速核销场景介绍若开发者没有办法配置核销员或者商户没办法，可以自定义一个H5核销界面，用户在券面发起核销并在开发者自定义的H5网页内完成核销和裂变送券的过程。值得开发者注意的是，对于自助核销的卡券，开发者在创建/更新卡券是可以将code_type字段设置为CODE_TYPE_NONE,这样可以隐藏掉卡券上使用二维码的入口（如下图），同时将核销的url通过创建接口中的center_title center_sub_title，center_url写入，那么此自定义入口会指定居中（如下图）接口调用流程API列表步骤API名称用途API属性1获取自定义跳转链接参数            获取加密code（encrypt_code）、card_id和openid创建卡券2code解码接口           通过加密code获得真实的code核销卡券3查询code接口           查看code状态是否可以核销管理卡券4Mark(占用)code接口            在核销之前将code锁住，防止出现两个人同时核销券的情况核销卡券5线上核销code接口            将卡券核销掉，须传入openid和code核销接口6卡券核销事件            获得当前卡券的使用人、code和card_id等信息事件推送7核销裂赠券接口（JSSDK）            拉起裂变领取页供用户领取核销接口API详情查询Code接口我们强烈建议开发者在调用核销code接口之前调用查询code接口，并在核销之前对非法状态的code(如转赠中、已删除、已核销等)做出处理。接口调用请求说明http请求方式: POST https://api.weixin.qq.com/card/code/get?access_token=TOKEN参数说明参数是否必须说明POST数据是Json数据access_token是调用接口凭证POST数据{    "card_id": "pbLatjorLTVl-tdvZ6zQRIc-Fn6Y",     "code": "245645675434",     "check_consume": true}参数名必填类型示例值描述code是string(20)110201201245单张卡券的唯一标准。card_id否string(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc卡券ID代表一类卡券。check_consu