NFC Reading
Chip-verified identity from ePassports and eIDs.
The chip cannot be photoshopped. Amani reads the NFC chip inside ePassports and eIDs, validates its cryptographic signatures, and returns government-signed identity data - the strongest document check that exists.
Capabilities
What NFC Reading gives you.
Cryptographic authenticity
Passive and active authentication verify the chip was issued by the government and never cloned.
Perfect data, no OCR
Name, date of birth, document number and photo come straight from the chip - zero transcription errors.
High-res chip photo
The chip’s embedded portrait gives face match a pristine reference image.
iOS & Android SDKs
Guided NFC capture UX handles phone placement and read progress for smooth completion rates.
Fallback built in
Devices or documents without NFC drop seamlessly to optical ID verification in the same flow.
eIDAS-aligned assurance
Chip verification supports high-assurance onboarding for regulated and government use cases.
From session to signed result.
Four steps - the same integration pattern as every Amani module.
Create a session
One API call (or a Studio journey) starts a verification session for this module.
User completes the flow
Your customer is guided through capture in your branded UI - web or mobile.
Checks run in real time
NFC Reading executes alongside any other modules in the journey.
You receive a signed result
A webhook delivers the decision, scores and evidence to your backend.
For developers
Integrate NFC Reading.
Authenticate, create a profile, generate a verification URL - then let Amani handle the rest. Or describe what you want to your AI coding agent and let Amani Skills wire it up from the live docs.
Available on
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"
}'
# NFC Reading runs inside this session - configure it in Amani Studio.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 Reading - common questions
Which documents have readable chips?
All biometric passports (the camera logo on the cover) and a growing set of national eIDs and residence permits.
What if the user’s phone lacks NFC?
The flow detects it and falls back to optical ID verification automatically - you configure whether that is allowed per journey.
Why add NFC to optical checks?
Optical checks assess an image; NFC verifies government cryptography. For high-risk tiers it effectively eliminates document fraud.
Related modules
Add NFC Reading to your flow
Switch it on in Amani Studio, or call it directly from the API.