微信优惠券 朋友的券专区

me否booltrue是否校验code核销状态，填入true和false时的code异常状态返回数据不同。当check_consume为true时返回数据卡券状态正常：{    "errcode": 0,    "errmsg": "ok",    "card": {        "card_id": "pbLatjhCp8_HXAq84nHritGPqnjk",        "begin_time": 1447397802,        "end_time": 1452893532    },    "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",    "can_consume": true,    "user_card_status": "NORMAL",    "mark_openid": "obLatjjwDolFjRRd3doGIdwNqRXw",    "use_count": 1}卡券状态异常：{    "errcode": 40127,    "errmsg": "invalid user-card status! Hint: the card was given to user, but may be    deleted or set unavailable ! hint: [iHBD40040ent3]"}当check_consume为false时返回数据卡券状态正常：{    "errcode": 0,    "errmsg": "ok",    "card": {        "card_id": "pbLatjhCp8_HXAq84nHritGPqnjk",        "begin_time": 1447397802,        "end_time": 1452893532    },    "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",    "can_consume": true,    "user_card_status": "NORMAL",    "mark_openid": "obLatjjwDolFjRRd3doGIdwNqRXw",    "use_count": 1}卡券状态异常：{    "errcode": 0,    "errmsg": "ok",    "card": {        "card_id": "pbLatjhCp8_HXAq84nHritGPqnjk",        "begin_time": 1447397802,        "end_time": 1452893532    },    "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",    "can_consume": false,    "user_card_status": "DELETE",    "mark_openid": "obLatjjwDolFjRRd3doGIdwNqRXw",    "use_count": 1}参数名描述errcode错误码errmsg错误信息openid领取该卡券用户的openidcard_id卡券IDbegin_time起始使用时间end_time结束时间user_card_status当前code对应卡券的状态， NORMAL 正常 CONSUMED 已核销 EXPIRE 已过期 GIFTING 转赠中GIFT_TIMEOUT 转赠超时 DELETE 已删除，UNAVAILABLE 已失效； code未被添加或被转赠领取的情况则统一报错：invalid serial codecan_consume是否可以核销，true为可以核销，false为不可核销mark_openid当前占用此卡券的顾客的openid，核销时仅限该openid的用户可以核销该卡券use_count当前占用这个卡券的人已经使用该card_id的次数注：1.固定时长有效期会根据用户实际领取时间转换，如用户2013年10月1日领取，固定时长有效期为90天，即有效时间为2013年10月1日-12月29日有效。2.无论check_consume填写的是true还是false,当code未被添加或者code被转赠领取是统一报错：invalid serial code拉取卡券列表(ChooseCard)接口微信 JS SDK 只能在微信内置浏览器中使用,其他浏览器调用无效。微信提供chooseCard接口供商户前端网页调用,用于拉起用户名下该商家筛选条件的卡券内容。点击查看 调起适用于门店的卡券列表并获取用户选择列表JS SDK获取自定义外链参数为了满足商户基于卡券本身的扩展诉求，允许卡券内页添加url跳转外链。带有的的字段有openid、encrypt_code、card_id。假如指定的url为http://www.qq.com，用户点击时，跳转的url则为： http://www.qq.com?card_id=pWXUrtw4ehIUwDTXxkvCC6THenb8&encrypt_code= LPmXP%2BZFM9bdEQPSqcA8%2F%2F6pefbsKaRxnNUMHh5%2Fq6Q%3D &openid=oWXUrt8i3***ymgmPcHKlo0TdgHw注意：1.encrypt_code为加密码码，需调用解码接口获取真实Code码。2.从url中取出的参数须经过urlencode方可用于post请求。Code解码接口code解码接口支持两种场景： 1.商家获取choosecard_info后，将card_id和encrypt_code字段通过解码接口，获取真实code。 2.卡券内跳转外链的签名中会对code进行加密处理，通过调用解码接口获取真实code。接口调用请求说明http请求方式: POST https://api.weixin.qq.com/card/code/decrypt?access_token=TOKEN参数说明参数是否必须说明POST数据是JSON数据access_token是调用接口凭证POST数据{"encrypt_code": "XXIzTtMqCxwOaawoE91+VJdsFmv7b8g0VZIZkqf4GWA60Fzpc8ksZ/5ZZ0DVkXdE"}参数名必填类型示例值描述encrypt_code是string(128)XXIzTtMqCxwOaawoE91+VJdsFmv7b8g0VZIZkqf4GWA60Fzpc8ksZ/5ZZ0DVkXdE经过加密的Code码。返回数据数据示例： {"errcode":0, "errmsg":"ok", "code":"751234212312"}参数名描述errcode错误码errmsg错误信息code解密后获取的真实Code码Mark(占用)Code接口朋友的券由于共享的特性，会出现多个消费者同时进入某一个卡券的自定义H5网页的情况，若该网页涉及线上下单、核销、支付等行为，会造成两个消费者同时使用同一张券，会有一个消费者使用失败的情况，为此我们设计了mark（占用）code接口。对于出示核销（消费者点击“出示使用”按钮）的场景，开发者直接调用核销接口，无需考虑mark逻辑，此时由客户端代为完成。对于消费者进入H5网页核销的情况，我们约定，开发者在帮助消费者核销卡券之前，必须帮助先将此code（卡券串码）与一个openid绑定（即mark住），才能进一步调用核销接口，否则报错。接口调用请求说明http请求方式: POST https://api.weixin.qq.com/card/code/mark?access_token=TOKEN参数说明参数是否必须说明POST数据是JSON数据access_token是调用接口凭证POST数据{    "code": "114567897765",    "card_id": "pbxxxxxxxxhjahkdjad",    "openid": "obcdkalgsdklkdooooooo",    "is_mark": true}参数名必填描述code是卡券的code码。card_id是卡券的ID。openid是用券用户的openid。is_mark是是否要mark（占用）这个code，填写true或者false，表示占用或解除占用。返回数据数据示例： {"errcode":0, "errmsg":"ok"}参数名描述errcode错误码errmsg错误信息注意：1. 接口只支持未使用、正常状态的朋友的券，开发者调用前须查询code。2. is_mark不填默认为true。3. 重复用同一个openid mark，都返回成功。4. 用openid_a mark后，用openid_b mark会报错401465. is_mark为false时取消mark，要求传入的openid和mark时一致，否则报错40416。6. 不调用接口解除mark的话，5分钟后自动解除。（时间可能根据产品策略调整）线下核销Code接口消耗code接口是核销卡券的唯一接口，仅支持核销有效期内的卡券，否则会返回错误码invalid time。接口调用请求说明http请求方式: POST https://api.weixin.qq.com/card/code/consume?access_token=TOKEN参数说明参数是否必须说明POST数据是Json数据access_token是调用接口凭证POST数据非自定义Code卡券的请求 {"code": "12312313"}参数名必填类型示例值描述