全部產品

Financial Intelligence Engine：H5 Demo使用指南

更新時間：Jan 04, 2025

ZOLOZ H5 Demo現已全面支援ZOLOZ的核心產品，包括Real ID、Face Capture和ID Recognition，可為您提供安全、便捷的身份認證解決方案。

支援的產品

通過ZOLOZ H5 Demo，您可以免費試用及體驗以下產品：

Real ID
Face Capture
ID Recognition

RealID

聯絡ZOLOZ BD團隊並提供您的電子郵箱，擷取H5 Demo連結。
進入Demo體驗頁面，在RealID右側單擊Verify Now，進入Real ID流程引導頁面。
在Real ID流程引導頁面，單擊Start，設定證件和人臉採集相關功能。
1. 在Choose ID Type頁面，選擇證件對應的國家或地區、證件類型，單擊Take ID Picture。
2. 在Select verification level頁面，根據下表推薦的配置設定採集方式和功能相關參數。

欄位名稱	功能說明
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. 證件採集：根據頁面提示，將證件對準採集框進行採集。
2. 人臉採集：人臉正對手機螢幕，根據頁面提示完成相應動作進行採集。

採集成功後查看eKYC的驗證結果。

欄位名稱	結果說明
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

聯絡ZOLOZ BD團隊並提供您的電子郵箱，擷取H5 Demo連結。
進入Demo體驗頁面，在Face Capture右側單擊Verify Now，進入Set Verification Parameters頁面。
在Set Verification Parameters頁面，根據下表推薦的配置設定功能相關參數。

欄位名稱	功能說明
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支援人員開通，以便啟用該功能。

在Verify Face頁面，將人臉正對手機螢幕，根據頁面提示完成相應動作採集人臉圖片。
採集成功後查看人臉驗證結果。

欄位名稱	結果說明
Verification Result	人臉採集總結果，可能返回以下值： `Success`：人臉品質總結果及活體檢測均通過。 `Failure`：本次認證存在較高風險，建議拒絕，例如人臉品質總結果或人臉活體檢測不通過。 `VoidTimeout`：未獲得人臉採集結果，人臉採集逾時。 `InProcess`：未獲得人臉採集結果，正在採集中。
Quality Score	人臉品質分數，分值範圍0-100，分值越高人臉圖片的品質越好。
Quality Passed	人臉品質總結果。人臉品質檢測支援檢測多個模組，包含人臉品質分、口罩檢測、遮擋檢測，預設檢測人臉品質分（人臉是否清晰、完整等），可根據您的實際業務需求開啟更多檢測項。 `true`：品質檢測通過。 `false`：品質檢測不通過，人臉品質分或其他檢測模組存在不通過項。
Face Attack	人臉活體檢測結果，可能返回以下值： `true`：人臉活體檢測失敗，可能存在偽造人臉攻擊。 `false`：人臉活體檢測通過。說明：當Quality Passed的值為`false`時，該欄位的傳回值為null。

ID Recognition

聯絡ZOLOZ BD團隊並提供您的電子郵箱，擷取H5 Demo連結。
進入Demo體驗頁面，在ID Recognition右側單擊Verify Now，進入Choose ID Type頁面。
在Choose ID Type頁面，選擇證件對應的國家或地區、證件類型，單擊Take ID Picture。
在Set Verification Parameters頁面，根據下表推薦的配置設定採集方式和操作模式。

欄位名稱

功能說明

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功能。

在Verify Identity頁面，根據頁面提示，將證件對準採集框採集證件圖片。
採集成功後查看證件驗證結果。

欄位名稱	結果說明
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識別結果，該結果中展示了從證件上識別到的欄位資訊。