本文介绍如何通过调用InitFaceVerify接口发起金融级NFC认证请求。
发起认证请求
接口名：InitFaceVerify。
全局接入地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）
请求方法：POST和GET。
传输协议：HTTPS。
接口说明：每次开始认证前通过本接口获取CertifyId，用来串联认证请求中的各个接口。
QPS限量：API独享QPS限量，详情请参见服务端接口QPS限量说明。
请求参数
名称 | 类型 | 是否必选 | 描述 | 示例值 |
SceneId | Long | 是 | 认证场景ID。该ID在控制台创建认证场景后自动生成。关于如何创建认证场景，请参见添加认证场景。 | 100000**** |
OuterOrderNo | String | 是 | 您自定义的业务唯一标识，用于后续定位排查问题使用。支持最长为32位长度的字母和数字组合，请确保唯一。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
ProductCode | String | 是 | 认证方案。 唯一取值：NFC_QY。 | NFC_QY |
UserId | String | 是 | 您自定义的用户ID，请保持唯一。 | 12345**** |
CertType | String | 是 | 证件类型。 说明 当前仅支持护照认证。 | PASSPORT |
ReadImg | String | 是 | 是否读取证件照片。 Y：读取。 N：不读取。 说明 如果在后续认证环节需要使用证件人脸照片，此处建议入参为Y。 | Y |
MetaInfo | String | 是 | MetaInfo环境参数。需要通过客户端SDK获取，详情请参见App（SDK）接入。 |
说明 示例仅供参考，实际集成中不能直接应用，具体参考SDK集成说明获取。 |
Mode | String | 否 | 获取护照NFC核验要素方式：
说明 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认证的时候需传入该参数。 重要
| 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认证，请更换设备后操作。 |
418 | NFC失败次数过多 | NFC认证失败次数过多。 |
500 | 系统错误 | 系统内部错误，请通过智能在线联系阿里云工程师协助排查。 |