支付寶小程序Serverless 會(huì)員能力API·cloud.member.identification.init

2020-09-18 14:32 更新

cloud.member.identification.init 是支付寶身份認(rèn)證場場景下的身份認(rèn)證初始化接口。

入?yún)⒄f明

字段名 類型 必填 說明
outerOrderNo String 商戶請(qǐng)求的唯一標(biāo)識(shí),商戶要保證其唯一性,值為32位長度的字母數(shù)字組合,建議前面幾位字符是商戶自定義的簡稱,中間可以使用一段時(shí)間,后段可以使用一個(gè)隨機(jī)或遞增序列
bizCode String 認(rèn)證場景碼,入?yún)⒅С值恼J(rèn)證場景碼和商戶簽約的認(rèn)證場景相關(guān),可選值有如下,F(xiàn)ACE:多因子人臉認(rèn)證;CERT_PHOTO:多因子證照認(rèn)證;CERT_PHOTO_FACE:多因子證照和人臉認(rèn)證;SMART_FACE:多因子快捷認(rèn)證
identityParam IdentityParam 需要驗(yàn)證的身份信息參數(shù)
merchantConfig MerchantConfig 商戶個(gè)性化配置
appAuthToken String 三方代調(diào)用應(yīng)用訪問令牌,目前僅在云函數(shù)中調(diào)用支持。

IdentityParam 對(duì)象說明

字段名 類型 必填 說明
identityType String 身份信息參數(shù)類型,必須傳入CERT_INFO
certType String 證件類型,當(dāng)前支持身份證,必須傳入IDENTITY_CARD
certName String 真實(shí)姓名
certNo String 證件號(hào)碼

MerchantConfig 對(duì)象說明

字段名 類型 必填 說明
returnUrl String 需要回跳的目標(biāo) URL 地址,一般指定為商戶業(yè)務(wù)頁面

調(diào)用示例

在云函數(shù)中調(diào)用

// 云函數(shù)中使用云調(diào)用無需引入其他依賴,只需要使用ctx.cloud調(diào)用
module.exports = async function (ctx) {
  var certifyParams = new Object({
    identityType: 'CERT_INFO',
    certType: 'IDENTITY_CARD',
    // 填寫真實(shí)的證件名,如 小明
    certName: '',
    // 填寫真實(shí)的證件號(hào)
    certNo: ''
  });
  var merchantConfig = new Object({
    returnUrl: 'www.taobao.com',
  });
  const res = await ctx.cloud.member.identification.init({
    // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
    outerOrderNo: "piwei" + new Date().getTime(),
    bizCode: 'FACE',
    identityParam: certifyParams,
    merchantConfig: merchantConfig
  });
  return res;
};

支持傳入appAuthToken進(jìn)行三方代調(diào)用

// 云函數(shù)中使用云調(diào)用無需引入其他依賴,只需要使用ctx.cloud調(diào)用
module.exports = async function (ctx) {
  var certifyParams = new Object({
    identityType: 'CERT_INFO',
    certType: 'IDENTITY_CARD',
    // 填寫真實(shí)的證件名,如 小明
    certName: '',
    // 填寫真實(shí)的證件號(hào)
    certNo: ''
  });
  var merchantConfig = new Object({
    returnUrl: 'www.taobao.com',
  });
  const res = await ctx.cloud.member.identification.init({
    // 參數(shù)接收自云函數(shù)調(diào)用端傳入的參數(shù)
    outerOrderNo: "piwei" + new Date().getTime(),
    bizCode: 'FACE',
    identityParam: certifyParams,
    merchantConfig: merchantConfig
  }, {
    // appAuthToken參數(shù)接收自云函數(shù)調(diào)用處傳入的參數(shù)
    appAuthToken: ctx.args.appAuthToken
  });
  return res;
};

在小程序頁面調(diào)用

alipay-serverless-sdk 版本&=1.0.0

import cloud from 'alipay-serverless-sdk';
var certifyParams = new Object({
  identityType: 'CERT_INFO',
  certType: 'IDENTITY_CARD',
  // 填寫真實(shí)的證件名,如 小明
  certName: '',
  // 填寫真實(shí)的證件號(hào)
  certNo: ''
});
var merchantConfig = new Object({
  returnUrl: 'www.taobao.com',
});
const res = await cloud.member.identification.init({
    outerOrderNo: "piwei" + new Date().getTime(),
    bizCode: 'FACE',
    identityParam: certifyParams,
    merchantConfig: merchantConfig
  });

alipay-serverless-sdk 版本<1.0.0

import cloud from 'alipay-serverless-sdk';
var certifyParams = new Object({
  identityType: 'CERT_INFO',
  certType: 'IDENTITY_CARD',
  // 填寫真實(shí)的證件名,如 小明
  certName: '',
  // 填寫真實(shí)的證件號(hào)
  certNo: ''
});
var merchantConfig = new Object({
  returnUrl: 'www.taobao.com',
});
const res = await cloud.member.identification.init("piwei" + new Date().getTime(), 'FACE', certifyParams, merchantConfig);

返回?cái)?shù)據(jù)示例

{
    "code":"10000",
    "msg":"Success",
    "certify_id":"2109b5e671aa3ff2eb4851816c65828f"
}
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

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

編程獅公眾號(hào)