常见问题
本文为您列出了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:
Duplicated ID:
| 支持六种IDFAKE风险、两种DUPLICATE风险和一种BATCH_REGISTER风险。 IDFAKE:
DUPLICATE:
BATCH_REGISTER:
|
数据来源 | 只支持RealID采集到的用户数据 | 支持RealID采集到的数据和其他外部数据,但均需要调用add接口录入。 |
库管理 | 不支持 | 支持在库里进行添加、删除、检索等操作。 |
检索速度 | 慢,因此可检索的时间窗口有限。 | 快,使用更先进的搜索引擎来提升检索速度。 |
调用隐私删除API可以删除哪些数据?
隐私删除API可以删除以下三类数据:
- OCR信息,例如证件ID、姓名等。
- 采集的证件和人脸照片数据,例如返回的人脸图片(faceImg)、额外需要返回的图片(extraImages)、证件的正面照(frontPageImg)、证件的背面照(backPageImg)等。
- RealID IDN Lite相关数据,且IDN Lite无法再处理或访问已经被隐私删除API删除的相关数据。
证件图片采集有什么要求?
ZOLOZ对采集的证件图片的大小和质量有一定要求,按要求完成采集可以有效提升证件图片的采集成功率。
采集要求 | 详细描述 |
证件完整入框 | 确保证件的四个角点和边都在采集框内。 |
证件图片清晰 | 确保证件图片清晰可辨,没有模糊区域。 |
光线充足 | 确保采集环境光线充足,以便有效识别证件上的信息。采集环境太亮或太暗,可能会影响验证效果。 |
避免反光 | 避免灯光或环境光的反射,证件图片上的反光会干扰数据的处理和提取。 |
避免遮挡 | 确保证件无任何遮挡物,证件上的信息完全可见。 |
避免倾斜 | 确保拍摄的证件在水平和垂直方向都保持完全平整,无任何倾斜。 |
距离适中 | 请将证件的四条边与扫描框对齐,距离太远或太近都会影响采集结果。 |
合适的倾斜角度(仅适用于多角度版) | 请将证件的四条边与倾斜的扫描框对齐,倾斜角度通常不超过30度。 |
eKYC结果判定
防伪检测不通过的交易,其状态为何为Pending而非Failure?
因防伪检测不通过而被判定为Pending的交易,如果直接将其判定为Failure,极可能导致合法的交易被误拦截,因为防伪检测不通过的交易可能存在一定的误判率,例如在光线不足或者部分证件信息模糊等情况下,系统难以做出精准判断。因此,将交易状态标记为Pending,以便通过人工审核对这些疑似误判的交易进行进一步的核实与确认,确保判断的准确性,从而以尽可能低的误判率来保护客户的利益。
为什么RealID的Risk Control Result返回为空?
Risk Control Result返回为空,说明未触发风控策略,具体包含以下几种原因:
- 证件验证或人脸验证失败。
- 初始化失败。
- 用户中途取消了身份验证。
SDK&API使用相关
如何更新ZOLOZ SDK?
不同平台的SDK的更新步骤不相同,通常情况下您可以参考以下内容更新ZOLOZ SDK。
Android SDK更新
- 打开Gradle配置文件。
在您的Android项目中找到app/build.gradle
文件,可参考Android客户端接入。 - 更新SDK依赖。
找到包含ZOLOZ SDK的代码行,并将其更新为新的版本号。例如:
implementation 'com.zoloz.android.build:zolozkit:latest-version'
说明:请将latest-version替换为您希望更新到的实际版本号。建议您使用最新版SDK,可提升产品体验和安全性。版本发布说明,请参见Release Notes。
- 同步项目。
编辑build.gradle
文件后,您需要同步项目以更新Gradle文件。
iOS SDK更新
- 配置SDK依赖。
- 在Podfile中配置私有规范。
source "https://github.com/zoloz-pte-ltd/zoloz-demo-ios"
- 在Podfile中添加SDK依赖。
#zolozkit变更日志:https://docs.zoloz.com/zoloz/saas/releasenotes/
# #建议您使用最新版SDK,其包含了新功能并在安全方面进行了改进。如果您需要有关特定版本的更多信息,请查看变更日志。
pod 'zolozkit' #核心模块
pod 'zolozkit/ZolozNfcReader' #NFC Reader模块
说明:代码pod 'zolozkit/ZolozNfcReader'
对应NFC功能,如需开通该功能,请联系ZOLOZ技术支持;如果不需要使用该功能,则无需添加对应的代码。
- 更新Pod。
运行以下命令更新SDK。
pod update
- 处理错误。
常见错误:如果您在更新过程中遇到以下错误。处理方法:使用以下任意一种命令更新本地仓库索引,然后再次尝试更新。
pod install --repo-update
pod repo update
- 完成更新。
Web SDK更新
Web SDK和Android SDK、iOS SDK的更新不同,如果系统检测到新版本,Web SDK会自动进行更新,无需您手动更改代码库。
为什么在拒绝Face Capture的传感器访问权限后,Web SDK无法打开人脸采集页面?
开启Face Capture-Deeper后,ZOLOZ会访问手机的传感器权限,由于iOS系统限制,当用户拒绝为ZOLOZ授予传感器权限后,Web SDK无法再打开人脸采集页面,客户可根据收到的返回码重启WebView或提示用户重启浏览器重新进行授权。具体返回码,请参见ZLZResponse。
RealID、Face Capture和ID Recognition的serviceLevel参数支持哪些类型?
ZOLOZ通过RealID、Face Capture和ID Recognition提供各种身份验证服务,并通过设置不同的serviceLevel参数值,为API自定义所需的服务级别。
下表列出了RealID、Face Capture和ID Recognition支持的服务级别。
产品 | 字段名称 | 描述 | 参考文档 |
RealID | serviceLevel |
| |
Face Capture |
| ||
ID Recognition |
|
注意:RealID和Face Capture已支持通过productConfig中的参数进行更灵活的配置,如果设置了下表中的参数值,将优先读取下表中的参数,不再读取serviceLevel和operationMode的值。原有的serviceLevel和operationMode将继续维护,您可以继续使用不会受任何影响。
RealID相关的productConfig参数
下表列出了RealID中productConfig相关的参数及描述,更多详情请参见RealID initialize。
字段名称 | 数据类型 | 最大长度 | 是否必填 | 默认值 | 描述 |
docUiType | String | 20 | 否 |
| 证件照片的采集方式。取值如下:
|
spoofMode | String | 10 | 否 | STANDARD | 证件防伪等级。取值如下:
|
livenessMode | String | 10 | 否 | STANDARD | 人脸活体检测等级。取值如下:
|
antiInjectionMode | String | 10 | 否 | CLOSED | 该参数已废弃,后续不再维护,为了保证API兼容性,该参数会继续保留。 防注入检测等级。防注入检测能够有效抵御使用换脸图片或视频进行的注入攻击。取值如下:
注意:开启防注入检测会略微增加误报率和运行时间,开启前请先联系ZOLOZ技术支持。 |
actionCheckItems | List<String> | - | 否 | FACEBLINK | 客户端和Web端的动作检测列表。取值如下:
说明:为了更好的用户体验,不建议使用两种及以上的动作。 |
actionRandom | String | 1 | 否 | N | 客户端和Web端的动作检测顺序是否随机。取值如下:
|
actionFrame | List<String> | - | 否 | 空 | 采集其他帧图片。取值如下:
|
riskMode | String | 10 | 否 | STANDARD | RealID中的多维度风控规则校验,用于拦截可疑交易。取值如下:
|
idnThreshold | Integer | - | 否 | 3 | 该参数已废弃,后续不再维护,为了保证API兼容性,该参数会继续保留。 指定阈值,用于拦截同一商户同脸不同证或同证不同脸的交易,当不同userId之间的关联交易笔数超过指定的阈值时将被拦截。 支持传入大于等于1的任何整数,默认阈值为3。 |
Face Capture相关的productConfig参数
下表列出了Face Capture中productConfig相关的参数及描述,更多详情请参见Face Capture initialize。
字段名称 | 数据类型 | 最大长度 | 是否必填 | 默认值 | 描述 |
livenessMode | String | 10 | 否 | STANDARD | 人脸活体检测等级。取值如下:
|
antiInjectionMode | String | 10 | 否 | CLOSED | 该参数已废弃,后续不再维护,为了保证API兼容性,该参数会继续保留。 防注入检测等级。防注入检测能够有效抵御使用换脸图片或视频进行的注入攻击。取值如下:
注意:开启防注入检测会略微增加误报率和运行时间,开启前请先联系ZOLOZ技术支持。 |
actionCheckItems | List<String> | - | 否 | FACEBLINK | 客户端和Web端的动作检测列表。取值如下:
说明:为了更好的用户体验,不建议使用两种及以上的动作。 |
actionRandom | String | 1 | 否 | N | 客户端和Web端的动作检测顺序是否随机。取值如下:
|
actionFrame | List<String> | - | 否 | 空 | 采集其他帧图片。取值如下:
|
为什么通过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定制人脸自拍引导页。