微信小程序API Card卡券

浏览： ℃

字体：大中小

发布时间：2018-01-17 09:03:31

来源：

wx.addCard(OBJECT)

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

批量添加卡券。

Object参数说明：

参数类型必填说明cardListObjectArray是需要添加的卡券列表，列表内对象说明请参见请求对象说明successFunction否接口调用成功的回调函数failFunction否接口调用失败的回调函数completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

请求对象说明

参数类型说明cardIdString卡券 IdcardExtString卡券的扩展参数

cardExt 说明

参数类型必填是否参与签名说明codeString否是用户领取的 code，仅自定义 code 模式的卡券须填写，非自定义 code 模式卡券不可填写，详情openidString否是指定领取者的openid，只有该用户能领取。 bind_openid 字段为 true 的卡券必须填写，bind_openid 字段为 false 不可填写。timestampNumber是是时间戳，东八区时间,UTC+8，单位为秒nonce_strString否是随机字符串，由开发者设置传入，加强安全性（若不填写可能被重放请求）。随机字符串，不长于 32 位。推荐使用大小写字母和数字，不同添加请求的 nonce_str 须动态生成，若重复将会导致领取失败。fixed_begintimestampNumber否否卡券在第三方系统的实际领取时间，为东八区时间戳（UTC+8,精确到秒）。当卡券的有效期类为 DATE_TYPE_FIX_TERM 时专用，标识卡券的实际生效时间，用于解决商户系统内起始时间和领取微信卡券时间不同步的问题。outer_strString否否领取渠道参数，用于标识本次领取的渠道值。signatureString是-签名，商户将接口列表中的参数按照指定方式进行签名,签名方式使用 SHA1，具体签名方案参见：卡券签名

注：cardExt 需进行 JSON 序列化为字符串传入

回调结果：

回调类型errMsg说明successaddCard:ok添加卡券成功failaddCard:fail cancel用户取消添加卡券failaddCard:fail (detail message)添加卡券失败，其中 detail message 为后台返回的详细失败原因

success返回参数：

参数类型说明cardListObjectArray卡券添加结果列表，列表内对象说明请详见返回对象说明

返回对象说明

参数类型说明codeString加密 code，为用户领取到卡券的code加密后的字符串，解密请参照：code 解码接口cardIdString用户领取到卡券的IdcardExtString用户领取到卡券的扩展参数，与调用时传入的参数相同isSuccessBoolean是否成功

示例代码：

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参数说明：

参数类型必填说明cardListObjectArray是需要打开的卡券列表，列表内参数详见openCard 请求对象说明successFunction否接口调用成功的回调函数failFunction否接口调用失败的回调函数completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

openCard 请求对象说明

参数类型说明cardIdString需要打开的卡券 IdcodeString由 addCard 的返回对象中的加密 code 通过解密后得到，解密请参照：code 解码接口

示例代码：

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

Tip

tip: 目前只有认证小程序才能使用卡券接口，可参考指引进行认证。
tip: 了解更多信息，请查看微信卡券接口文档

>更多相关文章

01-18微信小程序工具细节点
01-18微信小程序工具下载地址

首页推荐

东方联盟网培训质量如何?靠谱吗?

　　佛山市东联科技有限公司一直秉承“一切以用户价值为依归

相关文章

24小时热门资讯

24小时回复排行

热门推荐

最新资讯

网络安全

操作系统

黑客防御

站长知识