Version: 3.x

Taro.addCard(option)

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

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

参考文档

类型#

(option: Option) => Promise<SuccessCallbackResult>

参数#

Option#

参数	类型	必填	说明
cardList	`RequestInfo[]`	是	需要添加的卡券列表
complete	`(res: CallbackResult) => void`	否	接口调用结束的回调函数（调用成功、失败都会执行）
fail	`(res: CallbackResult) => void`	否	接口调用失败的回调函数
success	`(result: SuccessCallbackResult) => void`	否	接口调用成功的回调函数

RequestInfo#

需要添加的卡券列表

参数	类型	说明
cardExt	`string`	卡券的扩展参数。需将 CardExt 对象 JSON 序列化为字符串传入
cardId	`string`	卡券 ID

SuccessCallbackResult#

参数	类型	说明
cardList	`AddCardResponseInfo[]`	卡券添加结果列表
errMsg	`string`	调用结果

AddCardResponseInfo#

卡券添加结果列表

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

示例代码#

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

API 支持度#

API	微信小程序	H5	React Native
Taro.addCard	✔️