版本号	更新内容	更新时间
V1.0	1.规范核销引导流程，建议开发者调用核销接口之前先调用查询code接口查看code状态 2.优化查询code接口，便于开发者使用，同时兼容旧接口	2015-8-31

版本号

更新内容

更新时间

V1.0

1.规范核销引导流程，建议开发者调用核销接口之前先调用查询code接口查看code状态

2.优化查询code接口，便于开发者使用，同时兼容旧接口

2015-8-31

该部分主要介绍开发者如何在用户使用券之后让卡券从用户的微信客户端消失的过程，这个步骤称为核销。

核销目前分为线上核销和线下核销两种类型。

线上核销指用户从券面进入一个HTML5网页后主动销券的过程，如微信商城用券、自助核销等；

线下核销指用户到店后，出示二维码或者出示串码，由收银员完成核销动作，如扫码核销、机具核销等。

1线下核销

1.1 查询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异常状态返回数据不同。

参数名

必填

类型

示例值

描述

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_

投放卡券

管理卡券