| 版本号 | 更新内容 | 更新时间 |
|---|---|---|
| V1.0 | 优化查询code接口，返回信息中增加can_consume字段 ，告知开发者该卡券是否可以被核销，同时可以支持返回code状态的查询方式。 | 2015-8-31 |
| V1.1 | 新增拉取卡券数据接口 | 2015-9-7 |
查询code接口可以查询当前code是否可以被核销并检查code状态。当前可以被定位的状态为正常、已核销、转赠中、已删除、已失效和无效code。
接口调用请求说明
HTTP请求方式: POST URL: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) | pFS7Fjg8kV1I dDz01r4SQwMkuCKc | 卡券ID代表一类卡券。自定义code卡券必填。 |
| check_consume | 否 | bool | true | 是否校验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 | 用户openid |
| card_id | 卡券ID |
| begin_time | 起始使用时间 |
| end_time | 结束时间 |
| user_card_status | 当前code对应卡券的状态 NORMAL 正常 CONSUMED 已核销 EXPIRE 已过期 GIFTING 转赠中 GIFT_TIMEOUT 转赠超时 DELETE 已删除 UNAVAILABLE 已失效 code未被添加或被转赠领取的情况则统一报错：invalid serial code |
| can_consume | 是否可以核销，true为可以核销，false为不可核销 |
相关
视频
RELATED VIDEOS
科技资讯
1
2
3
4
5
6
7
8
9
精选课程
共5课时
17.2万人学习
共49课时
77万人学习
共29课时
61.7万人学习
共25课时
39.3万人学习
共43课时
70.9万人学习
共25课时
61.6万人学习
共22课时
23万人学习
共28课时
33.9万人学习
共89课时
125万人学习
