ZOLOZZOLOZDOCS

H5 Demo使用指南

ZOLOZ H5 Demo现已全面支持ZOLOZ的核心产品，包括RealID、Face Capture和ID Recognition，可为您提供安全、便捷的身份认证解决方案。

支持的产品

通过ZOLOZ H5 Demo，您可以免费试用及体验以下产品：

RealID

  1. 联系ZOLOZ BD团队并提供您的电子邮箱，获取H5 Demo链接。
  2. 进入Demo体验页面，在RealID右侧单击Verify Now，进入RealID流程引导页面。
    1.PNG
  3. 在RealID流程引导页面，单击Start，设置证件和人脸采集相关功能。
    4f0dad9b836170ad39b6a0d217e799fd.jpg
    1. 在Choose ID Type页面，选择证件对应的国家或地区、证件类型，单击Take ID Picture。
      490fb25f3cc50f2d9c8f5fb3fe21a52a.jpg
    2. 在Select verification level页面，根据下表推荐的配置设置采集方式和功能相关参数。
      image.png

字段名称

功能说明

Capture Mode

证件采集方式。

  • Self Capture：手拍版，仅具备基本防伪能力。用户需要根据页面提示将证件对准采集框，手动拍摄证件照片并确认照片是否清晰。
  • Auto Capture：扫描版，仅H5端支持，具备高级防伪能力。用户将证件对准采集框后，ZOLOZ会自动拍摄证件照片并上传。
  • Multi Angle：多角度版，仅H5端支持，且仅适用于中国香港一二代身份证，具备高级防伪能力。用户需要分别拍摄正对证件的照片和证件倾斜30°角的照片。

Spoof Mode

证件防伪模式。

  • Closed：所有的防伪算法都未开启，该模式可用于测试场景，测试进程不受算法和风控规则的影响。
  • Standard：推荐的标准模式，该模式开启了证件防伪检测算法。
  • Loose：保留值，暂不支持使用。
  • Strict：保留值，暂不支持使用。

Action Check Items

人脸采集动作。

  • FACEBLINK：眨眼
  • MOUTHOPEN：张嘴
  • HEADSHAKE：向左或向右摇头（随机）
  • HEADLOWER：低头
  • HEADRAISE：抬头

Action Random

人脸采集的动作检测顺序是否随机。

  • Y：随机。
  • N：不随机，按照Action Check Items中的顺序进行检测。

Action Frame

额外采集的其他帧图片，目前仅支持Eye Close，表示闭眼帧。该图片会在checkResult API中返回。

说明：在H5 Demo中设置该参数不会影响防伪能力测试。

Liveness Mode

人脸活体检测模式。

  • Closed：不开启人脸活体检测算法。
  • Standard：推荐的标准模式，该模式开启了人脸活体检测算法。
  • Loose：相对宽松的模式，可用于低风险场景。
  • Strict：相对严格的模式，可用于高风险场景。

AntiInjection Mode

人脸防注入检测模式。

  • Closed：不开启人脸防注入检测算法。
  • Standard：推荐的标准模式，该模式开启了人脸防注入检测算法。
  • Loose：保留值，暂不支持使用。
  • Strict：保留值，暂不支持使用。

说明：AntiInjection Mode为试用功能，请先联系ZOLOZ技术支持开通，以便激活该功能。

Risk Mode

风控模式。

  • Closed：不开启风险检测算法。
  • Standard：推荐的标准模式，该模式开启了风险检测算法。
  • Loose：相对宽松的模式，可用于低风险场景。
  • Strict：相对严格的模式，可用于高风险场景。

Idn Threshold

IDN的阈值，支持设置大于0的任何整数，可用于拦截同一商户同脸不同证或同证不同脸的交易，当不同userId之间的关联交易笔数超过指定的阈值时将被拦截。

  1. 采集证件和人脸图片。
    1. 证件采集：根据页面提示，将证件对准采集框进行采集。
      da5af3feea5165fb30eb50f967abadd9.jpg
    2. 人脸采集：人脸正对手机屏幕，根据页面提示完成相应动作进行采集。
      506350213d141e1afdb68f64eeb14203.jpg 2010563b4faddaf415e01c47a45311b8.jpg
  1. 采集成功后查看eKYC的验证结果。
    image.png

字段名称

结果说明

ekycResult

eKYC总结果，可能返回以下值：

  • Success：身份验证通过。
  • Pending：身份验证结果待人工审核。
  • Failure：身份验证失败，可能是证件验证、人脸验证或风控处理失败导致。

