ZOLOZZOLOZDOCS

常见问题

本文为您列出了ZOLOZ eKYC SaaS产品相关FAQs。

通用FAQ

RealID支持哪些证件类型？

RealID支持的证件类型，请参见RealID和ID Recognition支持的证件类型和返回的OCR结果。

RealID IDN Lite和IDN有什么区别？

RealID中嵌入的IDN是IDN的精简版，仅包含IDN的部分功能，被称为IDN Lite。如需了解IDN的全部功能，请参见IDN接口文档。

RealID IDN Lite和IDN API存在以下区别：

对比项

IDN Lite

IDN

功能

仅包含IDN的部分功能

包含IDN的所有功能

风险检测

自动启用

需要客户调用才能根据输入确定风险

检索的时间窗口

最近30天

可配置时间窗口，支持全库检索。

风险类型

支持两种Fake ID风险和一种Duplicated ID风险。

Fake ID：

  • Same face different ID numbers
  • Same ID number different faces

Duplicated ID：

  • Same face different ID types

支持六种IDFAKE风险、两种DUPLICATE风险和一种BATCH_REGISTER风险。

IDFAKE：

  • SameFaceDifferentIdNumber
  • SameFaceDifferentPerson
  • SameIdDifferentFace
  • SameIdDifferentPerson
  • SamePersonDifferentFace
  • SamePersonDifferentIdNumber

DUPLICATE：

  • SameFaceDifferentIdType
  • SameFaceDifferentUserId

BATCH_REGISTER：

  • SameFaceBackgroundDifferentFace

数据来源

只支持RealID采集到的用户数据

支持RealID采集到的数据和其他外部数据

库管理

不支持

支持在库里进行添加、删除、检索等操作。

检索速度

慢，因此可检索的时间窗口有限。

快，使用更先进的搜索引擎来提升检索速度。

eKYC结果判定

为什么RealID的Risk Control Result返回为空？

Risk Control Result返回为空，说明未触发风控策略，具体包含以下几种原因：

  • 证件验证或人脸验证失败。
  • 初始化失败。
  • 用户中途取消了身份验证。

SDK&API使用相关

RealID、Face Capture和ID Recognition的serviceLevel参数支持哪些类型？

ZOLOZ通过RealID、Face Capture和ID Recognition提供各种身份验证服务，并通过设置不同的serviceLevel参数值，为API自定义所需的服务级别。

下表列出了RealID、Face Capture和ID Recognition支持的服务级别。

产品

字段名称

描述

参考文档

RealID

serviceLevel

  • REALID0001：要求用户手动拍摄证件照片。ZOLOZ执行基本的防伪检测，以及使用眨眼检测方法进行基本的活体检测。
  • REALID0002：ZOLOZ SDK会自动扫描证件。ZOLOZ执行高等级的防伪检测，以及使用眨眼检测方法进行基本的活体检测。
  • REALID0003：ZOLOZ SDK会自动扫描证件。ZOLOZ执行高等级的防伪检测，并随机使用两个多动作进行活体检测。
    说明：该服务等级仅支持在原生SDK模式下使用。
  • REALID0004：即使身份证件处于倾斜角度，ZOLOZ SDK也会自动扫描证件。ZOLOZ执行基本的防伪检测，以及使用眨眼检测方法进行基本的活体检测。
  • REALID0009：ZOLOZ SDK会自动扫描证件。ZOLOZ执行高等级的防伪检测，以及使用眨眼检测方法进行活体检测。
    说明：该服务等级会额外采集一张闭眼的人脸图片，且该服务等级仅支持在原生SDK模式下使用。
  • REALID0011：ZOLOZ SDK会自动扫描证件。ZOLOZ执行高等级的防伪检测，以及使用眨眼检测方法进行活体检测。
    说明：该服务等级会额外采集一张闭眼的人脸图片，且该服务等级仅支持在Web SDK模式下使用。
  • REALID0012：ZOLOZ SDK会自动扫描证件。ZOLOZ执行基本的防伪检测，以及使用眨眼检测方法进行活体检测。
    说明：该服务等级仅支持在Web SDK模式下使用。

RealID initialize

Face Capture

  • FACECAPTURE0001：ZOLOZ使用无交互人脸活体检测。
  • FACECAPTURE0002：ZOLOZ使用眨眼检测方法进行活体检测。
  • FACECAPTURE0003：ZOLOZ使用多动作检测方法进行活体检测。这些动作从以下列表中随机选择两个：眨眼、张嘴、抬头、低头、左摇头、右摇头。
  • FACECAPTURE0005：ZOLOZ使用眨眼检测方法进行活体检测。该服务等级会额外采集一张闭眼的人脸图片，且该服务等级仅支持在原生SDK模式下使用。
  • FACECAPTURE0010：ZOLOZ使用眨眼检测方法进行活体检测。该服务等级会额外采集一张闭眼的人脸图片，且该服务等级仅支持在Web SDK模式下使用。

Face Capture initialize

ID Recognition

  • IDRECOGNITION0002：基础防伪等级。
  • IDRECOGNITION0003：使用闪光交互模式的高阶防伪等级。该等级仅支持在原生SDK模式下使用。
  • IDRECOGNITION0005：使用多角度交互模式的高阶防伪等级。该等级仅支持在Web SDK模式下使用，且目前该等级仅支持中国香港身份证。

ID Recognition initialize

注意：RealID和Face Capture已支持通过productConfig中的参数进行更灵活的配置，如果设置了下表中的参数值，将优先读取下表中的参数，不再读取serviceLevel和operationMode的值。原有的serviceLevel和operationMode将继续维护，您可以继续使用不会受任何影响。

RealID相关的productConfig参数

下表列出了RealID中productConfig相关的参数及描述，更多详情请参见RealID initialize。

字段名称

数据类型

最大长度

是否必填

默认值

描述

docUiType

String

20

否

  • Native SDK：2
  • Web SDK：1

证件照片的采集方式。取值如下：

  • 1：手拍版（Self-capture），用户需要手动拍摄证件照片，仅具备基础防伪能力。
  • 2：Native防伪版（Deep-scan），仅适用于Native SDK。ZOLOZ SDK将自动对齐并拍摄证件照片，具备拦截彩打等高级防伪能力。
  • 3：H5扫描版（Auto-scan），仅适用于Web SDK。ZOLOZ SDK将自动对齐并拍摄证件照片，仅具备基础防伪能力。
  • 4：甩证版（Trace-scan），仅适用于Native SDK。当ZOLOZ SDK在摄像头范围内检测到证件时将自动拍摄。该版式可用于提升用户体验，但防伪能力较弱，仅具备基础防伪能力。
  • 5：多角度版（Multi-angle），仅适用于Web SDK中的中国香港证件。用户需要分别拍摄正对证件的照片和证件倾斜30°的照片，具备拦截彩打等高级防伪能力。

spoofMode

String

10

否

STANDARD

证件防伪等级。取值如下：

  • CLOSED：所有的防伪算法都未开启。该等级可用于测试场景，测试进程不受算法和风控规则的影响。
  • STANDARD：推荐的标准等级。
  • LOOSE：预留等级，暂不支持使用。
  • STRICT：预留等级，暂不支持使用。

livenessMode

String

10

否

STANDARD

人脸活体检测等级。取值如下：

  • CLOSED：所有的算法和风控规则都未开启。该等级可用于测试场景，测试进程不受算法和风控规则的影响。
  • STANDARD：推荐的标准等级。
  • LOOSE：相对宽松的等级，可用于低风险场景。
  • STRICT：相对严格的等级，可用于高风险场景。

antiInjectionMode

String

10

否

CLOSED

防注入检测等级。防注入检测能够有效抵御使用换脸图片或视频进行的注入攻击。取值如下：

  • CLOSED：所有的防注入算法都不开启。如果业务场景不需要注入攻击检测，则不需要开启。
  • STANDARD：推荐的标准等级。
  • LOOSE：预留等级，暂不支持使用。
  • STRICT：预留等级，暂不支持使用。

注意：开启防注入检测会略微增加误报率和运行时间，开启前请先联系ZOLOZ技术支持。

actionCheckItems

List<String>

-

否

FACEBLINK

客户端和Web端的动作检测列表。取值如下：

  • FACEBLINK：眨眼
  • MOUTHOPEN：张嘴
  • HEADSHAKE：摇头
  • HEADLOWER：低头
  • HEADRAISE：抬头

说明：为了更好的用户体验，不建议使用两种及以上的动作。

actionRandom

String

1

否

N

客户端和Web端的动作检测顺序是否随机。取值如下：

  • Y：随机。
  • N：不随机，则按照actionCheckItems中的顺序进行检测。

actionFrame

List<String>

-

否

空

采集其他帧图片。取值如下：

  • EYECLOSE：闭眼帧。

riskMode

String

10

否

STANDARD

RealID中的多维度风控规则校验，用于拦截可疑交易。取值如下：

  • CLOSED：所有有关风险检测的算法都未开启。该等级可用于测试场景，测试进程不受算法和风控规则的影响。
  • STANDARD：推荐的标准等级。
  • LOOSE：相对宽松的等级，可用于低风险场景。
  • STRICT：相对严格的等级，可用于高风险场景。

idnThreshold

Integer

-

否

3

指定阈值，用于拦截同一商户同脸不同证或同证不同脸的交易，当不同userId之间的关联交易笔数超过指定的阈值时将被拦截。

支持传入大于等于1的任何整数，默认阈值为3。

Face Capture相关的productConfig参数

下表列出了Face Capture中productConfig相关的参数及描述，更多详情请参见Face Capture initialize。

字段名称

数据类型

最大长度

是否必填

默认值

描述

livenessMode

String

10

否

STANDARD

人脸活体检测等级。取值如下：

  • CLOSED：所有的算法和风控规则都未开启。该等级可用于测试场景，测试进程不受算法和风控规则的影响。
  • STANDARD：推荐的标准等级。
  • LOOSE：相对宽松的等级，可用于低风险场景。
  • STRICT：相对严格的等级，可用于高风险场景。

antiInjectionMode

String

10

否

CLOSED

防注入检测等级。防注入检测能够有效抵御使用换脸图片或视频进行的注入攻击。取值如下：

  • CLOSED：所有的防注入算法都不开启。如果业务场景不需要注入攻击检测，则不需要开启。
  • STANDARD：推荐的标准等级。
  • LOOSE：预留等级，暂不支持使用。
  • STRICT：预留等级，暂不支持使用。

注意：开启防注入检测会略微增加误报率和运行时间，开启前请先联系ZOLOZ技术支持。

actionCheckItems

List<String>

-

否

FACEBLINK

客户端和Web端的动作检测列表。取值如下：

  • FACEBLINK：眨眼
  • MOUTHOPEN：张嘴
  • HEADSHAKE：摇头
  • HEADLOWER：低头
  • HEADRAISE：抬头

说明：为了更好的用户体验，不建议使用两种及以上的动作。

actionRandom

String

1

否

N

客户端和Web端的动作检测顺序是否随机。取值如下：

  • Y：随机。
  • N：不随机，则按照actionCheckItems中的顺序进行检测。

actionFrame

List<String>

-

否

空

采集其他帧图片。取值如下：

  • EYECLOSE：闭眼帧。

为什么通过App接入Web SDK无法打开或无法正常使用拍摄功能？

问题描述：在App中接入Web SDK，部分手机型号或操作系统会遇到无法打开或无法正常使用拍摄功能的问题。

可能原因：Web SDK必须在App的WebView容器中打开，而WebView的内核和手机操作系统相互绑定，部分手机型号或操作系统的WebView对拍摄功能有限制，从而导致拍摄功能无法打开或无法正常使用。

解决方法：

  • 解决方法一：建议用户跳转手机浏览器后再进行操作。
  • 解决方法二：建议您使用Native SDK接入方式，以便在App中正常使用拍摄功能。

如何隐藏Native SDK的人脸引导页标题栏？

解决方法如下：

  • Android SDK：将附件📎UI.JSON添加到项目的assets目录中，即可隐藏人脸引导页的标题栏。
  • iOS SDK：在人脸引导页的URL中添加hiddenTitleBar参数，并将hiddenTitleBar的取值设置为true（默认为false），例如http://url-to-face-guide-page.html?hiddenTitleBar=true。

注意：如果设置了隐藏人脸引导页的标题栏，ZOLOZ的返回按钮也将一起被隐藏，此时需要您在H5页面内添加一个自定义的返回按钮，并按要求实现事件，详细集成步骤请参见为RealID定制人脸自拍引导页。

ZOLOZ Portal相关

为什么Portal上有时无法显示上传的图片？

针对ID Recognition和Face Compare这两款产品，当采用纯API接入模式接入并上传PNG格式的图片时，需要关闭图片的Alpha通道，否则会导致图片在Portal上无法显示。

关闭PNG图片的Alpha通道的方法如下：

上传PNG图片时，在Mac电脑上双击打开PNG图片（使用Mac自带的“预览”软件打开图片），选择文件 > 导出，找到并关闭Alpha通道，如下图所示。

image.png

说明：上述方法仅适用于Mac设备，Windows设备系统没有自带开启和关闭Alpha通道的功能，如果客户使用Windows设备上传图片，需自行通过图片处理软件来关闭PNG图片的Alpha通道。