Integration

client needs to embed our H5 Frontend or Flutter SDK Frontend into your APP first.

How To Integrate

1. Open URL in WebView

After calling the Generate URL API , there will be a url in the response body, and the App needs to open the URL in WebView.

2. Give Camera Permission

Refer to Camera Permission (H5)

Iframe Integration Guide

Refer to Iframe Integration (H5)

Error handling

When an exception occurs blocking the process on the frontend, the frontend will be redirected to the failReturnUrl, carrying the errorCode=XXX, where the errorCode is one of the following enumerated values.

errorCode	Description
NOT_SUPPORT	Not supported due to compatibility issues
CAMERA_ISSUE	Camera issue error
IAM_FAILED	User submits after leaving page open for over 1 hour
ERROR	System error, backend processing exception or network issue
LIVENESS_TRY_COUNT_EXCEED	Liveness detection try count exceeded the limit
LIVENESS_ATTACK	The liveness detection result < 50.0.
SIMILARITY_FAILED	The faceSimilarityScore < 70.0.
FACE_QUALITY_TOO_POOR	Face image quality too low (blurry, insufficient lighting, or wrong angle)
PARAMETER_ERROR	The data submitted by our frontend is not valid. This may indicate a frontend bug.

Compatible Matrices

Supported browsers

Minimal browser versions with support for all features required by H5 Document Verification.

Chrome	Safari	Edge	Opera	iOS Safari	Android Browser	Chrome for Android	Internet Explorer
96	15	93	82	15	81	96	Not supported

Sources:caniuse and WebAssembly Roadmap