微信小程序API卡券,微信小程序批量添加卡券

—— 2017 ——

12/21

00:00

来源：

作者：未知

栏目：小程序开发

2017/12/21 0:00:00 来源：不详作者：未知

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) {
  }
})

Tip

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

更多微信小程序开发教程，可以关注。

【本站声明】
1、本站文章中所选用的图片及文字来源于网络以及用户投稿，由于未联系到知识产权人或未发现有关知识产权的登记，如有知识产权人并不愿意我们使用，如果有侵权请立即联系。
2、本网站不对文章中所涉及的内容真实性、准确性、可靠性负责，仅系客观性描述，如您需要了解该类商品/服务详细的资讯，请您直接与该类商品/服务的提供者联系。

KESION 科汛软件
KESION 科汛软件是国内领先的在线教育软件及私域社交电商软件服务提供商，长期专注于为企业提供在线教育软件及社交电商SaaS平台解决方案。
公司核心产品云开店SaaS社交电商服务平台、在线教育SaaS服务平台、教育企业数字化SaaS云平台、企微营销助手、私有化独立部署品牌网校和在线教育咨询等。
KESION 不断通过技术创新，提供产品和服务，助力企业向数字化转型，通过科技驱动商业革新，让商业变得更智慧！

▼点击进入科汛官网了解更多

热门标签

微信小程序开发微信小程序

上/下篇

微信小程序API获取小程序页面二维码,小程序生成小程序码

获取二维码通过后台接口可以获取小程序任意页面的二维码，扫描该二维码可以直接进入小程序对应的页面。目前微信支持两种二维码，小程序码（左），小程序二维码（右），如下...

微信小程序开发微信小程序 2017/12/22 0:00:00
微信小程序API调起客户端小程序设置界面

wx.openSetting(OBJECT) 基础库版本 1.1.0 开始支持，低版本需做兼容处理调起客户端小程序设置界面，返回用户设置的操作结果 Object 参数说明：参数类型必填说明

微信小程序开发微信小程序 2017/12/21 0:00:00