Developer Hub

Verify a real person
in three steps.

KALAPA eKYC captures an ID document, a live selfie, and the ID chip over NFC — then returns a verified identity your app can trust. One SDK for web, mobile and cross-platform; one REST API behind it.

Get API key See how it works

Web SDKiOS SwiftAndroid KotlinFlutterReact NativeREST APIWebhooks

# 1. Your backend opens a session
$ curl -X POST https://api.kalapa.vn/v1/ekyc/sessions \
    -H "Authorization: Bearer $KALAPA_API_KEY" \
    -d '{ "flow": "full" }'

{
  "session_id": "sess_3f9a1c…",
  "expires_in": 900
}

Illustrative — see the docs for the exact request and response schema.

How verification works

Three capture steps feed one decision engine.

Every step runs a quality-check layer that gives the user real-time feedback — blur, glare, wrong position — and only passes clean data through. Pick the flow that fits your risk level.

Step 01

Document

Capture both sides of the ID card or a passport. OCR reads the fields.

Step 02

NFC chip

Tap the card to the phone. The chip is verified against the Ministry of Public Security (C06).

Step 03

Selfie + liveness

A live face check matched against the document and chip photo.

Decision

Decision engine

Server-side rules check forgery, fraud and logic, then return verified or rejected.

Real-time quality gate — images pass to OCR and face match only after blur, glare and framing checks succeed.

SDKs & APIs

Drop-in capture on every platform.

The SDK handles capture and upload of photos and video. Your app calls the REST API to open sessions and read results — so the heavy verification stays on KALAPA's backend.

JavaScript

Web SDK

Browser and web apps, drop-in capture screens.

Swift

iOS SDK

Native iOS, with NFC chip reading.

Kotlin

Android SDK

Native Android, with NFC chip reading.

Dart

Flutter

One codebase across iOS and Android.

JS / TS

React Native

One codebase across iOS and Android.

POST

Session InitOpen an eKYC session and choose the flow.

POST

KYC stepsSubmit document, NFC and selfie data, one call per step.

GET

Data GetPull the verified result and extracted fields.

HOOK

WebhookOr have KALAPA push the result to your endpoint.

Integration options

Choose how much of the data flow you control.

Two integration models, with the same verification underneath. Start simple, tighten control when you need it.

Scenario 1 · Direct

Recommended for POC

App ↔ KALAPA

The SDK talks to KALAPA's backend directly. Your backend only opens the session and reads the final result — the fastest way to ship a demo or proof of concept.

App + SDK→KALAPA→Your backend

Scenario 2 · Proxy

App ↔ Your backend ↔ KALAPA

Your backend sits between the SDK and KALAPA on every step, so you keep full control of the data flow. Set it up with a baseURL override or a custom RawProcessor.

App + SDK→Your backend→KALAPA

Reading results: pull them on demand with the Data Get API, or let KALAPA push them to your webhook the moment a session completes.

Quickstart

From API key to first verified identity in under five minutes.

Get your API key

Open a session

Call Session Init from your backend and pass the session to the SDK.

Capture

The SDK guides the user through document, NFC and selfie with live quality checks.

Read the result

Pull it or receive a webhook — verified or rejected, plus the extracted data.

Security & compliance

Built to satisfy a bank's risk team.

Verification that holds up to scrutiny — certified liveness, chip-level authenticity, and fraud detection across trusted databases.

Certified liveness

Single-image passive liveness, tested at scale for real-world conditions.

ISO 30107-3 · iBeta Level 2

Stops spoofing

Detects presentation attacks — print, replay, masks — and injection attacks like camera hijack and MITM.

Chip authentication

Reads the ID chip over NFC and verifies it against the Ministry of Public Security (C06).

Forgery & fraud detection

Flags tampered documents, duplicate faces and blacklisted IDs; cross-checks tax, health and insurance records.

Your data, your choice

Store verification data on KALAPA's backend, or keep it entirely on your own.

Broad document support

Vietnamese ID cards across every generation, passports, and more.

Supported documents9-digit ID card12-digit ID card12-digit ID with chipPassportVehicle registration (OCR)

Trusted in production

Banks, fintechs and lenders across Vietnam.

Get started

Ready to build?

Free sandbox access, no credit card. Open a session and run your first verification today.

Get your API key Read the docs