微信小程序如何批量添加卡券

發(fā)布時間：2022-03-10 10:50:18 來源：億速云閱讀：376 作者：iii 欄目：開發(fā)技術(shù)

這篇“微信小程序如何批量添加卡券”文章的知識點大部分人都不太理解，所以小編給大家總結(jié)了以下內(nèi)容，內(nèi)容詳細，步驟清晰，具有一定的借鑒價值，希望大家閱讀完這篇文章能有所收獲，下面我們一起來看看這篇“微信小程序如何批量添加卡券”文章吧。

wx.addCard(OBJECT)

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

批量添加卡券。

Object參數(shù)說明：

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

請求對象說明

參數(shù)	類型	說明
cardId	String	卡券 Id
cardExt	String	卡券的擴展參數(shù)

cardExt 說明

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

注：cardExt 需進行 JSON 序列化為字符串傳入

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

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

success返回參數(shù)：

參數(shù)	類型	說明
cardList	ObjectArray	卡券添加結(jié)果列表，列表內(nèi)對象說明請詳見返回對象說明

返回對象說明

參數(shù)	類型	說明
code	String	加密 code，為用戶領(lǐng)取到卡券的code加密后的字符串，解密請參照：code 解碼接口
cardId	String	用戶領(lǐng)取到卡券的Id
cardExt	String	用戶領(lǐng)取到卡券的擴展參數(shù)，與調(diào)用時傳入的參數(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ǔ)庫版本 1.1.0 開始支持，低版本需做兼容處理

查看微信卡包中的卡券。

Object參數(shù)說明：

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

openCard 請求對象說明

參數(shù)	類型	說明
cardId	String	需要打開的卡券 Id
code	String	由 addCard 的返回對象中的加密 code 通過解密后得到，解密請參照：code 解碼接口

示例代碼：

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

以上就是關(guān)于“微信小程序如何批量添加卡券”這篇文章的內(nèi)容，相信大家都有了一定的了解，希望小編分享的內(nèi)容對大家有幫助，若想了解更多相關(guān)的知識內(nèi)容，請關(guān)注億速云行業(yè)資訊頻道。

向AI問一下細節(jié)

微信小程序如何批量添加卡券

wx.addCard(OBJECT)

請求對象說明

wx.openCard(OBJECT)

猜你喜歡

最新資訊

相關(guān)推薦

相關(guān)標(biāo)簽