AI 助理
文档备案控制台
官方文档
首页

InitFaceVerify-发起NFC认证请求

更新时间：
复制 MD 格式
产品详情
我的收藏

本文介绍如何通过调用InitFaceVerify接口发起金融级NFC认证请求。

发起认证请求

接口名：InitFaceVerify

全局接入地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）

请求方法：POST和GET

传输协议：HTTPS

接口说明：每次开始认证前通过本接口获取CertifyId，用来串联认证请求中的各个接口。

QPS限量：API独享QPS限量，详情请参见服务端接口QPS限量说明。

重要

金融级实人认证服务暂不支持基于调用次数的硬性封顶或自动停用功能。为有效控制成本并防范高额账单风险，建议在接入产品后及时配置消费告警规则：

  1. 配置消费预警：设置高额消费预警阈值，实时监控账单支出情况。

  2. 监控流量包余量：若已购买流量包，请同步设置资源包余量预警，以便及时补充资源或调整调用策略。

  3. 配置业务监控：参见告警通知设置，监控业务异动，及时识别业务请求波动。

请求参数

名称

类型

是否必选

描述

示例值

SceneId

Long

是

认证场景ID。该ID在控制台创建认证场景后自动生成。关于如何创建认证场景，请参见添加认证场景。

100000****

OuterOrderNo

String

是

您自定义的业务唯一标识，用于后续定位排查问题使用。支持最长为32位长度的字母和数字组合，请确保唯一。

e0c34a77f5ac40a5aa5e6ed20c35****

ProductCode

String

是

认证方案。

唯一取值：NFC_QY。

NFC_QY

UserId

String

是

您自定义的用户ID（最长100个字符），请保持唯一。

12345****

CertType

String

是

证件类型。

说明

当前仅支持护照认证。

PASSPORT

ReadImg

String

是

是否读取证件照片：

Y：读取

N：不读取

说明

如果在后续认证环节需要使用证件人脸照片，此处建议入参为Y。

Y

MetaInfo

String

是

MetaInfo环境参数。需要通过客户端SDK获取，详情请参见App（SDK）接入。

{
  "zimVer": "3.0.0",
  "appVersion": "1",
  "bioMetaInfo": "4.1.0:1150****,0",
  "appName": "com.aliyun.antcloudauth",
  "deviceType": "ios",
  "osVersion": "iOS 10.3.2",
  "apdidToken": "",
  "deviceModel": "iPhone9,1"
}
说明

示例仅供参考，实际集成中不能直接应用，具体参考SDK集成说明获取。

Mode

String

否

获取护照NFC核验要素方式：

  • 1：用户输入，终端用户使用阿里云SDK提供的UI界面手工输入证件要素信息。

  • 3：外部参数传入，通过外部传入证件要素信息。

说明

NFC解码护照芯片加密信息时需要获取护照三要素信息，包括姓名、出生日期和证件有效截止日期。

1

CertNo

String

否

证件号码。

当证件类型CertType取值PASSPORT，并且Mode取值为3时，此字段必填。

E123456****

CertName

String

否

证件上的姓名。

张三

Birthday

String

否

证件上的出生日期。

当证件类型CertType取值PASSPORT，并且Mode取值为3时，此字段必填。

1993-10-10

ValidityDate

String

否

证件有效截止日期。

当证件类型CertType取值PASSPORT，并且Mode取值为3时，此字段必填。

2039-06-10

Mobile

String

否

终端用户的手机号码。

1304567****

Ip

String

否

终端用户的IP。

114.112.XX.XX

CallbackToken

String

否

安全Token，由您自行生成，用于防重复、防篡改校验。

如果设置了该值会在回调地址显示CallbackToken字段。

NMjvQanQgplBSaEI0sL86WnQplB

callbackUrl

String

否

认证结果的回调通知地址，必须以HTTPS开头。

https://www.aliyun.com

AuthId

String

否

用户授权ID，最大长度为64位字符。

92d46b9e9e2d703f2897f350d5bd4149

​返回数据

名称

类型

是否必选

描述

示例值

RequestId

String

是

本次请求的ID。

130A2C10-B9EE-4D84-88E3-5384FF03****

Message

String

否

请求消息的响应信息。

success

Code

String

是

返回码。关于返回码的具体内容，请参见返回Code和Message说明。

200

ResultObject.CertifyId

String

否

实人认证唯一标识。客户端通过verify（）函数发起NFC认证的时候需传入该参数。

重要

  • CertifyId字段为计费统计字段，为了方便后续核对账单，请您在本地留存该字段信息。

  • 初始化接口返回的认证CertifyId在30分钟有效且认证仅能提交一次，请您在有效期内使用，避免重复使用。

91707dc296d469ad38e4c5efa6a0****

​返回Code和Message说明

Code

Message

描述

200

success

成功。

400

参数不能为空

参数不能为空。

401

参数非法

非法参数。传入的姓名、身份证号码、证件号长度、出生日期等必须符合国家标准的特殊字符。

402

应用配置不存在

应用配置不存在。

404

认证场景配置不存在

认证场景配置不存在，请先在控制台上创建认证场景。

410

未开通服务

未开通OSS产品或未完成OSS读写授权，请登录控制台完成授权。具体操作，请参见开通及授权OSS存储。

411

RAM无权限

需要给RAM用户授予AliyunAntCloudAuthFullAccess的操作权限。

412

欠费中

金融级NFC认证或OSS存在欠费，请充值后操作。

414

设备不支持NFC

当前移动设备不支持NFC认证，请更换设备后操作。

500

系统错误

系统内部错误，请通过智能在线联系阿里云工程师协助排查。

​

上一篇：服务端API接口下一篇：DescribeFaceVerify－查询NFC认证结果