KYC
Onboard real customers. Block fraud in seconds.
KYC is Amani’s onboarding bundle: document capture, liveness and face match run as one automated journey - so a real customer is verified in seconds and a fraudster never gets through. Add AML screening to the same flow when you need it.
Capabilities
What KYC gives you.
ID + selfie in one flow
Document capture, forgery checks, passive liveness and face match run in a single guided journey.
220+ countries
Passports, national IDs, driving licences and residence permits recognised worldwide, with local-language OCR.
AML screening in the same flow
Add sanctions, PEP and adverse-media screening to the journey with one switch - included on the Compliance plan.
Risk signals on every session
Device, IP and behavioural signals score each verification so you catch coordinated fraud, not just fake documents.
Automated decisions
Clear approve / review / decline outcomes with reason codes - plus human review queues for the edge cases.
White-label UI
Your brand, your colours, your domain - via SDKs or a hosted flow you can launch without engineering. Included on Compliance and Enterprise.
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
KYC 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 KYC.
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"
}'
# KYC 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 our React signup page using the Web SDK - ID capture plus selfie liveness, then handle the approved webhook in our Node backend.
# 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();
});KYC - common questions
What does a KYC verification include?
ID document verification, liveness and 1:1 face match - bundled as one flow at $0.35 per verification. AML screening is a separate $0.20 check, and is included alongside KYC on the Compliance plan.
How long does verification take?
Automated decisions typically return in under two seconds after capture. Sessions routed to human review resolve in minutes.
Can I customise which checks run?
Yes. KYC is modular - switch individual checks on or off per journey in Amani Studio, and pay only for the modules each flow runs.
Related modules
Add KYC to your flow
Switch it on in Amani Studio, or call it directly from the API.
