Face Verification Flow
Current Flow Version - v1.2
Available Since - 1 Mar 2026
Overview
Face Verification is an enterprise-grade biometric security layer engineered to balance rigorous identity assurance with a frictionless user experience. By consolidating Passive Liveness Detection and 1:1 Face Matching into a single, synchronized process, the solution ensures that the person engaging with your digital service is both physically present and the legitimate owner of the presented credentials.
Key Features
| Technical Implementation | Strategic Value | |
|---|---|---|
| Advanced Liveness Detection | Employs anti-spoofing algorithms to detect presentation attacks, including high-resolution photos, video playbacks, and 3D masks. | Establishes proof of "human presence" without requiring complex user movements (Passive Liveness). |
| Biometric Face Comparison | Executes high-precision 1:1 matching between the real-time selfie and the reference document. | Validates that the individual performing the onboarding is the authorized identity holder. |
High Level Flow
sequenceDiagram
autonumber
title High Level SDK Flow Overview
participant PFE as Partner FE
participant PBE as Partner Backend Service
participant DIS as Digital Identity SDK
box rgb(240, 240, 240) IAB Infra
participant TG as Token Gateway
participant IBE as IAB Gateway
end
rect rgb(230, 245, 255)
Note over PFE, TG: Get Partner token
PBE->>TG: Get Partner token (client_id, passkey)
TG-->>PBE: Partner token
Note over PBE: Cache Partner token
end
PFE->>DIS: Initialize Digital Identity SDK
rect rgb(230, 245, 255)
Note over PFE, IBE: Get User token
PFE->>PBE: Call initiate flow API
PBE->>IBE: Initiate Flow (partner token, user_details)
IBE-->>PBE: User token
PBE->>PFE: User token
end
rect rgb(235, 230, 255)
Note over PFE, IBE: Capture image and Submission processing
PFE->>DIS: launchSelfieVerification(user token, correlationId, baseUrl)
Note over DIS: Capture Image Screens
rect rgb(255, 245, 230)
Note over DIS, IBE: Submission Processing
DIS->>IBE: Start Submission Processing
Note over IBE: Submission Processing
IBE-->>PBE: Get Reference Image (User Details)
PBE-->>IBE: Reference Image (URL)
Note over DIS: Status Polling
DIS->>DIS: Do next action:<br/>- RETRY<br/>- STATUS<br/>- EXIT
end
DIS->>PFE: on Completion(success/failure)
end
rect rgb(230, 245, 255)
Note over PFE, IBE: Get Result Details
IBE->>PBE: Submission Processing Compete Callback
PFE->>PBE: Call "Get Submission Details" API <br/>(correlationId aka partner session id)
PBE->>IBE: Call "Get Submission Details" API (correlationId, partner token)
IBE-->>PBE: return submission details
PBE-->>PFE: Continue processing
end
Note over PFE: Show/process resultDetailed Steps:
-
Partner BE call "Get Partner Token API" through IAB Gateway and caches the Partner Token to be used repeatedly.
-
Partner FE calls Partner BE to get User Token. Partner BE calls IAB Gateway to get user Token using the Initiate Flow API.
-
Partner User Id
-
Partner User Id Type
-
Onboarding partner tied to the flow, which partner wants to launch.
-
Partner FE initializes the Digital Identity FE SDK (IAB FE):
Use the initialise method to initialize the SDK.
-
Partner FE calls launchSelfieVerification() method of Digital Identity SDK to launch Selfie Verification flow with the following parameters:
-
baseURL: This is the server URL specific to the partner using the format
https\://<domain>. Example: https://onekyc.ky.id.sandbox.gopayapi.com -
correlationId: A unique ID used to create a Selfie Verification request and track the specific instance of the Selfie Verification request helpful for logging and event tracking.
-
token: The unique user token, different for each user.
-
theme(optional): The theme parameter is optional, and its default value is null. If not provided, the SDK uses the default theme (DefaultOneKycSelfieVerificationFlowTheme). The theme parameter is an instance of the
OneKycSelfieVerificationFlowThemeclass. It allows you to customize the look and feel of the Selfie Verification flow screen. By providing a custom theme, you can modify various UI elements, such as colors, fonts, and styles, to match your application's branding requirements. -
IAB FE will capture users' selfies and will upload it to IAB Gateway for Face verification processing.
-
IAB Gateway initiates Face verification processing.
-
Partner needs to expose an API, which IAB BE will call to get the reference Image. The selfie captured by IAB FE will be compared against this reference image. This reference image can be either selfie or ktp based on the flow which the partner launched.
Integration Contracts
| Document Name | Link |
|---|---|
| BE API Guide | BE API Guide |
| Web SDK Guide | Web SDK Guide |
| Android SDK Guide | Android SDK Contract |
| Flutter SDK Guide | Flutter SDK Contract |
| iOS SDK Guide | iOS SDK Contract |
Updated 1 day ago