核销卡券
2.2 Code解码接口
code解码接口支持两种场景:
1.商家获取choos_card_info后,将card_id和encrypt_code字段通过解码接口,获取真实code。
2.卡券内跳转外链的签名中会对code进行加密处理,通过调用解码接口获取真实code。
接口调用请求说明
Http请求方式: POST
URL:https://api.weixin.qq.com/card/code/decrypt?access_token=TOKEN
参数说明
参数 | 是否必须 | 说明 |
---|---|---|
POST数据 | 是 | json数据 |
access_token | 是 | 调用接口凭证 |
POST数据
{
"encrypt_code":"XXIzTtMqCxwOaawoE91+VJdsFmv7b8g0VZIZkqf4GWA60Fzpc8ksZ/5ZZ0DVkXdE"
}
参数说明
参数名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
encrypt_code | 是 | string(128) |
XXIzTtMqCxwOaawoE91+VJdsFmv7b 8g0VZIZkqf4GWA60Fzpc8ksZ/5ZZ0DVkXdE |
经过加密的Code码。 |
返回数据
{
"errcode":0,
"errmsg":"ok",
"code":"751234212312"
}
参数说明
参数名 | 描述 |
---|---|
errcode | 错误码 |
errmsg | 错误信息 |
code | 解密后获取的真实Code码 |
注意事项
1.只能解码本公众号卡券获取的加密code。
2.开发者若从url上获取到加密code,请注意先进行urldecode,否则报错。
3.encrypt_code是卡券的code码经过加密处理得到的加密code码,与code一一对应。
4.开发者只能解密本公众号的加密code,否则报错。
2.3 查询Code接口
我们强烈建议开发者在调用核销code接口之前调用查询code接口,并在核销之前对非法状态的code(如转赠中、已删除、已核销等)做出处理。
2.4 核销Code接口
线上核销普通券的接口同线下核销普通券的接口一致。