Documentation

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.

whenignoreFailWhenJump set to true, will jump to returnUrl instead.

SIMILARITY_FAILED

The faceSimilarityScore < 70.0.
whenignoreFailWhenJump set to true, will jump to returnUrl instead.

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.

ChromeSafariEdgeOperaiOS SafariAndroid BrowserChrome for AndroidInternet Explorer
96159382158196Not supported

Sources:caniuse and WebAssembly Roadmap

Others