Run the full bundle, ID, Liveness, Face Match, IP, paid from $10 of free credit every month, on every account. No card. Same engine paying customers use.
Trusted by 3,000+ organizations worldwide.
$10 free / month
$10 of free credit every month. After that, $0.33 per full KYC (know your customer) check. No sales call, the same price startups and large enterprises pay.
Pick the checks you want, ID, liveness, face match, sanctions, address, age, phone, email, custom questions. Drag them into a flow in the dashboard, or post the same flow to our API. Branch on conditions, run A/B tests, no code required.
Four features · every session
Resets 1st · 00:00 UTC · workspace-level
Self-serve · sandbox unlocked
$10 / month covers each below
Same workflow_id · billed only past the free credit
Free credit vs paid overflow
Free credit
$0.33 overflow
$ curl -X POST https://verification.didit.me/v3/workflows/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workflow_label": "Free KYC",
"features": [
{ "feature": "ID_VERIFICATION" },
{ "feature": "LIVENESS" },
{ "feature": "FACE_MATCH" },
{ "feature": "IP_ANALYSIS" }
]
}'{ "workflow_id": "wf_free_kyc_42" }$ curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workflow_id": "wf_free_kyc_42",
"vendor_data": "user-42"
}'{ "url": "verify.didit.me/..." }# Didit Free KYC — integrate in 5 minutes
You are integrating Didit's full KYC bundle (ID + Passive Liveness +
Face Match + Device & IP Analysis) into <my_stack>. Every account gets $10 of free credit
every month — no credit card, no sales
call. Past the free credit you keep using the same endpoint at $0.33 per session.
Every URL, header, and enum value below is canonical — do not paraphrase.
## 1. Provision an account
- Sign up: https://business.didit.me (no credit card required).
- Or provision programmatically: POST https://apx.didit.me/auth/v2/programmatic/register/
(returns an API key bound to the workspace + application).
- The $10 monthly free credit is counted at the workspace level.
It resets at 00:00 UTC on the first of each month and applies to any
workflow that combines the four bundled features.
## 2. Create the KYC workflow (one time)
POST https://verification.didit.me/v3/workflows/
Authorization header: x-api-key: <your-api-key>
Body: workflow_label, features array with the four bundled entries
[
{ feature: "OCR" },
{ feature: "LIVENESS" },
{ feature: "FACE_MATCH" },
{ feature: "IP_ANALYSIS" }
] (UPPERCASE — strict enum, do not lowercase)
This is the same workflow used in production at $0.33 per session.
Sessions paid from the free credit run on the same model
weights, the same edge nodes, the same Spain-Tesoro-attested pipeline.
There is no degraded model on the Free plan.
## 3. Create a verification session for an end user
POST https://verification.didit.me/v3/session/
Body: workflow_id (from step 2), vendor_data (your own user id).
Response: url (the hosted verification link) — redirect the user to it.
The hosted UI walks the user through document capture, selfie capture
(passive liveness), automatic face-match between portrait and selfie,
and Device & IP analysis on the originating connection. End-to-end inference is
sub-2 seconds across the full bundle.
## 4. Webhooks
- Register a webhook destination once via
POST https://verification.didit.me/v3/webhook/destinations/
Body: url, subscribed_events: ["session.verified", "session.review_started",
"session.declined", "kyc_expired"]
- Response includes secret_shared_key — store it.
- Every webhook delivery carries an X-Signature-V2 header you MUST verify
before trusting the payload. HMAC-SHA256 verification MUST run against the raw body bytes (the raw payload as Didit sent it) BEFORE any JSON parsing — re-serialising the parsed body changes whitespace and key order, which invalidates the signature.Algorithm:
1. sortKeys(payload) recursively
2. shortenFloats (truncate trailing zeros after the decimal point)
3. JSON.stringify the result
4. HMAC-SHA256 with the secret_shared_key
5. Hex-encode, compare to the X-Signature-V2 header.
## 5. Reading the session report
The session decision includes one ARRAY per bundled feature — one entry per
workflow node, each with its own node_id. Select an entry by node_id. The
webhook nests these arrays under decision (as written below); on
GET /v3/session/{session_id}/decision/ the same arrays sit at the response
ROOT (response.id_verifications — there is no response.decision):
- decision.id_verifications[] — status, document_type, document_number,
full_name, date_of_birth, expiration_date, issuing_state, parsed address,
image quality scores, warnings.
- decision.liveness_checks[] — status, method ("PASSIVE"), score 0-100,
reference_image, warnings.
- decision.face_matches[] — status, similarity score 0-100, source
("DOCUMENT"), target ("SELFIE").
- decision.ip_analyses[] — status, ip, country, city, vpn, proxy, tor,
hosting, asn, abuse_score, risk warnings.
Statuses use exact casing: "Approved", "Declined", "In Review",
"Expired", "Not Finished".
## 6. Hard rules — do not change
- Base URL for /v3/* endpoints is verification.didit.me (NOT apx.didit.me).
- Feature enums are UPPERCASE: OCR, LIVENESS, FACE_MATCH, IP_ANALYSIS.
- Auth header is x-api-key (lowercase, hyphenated).
- Webhook signature header is X-Signature-V2 (NOT X-Signature).
- Always verify webhook signatures before trusting payload data.
- Status casing matches exactly: "Approved", "Declined", "In Review",
"Expired", "Not Finished" (title-cased, space-separated).
## 7. Pricing reference (public)
- First $10 of usage per workspace per month: free, no credit
card, on every account. Credit resets 00:00 UTC on the first of each month.
- Usage past the free credit in a month: $0.33 per session, billed only for the
usage above the free credit. Same workflow, same endpoint, same
features, same response shape.
- No minimums, no contracts, no overage surprises. The full price table:
didit.me/pricing.
## 8. Verify your integration
- Sandbox starts on signup at https://business.didit.me — no separate flag.
- Test data: deterministic synthetic documents and selfies returned in
sandbox. Sandbox sessions do not count against the monthly free credit.
- Switch to live: flip the application's environment toggle in console.
When in doubt: https://docs.didit.me/sessions-api/create-session
Try every check with free credit.
For teams going live. Or $1,128 a year.
For teams at volume. Or $3,408 a year.
For large volume and procurement.
One plan and one credit balance cover every product: Identity Verification, Authentication and Transaction Monitoring. Growth and Scale are month to month, or $1,128 and $3,408 a year paid up front.
Didit is infrastructure for identity and fraud, the platform we wished existed when we were building products ourselves: open, flexible, and developer-friendly, so it works as a real part of your stack instead of a black box you integrate around.
One API covers verifying people (KYC, know your customer), verifying businesses (KYB, know your business), screening crypto wallets (KYT, know your transaction), and monitoring transactions in real time, on a stack built to be:
The footprint underneath: 14,000+ document types in 54 languages, 1,000+ data sources, and 200+ fraud signals on every session. The Didit infrastructure dynamically learns from every session and gets better every day.
Free KYC is the $10 of free credit every workspace gets every month, on every Didit account. The credit covers the full Know Your Customer (KYC) bundle, Identity Document Verification + Passive Liveness + Face Match + Internet Protocol (IP) Analysis, on the same POST /v3/session/ call as paid sessions.
Same engine. Same workflow. Same JavaScript Object Notation (JSON) response shape. Same Spain Tesoro / Banco de España (BdE) / Spanish Financial Intelligence Unit (SEPBLAC)-attested pipeline.
No credit card. No sales call.
Every workspace gets $10 of free credit every month, for any product.
ID_VERIFICATION + LIVENESS + FACE_MATCH + IP_ANALYSIS on one POST /v3/session/ call, at the public price.The full flow normally takes under 30 seconds end-to-end, pick up the ID, snap the document, snap the selfie, done. That is the fastest in the market. Legacy KYC providers usually take more than 90 seconds for the same flow.
On the back end, Didit returns the result in under two seconds at p99, measured from the moment the user finishes the selfie to the moment your webhook fires. Mobile capture is tuned for slow phones and slow networks: progressive image compression, lazy software development kit load, and a one-tap hand-off from desktop to phone via QR code if the user starts on web.
No to both. Drop a work email at business.didit.me, get an Application Programming Interface (API) key in seconds, open the sandbox from minute one.
We do not request a payment method to unlock the free monthly credit. There is no order form and no sales conversation. The only time we ask for card details is when you choose to top up past the free credit.
Every session lands on one of seven clear statuses, so your code always knows what to do:
Approved, every check passed. Move the user forward.Declined, one or more checks failed. You can allow the user to resubmit the specific failed step (for example, re-take the selfie) without re-running the whole flow.In Review, flagged for compliance review. Open the case in the console, see every signal, decide approve or decline.In Progress, user is mid-flow.Not Started, link sent, user has not opened it yet. Send a reminder if it sits too long.Abandoned, user opened the link but did not finish in time. Re-engage or expire.Expired, the session link aged out. Create a new session.A signed webhook fires on every status change, so your database always stays in sync. Abandoned and declined sessions are free.
Production data is processed and stored in the European Union by default, on Amazon Web Services. Enterprise contracts can request alternative regions for jurisdictions whose regulators require it.
Encryption everywhere. AES-256 at rest across every database, object store, and backup. Transport Layer Security 1.3 in transit on every API call, webhook, and Business Console session. Biometric data is encrypted under a separate Customer Master Key.
Retention is yours to control. Default retention is indefinite (unlimited) unless you configure shorter, between 30 days and 10 years per application, and you can delete any individual session at any time from the dashboard or the API.
Certifications: SOC 2 Type 1 & Type 2, ISO/IEC 27001:2022, iBeta Level 1 PAD, and a public attestation from Spain''s Tesoro / SEPBLAC / CNMV that Didit''s remote identity verification is safer than verifying someone in person. Full report at /security-compliance.
Didit ships compliant by default for the regulators that matter to identity infrastructure:
Detailed memo, every certificate, every regulator letter: /security-compliance.
Three integration paths, pick whichever fits your stack:
Same dashboard, same billing, same pay-per-success price for all three. Step-by-step guide at docs.didit.me/integration/integration-prompt.
One API for KYC, KYB, Transaction Monitoring, and Wallet Screening. Integrate in 5 minutes.