wx.addCard(Object object)

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

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

参数

Object object

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

object.cardList 的结构

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

object.success 回调函数

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

res.cardList 的结构

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

cardExt 说明

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

示例代码

wx.addCard({
  cardList: [
    {
      cardId: '',
      cardExt: '{"code": "", "openid": "", "timestamp": "", "signature":""}'
    }, {
      cardId: '',
      cardExt: '{"code": "", "openid": "", "timestamp": "", "signature":""}'
    }
  ],
  success (res) {
    console.log(res.cardList) // 卡券添加结果
  }
})