> 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/web-sdk/integration.md).

# Integration

## **Integration Flow for VIDA Web SDK**

1. **Token and Signing Key Request**
   * **Partner Web App** sends a request to the **Partner Server** for a VIDA Liveness SDK token and pre-shared signingKey.
2. **Token Retrieval from VIDA Server**
   * The **Partner Server** makes a request to the **VIDA Server's Authentication API** using the `client_id` and `client_secret` as credentials.
   * The **VIDA Server** validates the credentials and responds with the token.
3. **Token Forwarding**
   * The **Partner Server** sends the retrieved token and pre-shared signingKey back to the **Partner Web App**.
4. **SDK Initialisation**
   * The **Partner Web App** initialises the VIDA Web SDK using the token and pre-shared signingKey.
   * This triggers the SDK to launch its modal dialog, starting the liveness check flow.
5. **Face Detection Process**
   * Within the VIDA Web SDK:
     * The SDK performs **face detection** to ensure the user’s face is correctly detected and captured for liveness verification.
6. **Image Submission for Liveness Check**
   * Once face detection is complete, the SDK sends the image to the **VIDA Server** for liveness verification.
7. **Liveness Verification**
   * The **VIDA Server** processes the image and responds with the **liveness result**.
8. **Callback Handling**
   * The **VIDA Web SDK** processes the response and triggers appropriate callbacks to the **Partner Web App**:
     * **onComplete Callback**: Indicates the liveness verification process was successful.
     * **onError Callback**: Indicates an error occurred during the process.

### Sequence Diagram

<figure><img src="/files/hgDlDSbXiFswok8mATHC" alt=""><figcaption></figcaption></figure>