> 微信公众号开发手册 > 核销卡券

核销卡券

调起适用于门店的卡券列表并获取用户选择列表JS-SDK

核销卡券

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接口

线上核销普通券的接口同线下核销普通券的接口一致。

上一篇:
下一篇: