小程序开发API之卡券wx.openCard、wx.addCard

最新推荐文章于 2026-02-27 06:40:19 发布

原创最新推荐文章于 2026-02-27 06:40:19 发布 · 3.7k 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#小程序

ONE PIECE--小程序专栏收录该内容

134 篇文章

订阅专栏

本文档介绍了微信小程序中用于卡券操作的`wx.openCard`和`wx.addCard`两个API，这两个方法适用于认证小程序和文化互动小游戏。`wx.openCard`用于查看卡包中的卡券，而`wx.addCard`则用于批量添加卡券。每个方法的参数对象包括`cardList`结构，并提供了示例代码和回调函数参数解析。

wx.openCard(Object object)

查看微信卡包中的卡券。只有通过认证的小程序或文化互动类目的小游戏才能使用。更多文档请参考微信卡券接口文档。
参数 object 在这里插入图片描述

object.cardList 的结构 在这里插入图片描述

示例代码

wx.openCard({
  cardList: [{
    cardId: '',
    code: ''
  }, {
    cardId: '',
    code: ''
  }],
  success(res) { }
})

wx.addCard(Object object)

批量添加卡券。只有通过认证的小程序或文化互动类目的小游戏才能使用。更多文档请参考微信卡券接口文档。
参数 object 在这里插入图片描述

object.cardList 的结构 在这里插入图片描述

cardExt 的结构 在这里插入图片描述

object.success 回调函数参数 res 在这里插入图片描述

res.cardList 的结构 在这里插入图片描述

cardExt 说明
cardExt 是卡券的扩展参数，其值是一个 JSON 字符串。
示例代码

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