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 NameLink
BE API GuideBE API Guide