Frontend Integration(H5)
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 |
|---|---|
BROWSER_ISSUE | Not supported due to compatibility issues |
DOCUMENT_AUTO_SCAN_TRY_COUNT_EXCEED | Document auto-scan try count exceeded the limit |
DOCUMENT_MANUAL_TRY_COUNT_EXCEED | Document manual photo try count exceeded the limit |
NO_PERMISSION | No camera permission |
CAMERA_ISSUE | Camera issue error |
RESELECT_DOC_TYPE | User clicked to reselect document type |
LIVENESS_TRY_COUNT_EXCEED | Liveness detection try count exceeded the limit |
NOT_SUPPORT | Browser not supported |
LIVENESS_ATTACK | The liveness detection result < 50.0. whenignoreFailWhenJump set to true, will jump to returnUrl instead. |
SIMILARITY_FAILED | The faceSimilarityScore < 70.0. |
NO_SUPPORTED_CARD | The card type detected from the document image is not supported. |
NO_SUPPORTED_CARD_CUSTOMIZED | The card type is known but not supported currently. maybe support in the future. |
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
Others
Updated 12 days ago