> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/verify/kyc-web-sdk/integration/frontend-integration/workflow-configuration.md).

# Workflow Configuration

To customize the identity verification workflow behavior.

| Parameter                                            | Type                                                                                                                                                                                       | Required | Description                                                                                                                                                                                                                                                                                                                                                                 |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ----------------------- | ------------------------------------------------------------------- | ----------------------------- | ----------------------------- | --------------------------------- | ----------------------------- | ---------------------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------ | ------------------------- | ------------- | --------------------------------------------------------------------------------------------------------------- |
| `userConsent`                                        | <p><code>object</code></p><p><code>{ obtained: true obtainedAt: Date.now() }</code></p>                                                                                                    | No       | Mandatory to pass this if `skipIntroductionScreen` & `skipDocSelectionScreen` both are set to `true` . Indicates that the user consent is obtained by the customer application.                                                                                                                                                                                             |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `documentType`                                       | <p><code>string</code><br>Allowed values :<br>Malaysia<br><code>'MyKad'                                                                                                                    | 'MyKas'  | 'MyPR'                                                                                                                                                                                                                                                                                                                                                                      | 'MyTentera' | DRIVING\_LICENSE</code> | <code>PASSPORT</code></p><p>Philippines<br><code>Philsys\_ID</code> | <code>Multipurpose\_ID</code> | <code>Professional\_ID</code> | <code>Social\_Security\_ID</code> | <code>DRIVING\_LICENSE</code> | <code>PASSPORT</code><br><br>Indonesia<br><code>KTP</code> | <code>DRIVING\_LICENSE</code> | <code>PASSPORT</code><br><br>Thailand, Singapore, Vietnam<br><code>DRIVING\_LICENSE</code> | <code>PASSPORT</code></p> | <p><br>No</p> | Mandatory to pass if `skipDocSelectionScreen` is set to true. Indicated the type of document the user will use. |
| `skipFaceMatch`                                      | `boolean`                                                                                                                                                                                  | No       | Skips performing Face Match if set to `true` . Set this to true , if you want to perform only document verification.                                                                                                                                                                                                                                                        |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `docVerification.skipIntroductionScreen`             | `boolean`                                                                                                                                                                                  | No       | Skips the introduction screen if set to `true`.                                                                                                                                                                                                                                                                                                                             |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `docVerification.skipDocSelectionScreen`             | `boolean`                                                                                                                                                                                  | No       | Skips the document selection screen if set to `true`.                                                                                                                                                                                                                                                                                                                       |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `docVerification.skipTutorialScreen`                 | `boolean`                                                                                                                                                                                  | No       | Skips the doc capture tutorial screen if set to `true`.                                                                                                                                                                                                                                                                                                                     |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `docVerification.maxRetryAttempts`                   | `number`                                                                                                                                                                                   | No       | Maximum number of retry attempts for Document Verification BE API call , allowed. Default is 3.                                                                                                                                                                                                                                                                             |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `docVerification.captureTimeOut`                     | `number`                                                                                                                                                                                   | No       | Timeout in milliseconds for document capture. Default is `120000` milliseconds. If user doesn’t capture within this, process will terminate.                                                                                                                                                                                                                                |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `docVerification.captureTimeOutCountdownDuration`    | `number`                                                                                                                                                                                   | No       | Timeout in milliseconds for document capture countdown. If you pass 30000 countdown will be shown for last 30 seconds . Default is for last 20000 ms (20 seconds) **- NEW**                                                                                                                                                                                                 |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `docVerification.hideDetectionTimeOutCountdownAlert` | `boolean`                                                                                                                                                                                  | No       | pass this true if countdown alert needs to be hidden . Default is false **- NEW**                                                                                                                                                                                                                                                                                           |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `docVerification.skipDocBackSideCapture`             | `boolean`                                                                                                                                                                                  | No       | pass this true if you do not want document back side capture and verification. Back side is supported only for Malaysian Cards - `MyKad`, `MyKas`, `MyPR`, `MyTentera`                                                                                                                                                                                                      |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `docVerification.hideDescriptions`                   | <p><code>object</code></p><p><code>hideDescriptions: { idvIntroduction: false, documentSelection: false, cameraAccess: false, documentCapture: true, documentPreview: false, },</code></p> | No       | <p>If any of these not passed, by default description will be shown in all screens. Pass <code>true</code> to hide page description from the screen.</p><p>idvIntroduction - Introduction<br>documentSelection - Document Selection<br>cameraAccess - camera access screen<br>documentCapture - Document capture screen</p><p>documentPreview - Document Preview screen</p> |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `faceMatch.skipTutorialScreen`                       | `boolean`                                                                                                                                                                                  | No       | Skips the selfie capture tutorial screen if set to `true`.                                                                                                                                                                                                                                                                                                                  |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `faceMatch.cameraFrameShape`                         | `FRAME_SHAPE`                                                                                                                                                                              | No       | Shape of the camera frame overlay. Possible values:`"OVAL"`, `"CIRCLE"`, `"SQUARE"` & `"RECTANGLE"` . Defaults to `"OVAL"`                                                                                                                                                                                                                                                  |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `faceMatch.maxRetryAttempts`                         | `number`                                                                                                                                                                                   | No       | Maximum number of retry attempts for Liveness + FaceMatch BE API call , allowed. Default is 3.                                                                                                                                                                                                                                                                              |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `faceMatch.detectionTimeOut`                         | `number`                                                                                                                                                                                   | No       | Timeout in milliseconds for face detection. Default is `90000` milliseconds.                                                                                                                                                                                                                                                                                                |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `faceMatch.detectionTimeOutCountdownDuration`        | `number`                                                                                                                                                                                   | No       | Timeout in milliseconds for face detection countdown. If you pass 30000 countdown will be shown for last 30 seconds . Default is for last 20000 ms (20 seconds)                                                                                                                                                                                                             |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `faceMatch.hideDetectionTimeOutCountdownAlert`       | `boolean`                                                                                                                                                                                  | No       | pass this true if countdown alert needs to be hidden . Default is false                                                                                                                                                                                                                                                                                                     |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `faceMatch.skipDarkLightingScreenFlash`              | `boolean`                                                                                                                                                                                  | No       | pass this true if you do not want the screen to flash white when dark area is detected.                                                                                                                                                                                                                                                                                     |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `faceMatch.hideStaticHeadShape`                      | `boolean`                                                                                                                                                                                  | No       | pass this true if you want to hide the static head shape inside the frame during selfie capture                                                                                                                                                                                                                                                                             |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
| `faceMatch.hideDescriptions`                         | <p><code>object</code></p><p><code>hideDescriptions: { tutorial: false, cameraAccess: true, camera: true, selfieReview: false, }</code></p>                                                | No       | <p>If any of these not passed, by default description will be shown in all screens. Pass <code>true</code> to hide page description from the screen.</p><p>tutorial - Selfie capture tutorial screen<br>cameraAccess - Camera access screen<br>camera- Selfie capture screen</p>                                                                                            |             |                         |                                                                     |                               |                               |                                   |                               |                                                            |                               |                                                                                            |                           |               |                                                                                                                 |
