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