微信小程序 卡券

卡券

說明

小程序卡券接口支持在小程序中領(lǐng)取/查看/使用公眾號(hào) AppId 創(chuàng)建的會(huì)員卡、票、券（含通用卡）。更多使用方法可參考 小程序&卡券打通

使用條件

目前只有認(rèn)證小程序才能使用卡券接口，可參考 指引 進(jìn)行認(rèn)證。

接口

小程序內(nèi)可以通過 wx.addCard 接口給用戶添加卡券。通過 wx.openCard 讓用戶選擇已有卡券。

會(huì)員卡組件

開發(fā)者可以在小程序內(nèi)調(diào)用該接口拉起會(huì)員開卡組件，方便用戶快速填寫會(huì)員注冊信息并領(lǐng)卡。該接口拉起開卡組件無須提前將開卡組件和發(fā)起小程序綁定至同一個(gè)公眾號(hào)，開發(fā)者直接調(diào)用即可。

調(diào)用前開發(fā)者須完成以下步驟：

1. 創(chuàng)建一張微信會(huì)員卡并設(shè)置為一鍵激活模式；
2. 設(shè)置開卡字段；
3. 獲取開卡組件參數(shù)；

詳情查看會(huì)員開卡組件介紹：會(huì)員開卡組件

參數(shù)說明

返回參數(shù)

示例代碼

wx.navigateToMiniProgram({
  appId: 'wxeb490c6f9b154ef9', //固定為此 appid，不可改動(dòng)
  extraData: data, // 包括 encrypt_card_id, outer_str, biz三個(gè)字段，須從 step3 中獲得的鏈接中獲取參數(shù)
  success: function() {
  },
  fail: function() {
  },
  complete: function() {
  }
})

navigateToMiniProgram接口即將廢棄，新版本中請使用navigator組件來使用此功能

<navigator target="miniProgram" app-id="wxeb490c6f9b154ef9" extra-data="{{data}}">會(huì)員卡開卡</navigator>

返回說明

在 App.onShow 里判斷從會(huì)員開卡小程序返回的數(shù)據(jù)data

1. 判斷 data.referrerInfo.appId 是否為開卡小程序 appId wxeb490c6f9b154ef9，如果不是則中止判斷
2. 判斷是否有 data.referrerInfo.extraData 是否有數(shù)據(jù)，如果沒有，表示用戶未激活直接左滑/點(diǎn)返回鍵返回，或者用戶已經(jīng)激活
3. 若用戶激活成功，可以從 data.referrerInfo.extraData 中獲取 activate_ticket，card_id，code 參數(shù)用于下一步操作

提示：

1. 在開發(fā)者工具上調(diào)用此 API 并不會(huì)真實(shí)的跳轉(zhuǎn)到另外的小程序，但是開發(fā)者工具會(huì)校驗(yàn)本次調(diào)用跳轉(zhuǎn)是否成功詳情
2. 開發(fā)者工具上支持被跳轉(zhuǎn)的小程序處理接收參數(shù)的調(diào)試詳情
3. 開卡組件是使用wx.navigateToMiniProgram開發(fā)的官方組件，跳轉(zhuǎn)時(shí)無須綁定同一個(gè)公眾號(hào)，直接調(diào)用即可