調用核銷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接口返回參數說明