Skip to main content

👥 Face Verification

The SDK wraps the Face Verification API in a single typed call — 0.3 IC per request. Pass two face images (for example, the selfie from an active liveness session and the portrait cropped from a captured ID card) and get back a similarity score and matched/not-matched decision. There is no camera UI on this page's flow — it is a pure API client call.

Flutter​

import 'package:iapp_ekyc_sdk/iapp_ekyc_sdk.dart';

final client = IappEkycClient(apiKey: 'YOUR_API_KEY');

final result = await client.verifyFaces(
  file1: selfieBytes,   // e.g. from ActiveLivenessView
  file2: idFaceBytes,   // e.g. from DocumentCaptureView
);

if (result.matched) {
  // Same person — score vs. threshold detail in result.raw
}

Web​

import { IappEkyc } from '@iapp-technology/ekyc-sdk';

const ekyc = new IappEkyc({ apiKey: 'YOUR_API_KEY' });

const result = await ekyc.verifyFaces({
  file1: selfieBlob,
  file2: idFaceBlob,
});

if (result.matched) {
  // Same person
}

Notes​

  • The default matching threshold targets 99.50% precision; raise it for a lower false-acceptance rate — see Understanding Similarity Scores.
  • Images are held in memory only and sent exclusively to the configured baseUrl — the SDK never writes them to disk.
  • Billable call: the SDK never auto-retries after the request body has been sent.

Learn more​