ekycResultDoc

证件模块的验证结果，可能返回以下值：

  • Success：证件验证通过。
  • Pending：证件验证结果待人工审核。
  • Failure：证件验证失败。

spoofResult

证件防伪检测结果，可能返回以下值：

  • Y：证件防伪检测通过。
  • N：证件防伪检测失败。

以下是返回的证件防伪检测细项结果，Y表示检测通过，N表示检测不通过。不同的证件类型检测项目有所不同，因此返回的检测结果项也不同。ZOLOZ支持的所有防伪检测项如下：

  • SCREEN_RECAPTURE_CHECK：屏幕翻拍检测。
  • INFORMATION_CHECK：信息校验检测，仅支持对中国香港一二代身份证上的id、name、symbol进行检测，并返回检测结果；其他证件则会返回OTHER_CHECK字段。
  • MATERIAL_CHECK：材质检测。
  • SECURITY_FEATURE_CHECK：防伪安全特征检测，仅支持对中国香港一二代身份证和马来西亚大马卡的安全特征进行检测，并返回检测结果；其他证件则会返回OTHER_CHECK字段。
  • TAMPER_CHECK：遮挡篡改检测。

ekycResultFace

人脸模块的验证结果，可能返回以下值：

  • Success：人脸验证通过。
  • Pending：人脸验证结果待人工审核。
  • Failure：人脸验证失败。

faceScore

活体人脸与证件脸的比对分数，分值范围0-100，分值越高相似度越高。

faceQuality

人脸质量分数，分值范围0-100，分值越高人脸图片的质量越好。

faceLivenessResult

人脸活体检测结果，可能返回以下值：

  • Success：人脸活体检测通过。
  • Failure：人脸活体检测失败，可能存在伪造人脸攻击。

ekycResultRisk

风控模块的验证结果，可能返回以下值：

  • Success：风险控制验证通过。
  • Pending：风险控制结果待人工审核。
  • Failure：风险控制验证失败。

idNetworkDetails

IDN输出的详细信息，当strategyPassResult返回ID_NETWORK_HIGH_RISK时才返回该字段，详见ExtRiskInfo。

strategyPassResult

风险检测结果明细，可能返回以下值：

  • PASS：风险检测通过。
  • VELOCITY_HIGH_RISK：风控引擎检测到高风险。
  • ID_NETWORK_HIGH_RISK：检测到多笔交易存在IDN风险，例如同脸不同证、同证不同脸的情况。
  • BLACKLIST_HIGH_RISK：检测到命中黑名单。
  • AGE_MISMATCH_HIGH_RISK：检测到活体人脸与证件脸年龄相差过大。

OCR_Result

OCR识别结果，该结果中展示了从证件上识别到的字段信息。

Face Capture

  1. 联系ZOLOZ BD团队并提供您的电子邮箱，获取H5 Demo链接。
  2. 进入Demo体验页面，在Face Capture右侧单击Verify Now，进入Set Verification Parameters页面。1.PNG
  3. 在Set Verification Parameters页面，根据下表推荐的配置设置功能相关参数。
    04cc0eb00ee4d323230c93aa9e4a8684.jpg

字段名称

功能说明

Action Check Items

人脸采集动作。

  • FACEBLINK：眨眼
  • MOUTHOPEN：张嘴
  • HEADSHAKE：向左或向右摇头（随机）
  • HEADLOWER：低头
  • HEADRAISE：抬头

Action Random

人脸采集的动作检测顺序是否随机。

  • Y：随机。
  • N：不随机，按照Action Check Items中的顺序进行检测。

Action Frame

额外采集的其他帧图片，目前仅支持Eye Close，表示闭眼帧。该图片会在checkResult API中返回。

说明：在H5 Demo中设置该参数不会影响防伪能力测试。

Liveness Mode

人脸活体检测模式。

  • Closed：不开启人脸活体检测算法。
  • Standard：推荐的标准模式，该模式开启了人脸活体检测算法。
  • Loose：相对宽松的模式，可用于低风险场景。
  • Strict：相对严格的模式，可用于高风险场景。

AntiInjection Mode

人脸防注入检测模式。

  • Closed：不开启人脸防注入检测算法。
  • Standard：推荐的标准模式，该模式开启了人脸防注入检测算法。
  • Loose：保留值，暂不支持使用。
  • Strict：保留值，暂不支持使用。

