这篇“微信小程序如何批量添加卡券”文章的知识点大部分人都不太理解,所以小编给大家总结了以下内容,内容详细,步骤清晰,具有一定的借鉴价值,希望大家阅读完这篇文章能有所收获,下面我们一起来看看这篇“微信小程序如何批量添加卡券”文章吧。
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) {
}
})
以上就是关于“微信小程序如何批量添加卡券”这篇文章的内容,相信大家都有了一定的了解,希望小编分享的内容对大家有帮助,若想了解更多相关的知识内容,请关注天达云行业资讯频道。