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

2017-12-21

導(dǎo)讀：wx.addCard(OBJECT) 基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理批量添加卡券。 Object參數(shù)說(shuō)明：參數(shù) 類(lèi)型必填說(shuō)明 cardList ObjectArray 是需要添加的卡券列表，列表內(nèi)對(duì)象說(shuō)明請(qǐng)參見(jiàn)請(qǐng)...

wx.addCard(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

批量添加卡券。

Object參數(shù)說(shuō)明：

參數(shù)	類(lèi)型	必填	說(shuō)明
cardList	ObjectArray	是	需要添加的卡券列表，列表內(nèi)對(duì)象說(shuō)明請(qǐng)參見(jiàn)請(qǐng)求對(duì)象說(shuō)明
success	Function	否	接口調(diào)用成功的回調(diào)函數(shù)
fail	Function	否	接口調(diào)用失敗的回調(diào)函數(shù)
complete	Function	否	接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會(huì)執(zhí)行）

請(qǐng)求對(duì)象說(shuō)明

參數(shù)	類(lèi)型	說(shuō)明
cardId	String	卡券 Id
cardExt	String	卡券的擴(kuò)展參數(shù)

cardExt 說(shuō)明

參數(shù)	類(lèi)型	必填	是否參與簽名	說(shuō)明
code	String	否	是	用戶(hù)領(lǐng)取的 code，僅自定義 code 模式的卡券須填寫(xiě)，非自定義 code 模式卡券不可填寫(xiě)，詳情
openid	String	否	是	指定領(lǐng)取者的openid，只有該用戶(hù)能領(lǐng)取。 bind_openid 字段為 true 的卡券必須填寫(xiě)，bind_openid 字段為 false 不可填寫(xiě)。
timestamp	Number	是	是	時(shí)間戳，東八區(qū)時(shí)間,UTC+8，單位為秒
nonce_str	String	否	是	隨機(jī)字符串，由開(kāi)發(fā)者設(shè)置傳入，加強(qiáng)安全性（若不填寫(xiě)可能被重放請(qǐng)求）。隨機(jī)字符串，不長(zhǎng)于 32 位。推薦使用大小寫(xiě)字母和數(shù)字，不同添加請(qǐng)求的 nonce_str 須動(dòng)態(tài)生成，若重復(fù)將會(huì)導(dǎo)致領(lǐng)取失敗。
fixed_begintimestamp	Number	否	否	卡券在第三方系統(tǒng)的實(shí)際領(lǐng)取時(shí)間，為東八區(qū)時(shí)間戳（UTC+8,精確到秒）。當(dāng)卡券的有效期類(lèi)為 DATE_TYPE_FIX_TERM 時(shí)專(zhuān)用，標(biāo)識(shí)卡券的實(shí)際生效時(shí)間，用于解決商戶(hù)系統(tǒng)內(nèi)起始時(shí)間和領(lǐng)取微信卡券時(shí)間不同步的問(wèn)題。
outer_str	String	否	否	領(lǐng)取渠道參數(shù)，用于標(biāo)識(shí)本次領(lǐng)取的渠道值。
signature	String	是	-	簽名，商戶(hù)將接口列表中的參數(shù)按照指定方式進(jìn)行簽名,簽名方式使用 SHA1，具體簽名方案參見(jiàn)：卡券簽名

注：cardExt 需進(jìn)行 JSON 序列化為字符串傳入

回調(diào)結(jié)果：

回調(diào)類(lèi)型	errMsg	說(shuō)明
success	addCard:ok	添加卡券成功
fail	addCard:fail cancel	用戶(hù)取消添加卡券
fail	addCard:fail (detail message)	添加卡券失敗，其中 detail message 為后臺(tái)返回的詳細(xì)失敗原因

success返回參數(shù)：

參數(shù)	類(lèi)型	說(shuō)明
cardList	ObjectArray	卡券添加結(jié)果列表，列表內(nèi)對(duì)象說(shuō)明請(qǐng)?jiān)斠?jiàn)返回對(duì)象說(shuō)明

返回對(duì)象說(shuō)明

參數(shù)	類(lèi)型	說(shuō)明
code	String	加密 code，為用戶(hù)領(lǐng)取到卡券的code加密后的字符串，解密請(qǐng)參照：code 解碼接口
cardId	String	用戶(hù)領(lǐng)取到卡券的Id
cardExt	String	用戶(hù)領(lǐng)取到卡券的擴(kuò)展參數(shù)，與調(diào)用時(shí)傳入的參數(shù)相同
isSuccess	Boolean	是否成功

示例代碼：

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

wx.openCard(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

查看微信卡包中的卡券。

Object參數(shù)說(shuō)明：

參數(shù)	類(lèi)型	必填	說(shuō)明
cardList	ObjectArray	是	需要打開(kāi)的卡券列表，列表內(nèi)參數(shù)詳見(jiàn)openCard 請(qǐng)求對(duì)象說(shuō)明
success	Function	否	接口調(diào)用成功的回調(diào)函數(shù)
fail	Function	否	接口調(diào)用失敗的回調(diào)函數(shù)
complete	Function	否	接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會(huì)執(zhí)行）

openCard 請(qǐng)求對(duì)象說(shuō)明

參數(shù)	類(lèi)型	說(shuō)明
cardId	String	需要打開(kāi)的卡券 Id
code	String	由 addCard 的返回對(duì)象中的加密 code 通過(guò)解密后得到，解密請(qǐng)參照：code 解碼接口

示例代碼：

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

Tip

tip: 目前只有認(rèn)證小程序才能使用卡券接口，可參考指引進(jìn)行認(rèn)證。
tip: 了解更多信息，請(qǐng)查看微信卡券接口文檔

更多微信小程序開(kāi)發(fā)教程，可以關(guān)注hi小程序。

第二部分：如何開(kāi)通一個(gè)小商店

您可能感興趣: 小程序開(kāi)發(fā)小程序api

上一篇：微信小程序API收貨地址,調(diào)起用戶(hù)編輯收貨地址原生界面 下一篇：微信小程序API調(diào)起客戶(hù)端小程序設(shè)置界面