支付寶小程序API 商戶會(huì)員卡

2020-09-16 15:50 更新

my.addCardAuth

小程序喚起會(huì)員開卡授權(quán)頁面。

注意: 此 API 暫僅支持企業(yè)支付寶賬戶使用。

示例代碼

my.addCardAuth({
  url: '從 openapi 接口獲取到的 url',
  success: (res) => {
    my.alert({content: '授權(quán)成功'});
  },
  fail: (res) => {
    my.alert({content: '授權(quán)失敗'});
  },
});

入?yún)?/h4>

Object 類型,屬性如下:

屬性 類型 必填 描述
url String 開卡授權(quán)的頁面地址,從接口獲取。
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í)行)。

success 回調(diào)函數(shù)

領(lǐng)卡成功

入?yún)?Object 類型,屬性如下:

屬性 類型 說明
success Boolean true 表示領(lǐng)卡成功。
resultStatus String 9000 表示成功。
result Object 結(jié)果內(nèi)容。

領(lǐng)卡成功的 result 屬性說明
屬性 類型 說明
app_id String 應(yīng)用id
auth_code String 授權(quán)碼,用于換取 authtoken。
state String 授權(quán)的 state。
scope String 授權(quán) scope。
template_id String 會(huì)員卡模板 ID。
request_id String 會(huì)員卡表單信息請(qǐng)求 ID。
out_string String 會(huì)員卡領(lǐng)卡鏈接透傳參數(shù)。

領(lǐng)卡失敗

入?yún)?Object 類型,屬性如下:

屬性 類型 說明
success Boolean false 表示領(lǐng)卡失敗。
code String 失敗的錯(cuò)誤碼。

領(lǐng)卡失敗 code 錯(cuò)誤碼
錯(cuò)誤碼 類型 說明
JSAPI_SERVICE_TERMINATED String 用戶取消。
JSAPI_PARAM_INVALID String URL 為空或非法參數(shù)。
JSAPI_SYSTEM_ERROR String 系統(tǒng)錯(cuò)誤。

IoT 小程序錯(cuò)誤碼
錯(cuò)誤碼 類型 說明 解決方案
ILLEGAL_NULL_ARGUMENT String 非法空參數(shù)。 通過 alipay.marketing.card.activateurl.apply 接口生成的領(lǐng)卡鏈接,剔除 callback 參數(shù),并對(duì)領(lǐng)卡鏈接做 urlDecode 處理。
INVALID_APPLY_CARD_LINK String 非法的開卡鏈接。 通過 alipay.marketing.card.activateurl.apply 接口生成的領(lǐng)卡鏈接,剔除 callback 參數(shù),并對(duì)領(lǐng)卡鏈接做 urlDecode 處理。
OPEN_FORM_TEMPLATE_NOT_EXIST String 開放表單配置信息不存在。 調(diào)用 alipay.marketing.card.formtemplate.set 接口配置表單信息。
ALREADY_ACTIVE_CARD String 會(huì)員已有會(huì)員卡。 如需測試重新領(lǐng)取,可到支付寶卡包中刪除會(huì)員卡,重新領(lǐng)取。
OPEN_FORM_FIELD_NOT_PERMITTED String 表單字段商家無權(quán)限。 后臺(tái)申請(qǐng)對(duì)應(yīng)缺失字段的權(quán)限。
OPEN_FORM_USER_LACK_INFO String 當(dāng)前表單用戶信息缺失。會(huì)員卡表單設(shè)置姓名、手機(jī)號(hào)等字段,但是會(huì)員卡應(yīng)用下沒有這些字段的權(quán)限。支付寶缺少此用戶的表單信息,無法獲取到信息。 后臺(tái)申請(qǐng)對(duì)應(yīng)缺失字段的權(quán)限。建議用戶進(jìn)行實(shí)名認(rèn)證,補(bǔ)充缺少的姓名、手機(jī)號(hào)等信息。
SYSTEM_ERROR String 系統(tǒng)異常。 建議稍后重試。

my.openCardDetail

打開當(dāng)前用戶的某張卡的詳情頁。有關(guān)支付寶卡包詳細(xì)功能。

支付寶特色 API,支持 my.ap.openCardDetail 調(diào)用。

注意:此 API 暫僅支持企業(yè)支付寶賬戶使用。

示例代碼

//傳入passId來打開
my.openCardDetail({passId:"11xxxxx"});

入?yún)?/h4>

Object 類型,屬性如下:

屬性 類型 必填 描述
passId String 卡實(shí)例 ID

passId 獲取方式

\1. 通過 alipass 創(chuàng)建的卡

調(diào)用 alipay.pass.instance.add(支付寶 pass 新建卡券實(shí)例接口)接口,在出參“result”中可獲取。

\2. 通過會(huì)員卡創(chuàng)建的卡

調(diào)用 alipay.marketing.card.query(會(huì)員卡查詢)接口,在 scheme_url 中可獲取,具體參數(shù)為“p=xxx”,xxx 即為passId。

my.openCardList

打開支付寶卡列表。有關(guān)支付寶卡包詳細(xì)功能。

支付寶特色 API,支持 my.ap.openCardList 調(diào)用。

注意:此 API 暫僅支持企業(yè)支付寶賬戶使用。

示例說明

my.openCardList();

my.openMerchantCardList

打開當(dāng)前用戶的某個(gè)商戶的卡列表。有關(guān)支付寶卡包詳細(xì)功能。

支付寶特色 API ,支持 my.ap.openMerchantCardList 調(diào)用。

注意:此 API 暫僅支持企業(yè)支付寶賬戶使用。

示例代碼

my.openMerchantCardList({partnerId:'2088xxxxx'});

入?yún)?/h4>

Object 類型,屬性如下:

屬性 類型 必填 描述
partnerId String 商戶編號(hào)。

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)