微信小程序API Card卡券
wx.addCard(OBJECT)
基础库版本 1.1.0 开始支持，低版本需做兼容处理
批量添加卡券。
Object参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cardList | ObjectArray | 是 | 需要添加的卡券列表，列表内对象说明请参见请求对象说明 |
| success | Function | 否 | 接口调用成功的回调函数 |
| fail | Function | 否 | 接口调用失败的回调函数 |
| complete | Function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
请求对象说明
| 参数 | 类型 | 说明 |
|---|---|---|
| cardId | String | 卡券 Id |
| cardExt | String | 卡券的扩展参数 |
cardExt 说明
| 参数 | 类型 | 必填 | 是否参与签名 | 说明 |
|---|---|---|---|---|
| code | String | 否 | 是 | 用户领取的 code，仅自定义 code 模式的卡券须填写，非自定义 code 模式卡券不可填写，详情 |
| openid | String | 否 | 是 | 指定领取者的openid，只有该用户能领取。 bind_openid 字段为 true 的卡券必须填写，bind_openid 字段为 false 不可填写。 |
| timestamp | Number | 是 | 是 | 时间戳，东八区时间,UTC+8，单位为秒 |
| nonce_str | String | 否 | 是 | 随机字符串，由开发者设置传入，加强安全性（若不填写可能被重放请求）。随机字符串，不长于 32 位。推荐使用大小写字母和数字，不同添加请求的 nonce_str 须动态生成，若重复将会导致领取失败。 |
| fixed_begintimestamp | Number | 否 | 否 | 卡券在第三方系统的实际领取时间，为东八区时间戳（UTC+8,精确到秒）。当卡券的有效期类为 DATE_TYPE_FIX_TERM 时专用，标识卡券的实际生效时间，用于解决商户系统内起始时间和领取微信卡券时间不同步的问题。 |
| outer_str | String | 否 | 否 | 领取渠道参数，用于标识本次领取的渠道值。 |
| signature | String | 是 | - | 签名，商户将接口列表中的参数按照指定方式进行签名,签名方式使用 SHA1，具体签名方案参见：卡券签名 |
注：cardExt 需进行 JSON 序列化为字符串传入
回调结果：
| 回调类型 | errMsg | 说明 |
|---|---|---|
| success | addCard:ok | 添加卡券成功 |
| fail | addCard:fail cancel | 用户取消添加卡券 |
| fail | addCard:fail (detail message) | 添加卡券失败，其中 detail message 为后台返回的详细失败原因 |
success返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| cardList | ObjectArray | 卡券添加结果列表，列表内对象说明请详见返回对象说明 |
返回对象说明
| 参数 | 类型 | 说明 |
|---|---|---|
| code | String | 加密 code，为用户领取到卡券的code加密后的字符串，解密请参照：code 解码接口 |
| cardId | String | 用户领取到卡券的Id |
| cardExt | String | 用户领取到卡券的扩展参数，与调用时传入的参数相同 |
| isSuccess | Boolean | 是否成功 |
示例代码：
wx.addCard({
cardList: [
{
cardId: '',
cardExt: '{"code": "", "openid": "", "timestamp": "", "signature":""}'
}, {
cardId: '',
cardExt: '{"code": "", "openid": "", "timestamp": "", "signature":""}'
}
],
success: function(res) {
console.log(res.cardList) // 卡券添加结果
}
})
wx.openCard(OBJECT)
基础库版本 1.1.0 开始支持，低版本需做兼容处理
查看微信卡包中的卡券。
Object参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cardList | ObjectArray | 是 | 需要打开的卡券列表，列表内参数详见openCard 请求对象说明 |
| success | Function | 否 | 接口调用成功的回调函数 |
| fail | Function | 否 | 接口调用失败的回调函数 |
| complete | Function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
openCard 请求对象说明
| 参数 | 类型 | 说明 |
|---|---|---|
| cardId | String | 需要打开的卡券 Id |
| code | String | 由 addCard 的返回对象中的加密 code 通过解密后得到，解密请参照：code 解码接口 |
示例代码：
wx.openCard({
cardList: [
{
cardId: '',
code: ''
}, {
cardId: '',
code: ''
}
],
success: function(res) {
}
})