微信公众号管理卡券
由 如此轻盈 创建,Carrie 最后一次修改 2016-09-27 管理卡券更新日志版本号更新内容更新时间V1.0优化查询code接口,返回信息中增加can_consume字段,告知开发者该卡券是否可以被核销,同时可以支持返回code状态的查询方式。2015-8-31V1.1新增拉取卡券数据接口2015-9-7查询Code接口查询code接口可以查询当前code是否可以被核销并检查code状态。当前可以被定位的状态为正常、已核销、转赠中、已删除、已失效和无效code。接口调用请求说明HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/code/get?access_token=TOKEN参数说明参数是否必须说明POST数据是JSON数据access_token是调用接口凭证POST数据{ "card_id" : "card_id_123+", "code" : "123456789", "check_consume" : true}参数说明参数名必填类型示例值描述code是string(20)110201201245单张卡券的唯一标准。card_id否string(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc卡券ID代表一类卡券。自定义code卡券必填。check_consume否booltrue是否校验code核销状态,填入true和false时的code异常状态返回数据不同。当check_consume为true时返回数据卡券状态正常: { "errcode": 0, "errmsg": "ok", "card": { "card_id": "pbLatjk4T4Hx-QFQGL4zGQy27_Qg", "begin_time": 1457452800, "end_time": 1463155199 }, "openid": "obLatjm43RA5C6QfMO5szKYnT3dM", "can_consume": true, "user_card_status": "NORMAL"} 卡券状态异常:{ "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": "pbLatjk4T4Hx-QFQGL4zGQy27_Qg", "begin_time": 1457452800, "end_time": 1463155199 }, "openid": "obLatjm43RA5C6QfMO5szKYnT3dM", "can_consume": true, "user_card_status": "NORMAL"} 卡券状态异常: { "errcode": 0, "errmsg": "ok", "card": { "card_id": "pbLatjnK8NLbWgwMgfMtnj3gaglw", "begin_time": 1457625600, "end_time": 1460217599 }, "openid": "obLatjm43RA5C6QfMO5szKYnT3dM", "can_consume": false, "user_card_status": "GIFTING"} 参数名描述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为不可核销注意事项:1.固定时长有效期会根据用户实际领取时间转换,如用户2013年10月1日领取,固定时长有效期为90天,即有效时间为2013年10月1日-12月29日有效。2.无论check_consume填写的是true还是false,当code未被添加或者code被转赠领取是统一报错:invalid serial code获取用户已领取卡券接口用于获取用户卡包里的,属于该appid下所有可用卡券,包括正常状态和未生效状态。接口调用请求说明HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/user/getcardlist?access_token=TOKEN参数说明参数是否必须说明POST数据是JSON数据access_token是调用接口凭证POST数据{ "openid": "12312313", "card_id": "xxxxxxxxxx"} 参数说明参数名必填类型示例值描述openid是string(64)1231231需要查询的用户openidcard_id否string(32)pFS7Fjg8kV1IdDz01xxxxx卡券ID。不填写时默认查询当前appid下的卡券。返回数据 {"errcode":0,"errmsg":"ok","card_list": [ {"code": "xxx1434079154", "card_id": "xxxxxxxxxx"}, {"code": "xxx1434079155", "card_id": "xxxxxxxxxx"} ], "has_share_card": true} 参数说明参数名描述errcode错误码errmsg错误信息card_list卡券列表has_share_card是否有可用的朋友的券查看卡券详情开发者可以调用该接口查询某个card_id的创建信息、审核状态以及库存数量。接口调用请求说明HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/get?access_token=TOKEN参数说明参数是否必须说明POST数据是JSON数据access_token是调用接口凭证POST数据{ "card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc"}参数名必填类型示例值描述card_id是string(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc卡券ID。返回数据{ "errcode": 0, "errmsg": "ok", "card": { "card_type": "DISCOUNT", "discount": { "base_info": { "id": "pbLatjnP97_F9PudzBARQhn7xR7A", "logo_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LafmY25YclQ7vw5noBxeVH3DG5AKFR1ZsRgMgsvjll7EkUsZib00J964AEpTjkNXF2HorJHt5mtt45Q/0?wx_fmt=png", "code_type": "CODE_TYPE_NONE", "brand_name": "微信餐厅", "title": "9折优惠券", "date_info": { "type": "DATE_TYPE_FIX_TERM", "fixed_term": 30, "fixed_begin_term": 0 }, "color": "#10AD61", "notice": "到店使用", "description": "", "location_id_list": [ 218384742, 402521653, 402521608 ], "get_limit": 3, "can_share": true, "can_give_friend": true, "status": "CARD_STATUS_VERIFY_OK", "sku": { "quantity": 100096, "total_quantity": 100100 }, "create_time": 1457525546, "update_time": 1457526240, "area_code_list": [] }, "discount": 10, "advanced_info": { "time_limit": [ { "type": "MONDAY" }, { "type": "TUESDAY" } ], "text_image_list": [], "business_service": [], "consume_share_card_list": [], "abstract": { "abstract": "点击了解更多", "icon_url_list": [ "http://mmbiz.qpic.cn/mmbiz/p98FjXy8LafiawSeJeqBzk8qC40iaKIwUPm4TSCelulzEbAywKr7tWjkd5vRjbmFloUFeThfwhwMUZIXmsCtJpyQ/0?wx_fmt=jpeg" ] }, "share_friends": false } } }}参数名描述card_
微信公众号管理卡券