Face Match Flow
Current Flow Version - v1.2
Available Since - 1 Mar 2026
Overview
Face Match is a high-precision facial matching for identity validation. Operating as a secure backend-to-backend API, our system executes a 1:1 comparison between two images for identity validation. Client can do selfie to selfie comparison or selfie to KTP portrait comparison. Operating as a secure backend-to-backend service, the system executes a rapid 1:1 biometric comparison between two provided images to verify if they belong to the same individual. The API is highly flexible and supports the following comparison modalities:
- Selfie-to-ID Comparison: Compares a live selfie against a portrait extracted from a government-issued ID (such as a KTP) to verify true identity.
- Selfie-to-Selfie Comparison: Compares a new selfie against a previously registered baseline selfie to authorize returning users.
Common Use Cases
- Digital Onboarding (eKYC)
During the account creation process for financial services or restricted platforms, users are required to upload a photo of their ID card (KTP) alongside a live selfie. Face Match instantly compares the live face with the ID portrait, ensuring that the person creating the account is the legitimate owner of the provided document. This drastically reduces identity fraud and automates the approval process. - High-Risk Transaction Authorization (Step-up Authentication)
When a user attempts to perform a sensitive action, such as transferring a large sum of money, changing account credentials, or recovering a locked account, client platforms can trigger a prompt for a live selfie. Face Match compares this new image against the baseline selfie stored during the user's initial onboarding, ensuring that the person authorizing the action is the authorized account holder.
High Level Flow
sequenceDiagram
autonumber
title High Level BE to BE Flow Overview
participant PBE as Partner Backend Service
box rgb(240, 240, 240) IAB Infra
participant TG as Token Gateway
participant IBE as IAB Gateway
participant OSS as Bucket Service
end
rect rgb(230, 245, 255)
Note over PBE, TG: Get User token
PBE->>TG: Get User token
TG-->>PBE: User token
Note over PBE: Cache User token
end
rect rgb(235, 230, 255)
Note over PBE, IBE: Start Submission processing
PBE->>IBE: Get Presigned URL
IBE->>PBE: Presigned URL for upload image
PBE->>OSS: Upload image for each presignedURL
PBE->>IBE: Confirm Upload
PBE->>IBE: Status Polling
IBE->>PBE: Give callback when its done
end
rect rgb(230, 245, 255)
Note over PBE, IBE: Get Result Details
IBE->>PBE: Submission Processing Compete Callback
PBE->>IBE: Call "Get Submission Details" API (correlationId, partner token)
IBE-->>PBE: return submission details
end
Integration Contracts
| Document Name | Link |
|---|---|
| BE API Guide | BE API Guide |
Updated 8 days ago