支付宝小程序Serverless 会员能力API·cloud.member.identification.init

cloud.member.identification.init 是支付宝身份认证场场景下的身份认证初始化接口。

入参说明

字段名	类型	必填	说明
outerOrderNo	String	是	商户请求的唯一标识，商户要保证其唯一性，值为32位长度的字母数字组合，建议前面几位字符是商户自定义的简称，中间可以使用一段时间，后段可以使用一个随机或递增序列
bizCode	String	是	认证场景码，入参支持的认证场景码和商户签约的认证场景相关，可选值有如下，FACE：多因子人脸认证；CERT_PHOTO：多因子证照认证；CERT_PHOTO_FACE：多因子证照和人脸认证；SMART_FACE：多因子快捷认证
identityParam	IdentityParam	是	需要验证的身份信息参数
merchantConfig	MerchantConfig	是	商户个性化配置
appAuthToken	String	否	三方代调用应用访问令牌，目前仅在云函数中调用支持。

IdentityParam 对象说明

字段名	类型	必填	说明
identityType	String	是	身份信息参数类型，必须传入CERT_INFO
certType	String	是	证件类型，当前支持身份证，必须传入IDENTITY_CARD
certName	String	是	真实姓名
certNo	String	是	证件号码

MerchantConfig 对象说明

字段名	类型	必填	说明
returnUrl	String	是	需要回跳的目标 URL 地址，一般指定为商户业务页面

调用示例

在云函数中调用

// 云函数中使用云调用无需引入其他依赖，只需要使用ctx.cloud调用
module.exports = async function (ctx) {
  var certifyParams = new Object({
    identityType: 'CERT_INFO',
    certType: 'IDENTITY_CARD',
    // 填写真实的证件名，如 小明
    certName: '',
    // 填写真实的证件号
    certNo: ''
  });
  var merchantConfig = new Object({
    returnUrl: 'www.taobao.com',
  });
  const res = await ctx.cloud.member.identification.init({
    // 参数接收自云函数调用端传入的参数
    outerOrderNo: "piwei" + new Date().getTime(),
    bizCode: 'FACE',
    identityParam: certifyParams,
    merchantConfig: merchantConfig
  });
  return res;
};

支持传入appAuthToken进行三方代调用

// 云函数中使用云调用无需引入其他依赖，只需要使用ctx.cloud调用
module.exports = async function (ctx) {
  var certifyParams = new Object({
    identityType: 'CERT_INFO',
    certType: 'IDENTITY_CARD',
    // 填写真实的证件名，如 小明
    certName: '',
    // 填写真实的证件号
    certNo: ''
  });
  var merchantConfig = new Object({
    returnUrl: 'www.taobao.com',
  });
  const res = await ctx.cloud.member.identification.init({
    // 参数接收自云函数调用端传入的参数
    outerOrderNo: "piwei" + new Date().getTime(),
    bizCode: 'FACE',
    identityParam: certifyParams,
    merchantConfig: merchantConfig
  }, {
    // appAuthToken参数接收自云函数调用处传入的参数
    appAuthToken: ctx.args.appAuthToken
  });
  return res;
};

在小程序页面调用

alipay-serverless-sdk 版本&=1.0.0

import cloud from 'alipay-serverless-sdk';
var certifyParams = new Object({
  identityType: 'CERT_INFO',
  certType: 'IDENTITY_CARD',
  // 填写真实的证件名，如 小明
  certName: '',
  // 填写真实的证件号
  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',
  // 填写真实的证件名，如 小明
  certName: '',
  // 填写真实的证件号
  certNo: ''
});
var merchantConfig = new Object({
  returnUrl: 'www.taobao.com',
});
const res = await cloud.member.identification.init("piwei" + new Date().getTime(), 'FACE', certifyParams, merchantConfig);

返回数据示例

{
    "code":"10000",
    "msg":"Success",
    "certify_id":"2109b5e671aa3ff2eb4851816c65828f"
}