如何使用 wx.addCard 批量添加卡券？

推荐答案

// www.javascriptcn.com code example
wx.addCard({
  cardList: [
    {
      cardId: 'cardId1',
      cardExt: 'cardExt1'
    },
    {
      cardId: 'cardId2',
      cardExt: 'cardExt2'
    }
  ],
  success: function(res) {
    console.log('添加卡券成功', res.cardList);
  },
  fail: function(err) {
    console.error('添加卡券失败', err);
  }
});

本题详细解读

1. wx.addCard 方法简介

wx.addCard 是微信小程序提供的 API，用于批量添加卡券到用户的卡包中。开发者可以通过该接口将多张卡券一次性添加到用户的卡包中。

2. 参数说明

• cardList: 需要添加的卡券列表，类型为数组。数组中的每个元素是一个对象，包含以下两个字段：
  • cardId: 卡券的唯一标识符，类型为字符串。
  • cardExt: 卡券的扩展信息，类型为字符串。通常用于传递一些额外的参数，如签名、时间戳等。

3. 回调函数

• success: 添加卡券成功后的回调函数，返回的 res 对象中包含 cardList，表示成功添加的卡券列表。
• fail: 添加卡券失败后的回调函数，返回的 err 对象中包含错误信息。

4. 使用场景

wx.addCard 通常用于在用户完成某些操作后，批量将卡券添加到用户的卡包中。例如，用户完成支付后，可以一次性添加多张优惠券到用户的卡包中。

5. 注意事项

• 确保 cardId 和 cardExt 的正确性，否则可能会导致添加卡券失败。
• 在调用 wx.addCard 之前，建议先通过 wx.login 获取用户的登录态，以确保用户已登录。
• 由于涉及到用户的卡包操作，建议在用户明确同意的情况下调用该接口。