wx.addCard(Object object)

基础库 2.5.0 开始支持,低版本需做兼容处理

批量添加卡券。只有通过 认证 的小程序或文化互动类目的小游戏才能使用。更多文档请参考 微信卡券接口文档

参数

Object object

属性类型默认值必填说明
cardListArray.<Object>需要添加的卡券列表
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.cardList 的结构

属性类型默认值必填说明
cardIdstring卡券 ID
cardExtstring卡券的扩展参数。需将 CardExt 对象 JSON 序列化为字符串传入

object.success 回调函数

参数
Object res
属性类型说明
cardListArray.<Object>卡券添加结果列表

res.cardList 的结构

属性类型说明
codestring加密 code,为用户领取到卡券的code加密后的字符串,解密请参照:code 解码接口
cardIdstring用户领取到卡券的 ID
cardExtstring卡券的扩展参数,结构请参考下文
isSuccessboolean是否成功

cardExt 说明

cardExt 是卡券的扩展参数,其值是一个 JSON 字符串。

示例代码

  1. wx.addCard({
  2. cardList: [
  3. {
  4. cardId: '',
  5. cardExt: '{"code": "", "openid": "", "timestamp": "", "signature":""}'
  6. }, {
  7. cardId: '',
  8. cardExt: '{"code": "", "openid": "", "timestamp": "", "signature":""}'
  9. }
  10. ],
  11. success (res) {
  12. console.log(res.cardList) // 卡券添加结果
  13. }
  14. })