NFC e-passport onboarding
Chip-verified onboarding for high-assurance journeys.
For high-value accounts, an image of a document is not enough. Amani reads the passport chip over NFC, validates its government signatures, and binds the chip portrait to a live face - assurance a forger cannot manufacture.
The challenge
Document images can be edited, printed and replayed. High-risk products, regulated accounts and government services need proof that comes from the issuing authority itself.
With Amani
- Cryptographically authenticated government identity data
- Zero OCR transcription errors - data straight from the chip
- High-resolution chip portrait for maximum face-match accuracy
- Automatic optical fallback where NFC is unavailable
- Highest assurance tier for eIDAS-style requirements
The stack
Modules powering this flow.
Switch these on in Amani Studio - or call them directly from one API.
For developers
Build this flow.
Three API calls start the session; the modules above run inside it. Compose the journey in Amani Studio without code, or let your AI coding agent wire up the SDK from a single prompt.
- JWT auth with refresh tokens
- Regional base URLs (EU · TR · UAE)
- HMAC-signed webhooks with retries
- 27 languages in the SDKs
verify.sh
# 1 · Authenticate (server-side only)
curl -X POST 'https://ae.amani.ai/api/v2/user/login/' \
--form 'username="you@company.com"' \
--form 'password="••••••••"'
# 2 · Create the customer profile
curl -X POST 'https://ae.amani.ai/api/v2/profile' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
--form 'id_card_number="784199012345678"' \
--form 'name="Layla Haddad"'
# 3 · Generate the verification URL
curl -X POST 'https://ae.amani.ai/api/v2/profile/url' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
--data '{
"profile": PROFILE_ID,
"web_sdk_url": "https://verify.amani.ai",
"language": "en",
"return_url": "https://yourapp.com/verified"
}'
# This session runs: NFC Reading, ID Verification, Liveness, Face Match 1:1.with Amani Skills
# Install Amani Skills once
npx -y github:AMANI-AI-ORG/skills --global
# Then ask your coding agent:
You › Add Amani KYC to this iOS app with NFC ePassport chip reading plus the selfie liveness step.
# The matching skill fetches the live docs, pins the
# current SDK version and wires up the integration -
# secrets left as placeholders. Claude Code, Cursor and
# any Agent-Skills-compatible tool.webhooks.ts
// Amani signs every webhook with an HMAC signature using
// your secret. Always verify it before processing.
import crypto from 'node:crypto';
app.post('/webhooks/amani', (req, res) => {
// Confirm the exact header name in the Webhooks API reference.
const signature = req.get('X-Amani-Signature') ?? '';
const expected = crypto
.createHmac('sha256', process.env.AMANI_WEBHOOK_SECRET)
.update(req.rawBody)
.digest('hex');
const valid =
signature.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
if (!valid) return res.status(401).end();
const { profile, status } = req.body;
if (status === 'approved') activateAccount(profile);
res.status(200).end();
});NFC e-passport onboarding - common questions
Do all customers have NFC-readable documents?
All biometric passports and a growing set of national eIDs. The flow detects capability and falls back to optical verification automatically.
Does NFC work on both iOS and Android?
Yes - the SDKs provide guided NFC capture on both platforms with progress feedback for high completion rates.
Is this slower for the user?
The chip read takes a few seconds and replaces manual data entry, so most journeys are faster overall.
Related use cases
Build this flow with Amani
Compose it in Studio without code, or integrate the API in an afternoon.