说明：AntiInjection Mode为试用功能，请先联系ZOLOZ技术支持开通，以便激活该功能。

  1. 在Verify Face页面，将人脸正对手机屏幕，根据页面提示完成相应动作采集人脸图片。
    41d049e4333a778ffb224267e0605f29.jpg
  2. 采集成功后查看人脸验证结果。
    image.png

字段名称

结果说明

Verification Result

人脸采集总结果，可能返回以下值：

  • Success：人脸质量总结果及活体检测均通过。
  • Failure：本次认证存在较高风险，建议拒绝，例如人脸质量总结果或人脸活体检测不通过。
  • VoidTimeout：未获得人脸采集结果，人脸采集超时。
  • InProcess：未获得人脸采集结果，正在采集中。

Quality Score

人脸质量分数，分值范围0-100，分值越高人脸图片的质量越好。

Quality Passed

人脸质量总结果。人脸质量检测支持检测多个模块，包含人脸质量分、口罩检测、遮挡检测，默认检测人脸质量分（人脸是否清晰、完整等），可根据您的实际业务需求开启更多检测项。

  • true：质量检测通过。
  • false：质量检测不通过，人脸质量分或其他检测模块存在不通过项。

Face Attack

人脸活体检测结果，可能返回以下值：

  • true：人脸活体检测失败，可能存在伪造人脸攻击。
  • false：人脸活体检测通过。

说明：当Quality Passed的值为false时，该字段的返回值为null。

ID Recognition

  1. 联系ZOLOZ BD团队并提供您的电子邮箱，获取H5 Demo链接。
  2. 进入Demo体验页面，在ID Recognition右侧单击Verify Now，进入Choose ID Type页面。
    1.PNG
  3. 在Choose ID Type页面，选择证件对应的国家或地区、证件类型，单击Take ID Picture。
    309b68340a8217126cf9cd7e51f904c6.jpg
  4. 在Set Verification Parameters页面，根据下表推荐的配置设置采集方式和操作模式。
    177bad27a3e23abfd1d885a02dbd0072.jpg

字段名称

功能说明

Capture Mode

证件采集方式。

  • Self Capture：手拍版，仅具备基本防伪能力。用户需要根据页面提示将证件对准采集框，手动拍摄证件照片并确认照片是否清晰。
  • Auto Capture：扫描版，仅H5端支持，具备高级防伪能力。用户将证件对准采集框后，ZOLOZ会自动拍摄证件照片并上传。
  • Multi Angle：多角度版，仅H5端支持，且仅适用于中国香港一二代身份证，具备高级防伪能力。用户需要分别拍摄正对证件的照片和证件倾斜30°角的照片。

Operation Mode

身份验证的操作模式。

  • Closed：所有的算法和风控规则都未开启，该操作模式可用于测试场景，测试进程不受算法和风控规则的影响。
  • Standard：推荐的标准模式。
  • Loose：相对宽松的模式，可用于低风险场景。
  • Strict：相对严格的模式，可用于高风险场景。
  • Standard Risk Level 1：关闭Velocity功能。
  • Standard Risk Level 2：关闭IDN功能。
  • Standard Risk Level 3：关闭Velocity和IDN功能。
  1. 在Verify Identity页面，根据页面提示，将证件对准采集框采集证件图片。
    26d8db8591965fa59f517be3ef037c59.jpg
  2. 采集成功后查看证件验证结果。
    image.png

字段名称

结果说明

ekycResult

证件验证总结果，可能返回以下值：

  • Y：证件验证通过。
  • N：证件验证失败。

spoofResult

证件防伪检测结果，可能返回以下值：

  • Y：证件防伪检测通过。
  • N：证件防伪检测失败。

以下是返回的证件防伪检测细项结果，Y表示检测通过，N表示检测不通过。不同的证件类型检测项目有所不同，因此返回的检测结果项也不同。ZOLOZ支持的所有防伪检测项如下：

  • SCREEN_RECAPTURE_CHECK：屏幕翻拍检测。
  • INFORMATION_CHECK：信息校验检测，仅支持对中国香港一二代身份证上的id、name、symbol进行检测，并返回检测结果。
  • MATERIAL_CHECK：材质检测。
  • SECURITY_FEATURE_CHECK：防伪安全特征检测，仅支持对中国香港一二代身份证和马来西亚大马卡的安全特征进行检测，并返回检测结果。
  • TAMPER_CHECK：遮挡篡改检测。

OCR_Result

OCR识别结果，该结果中展示了从证件上识别到的字段信息。