调用核销Code接口之前需要调用查询Code接口,并在核销之前对非法状态的Code(如转赠中、已删除、已核销等)进行处理。
查询Code的接口如下。
https:// api.weixin.qq.com/card/code/get?access_token=TOKEN
查询Code时,POST数据示例如下。
{ "card_id":"card_id_123+", "code":"123456789", "check_consume":true}
上述数据的参数说明如表16-13所示。
表16-13 查询Code接口的参数说明
正确创建时,返回的数据示例如下。
{ "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"}
上述数据的参数说明如表16-14所示。
表16-14 查询Code接口返回参数说明