Toa kitambulisho kilichosainiwa na Didit baada ya KYC moja ya $0.33. Mtumiaji anakitumia kwenye majukwaa mengine yote yanayotumia Didit kwa ufichuzi teule, bila malipo, milele, kulingana na kanuni za wallet ya utambulisho ya EU.
Kile ambacho utambulisho unaoweza kutumika tena hufungua
Kitambulisho kipo mfukoni mwa mtumiaji. Bure kwa kila anayekikubali.
Kila KYC ya Didit hutuma kitambulisho cha Reusable Identity kilichosainiwa kwenye
wallet ya mtumiaji. Kila jukwaa linalopokea hulithibitisha bila malipo kwa
ufichuzi teule. Uthibitishaji mmoja, kila biashara inayokubali Didit. Uthibitishaji 500
bila malipo kila mwezi.
Jinsi inavyofanya kazi
Kutoka kujisajili hadi mtumiaji aliyethibitishwa kwa hatua nne.
Hatua 01
Unda mtiririko wa kazi
Chagua ukaguzi unaotaka, ID, liveness, kulinganisha uso, vikwazo, anwani, umri, simu, barua pepe, maswali maalum. Ziburute kwenye mtiririko kwenye dashibodi, au tuma mtiririko huo huo kwenye API yetu. Panga masharti, endesha majaribio ya A/B, hakuna msimbo unaohitajika.
Hatua 02
Unganisha
Pachika kiasili na SDK yetu ya Web, iOS, Android, React Native, au Flutter. Elekeza kwenye ukurasa uliopangishwa. Au tuma tu mtumiaji wako kiungo, kwa barua pepe, SMS, WhatsApp, popote. Chagua kinachofaa stack yako.
Hatua 03
Mtumiaji anapitia mtiririko
Didit huandaa kamera, vidokezo vya mwanga, uhamishaji wa simu, na ufikiaji. Wakati mtumiaji yuko kwenye mtiririko, tunapata alama za ishara 200+ za udanganyifu kwa wakati halisi na kuthibitisha kila sehemu dhidi ya vyanzo vya data vya mamlaka. Matokeo chini ya sekunde mbili.
Hatua 04
Unapokea matokeo
Webhooks zilizosainiwa kwa wakati halisi huweka database yako sawa mara tu mtumiaji anapoidhinishwa, kukataliwa, au kutumwa kwa ukaguzi. Piga API inapohitajika. Au fungua console kukagua kila session, kila ishara, na kudhibiti kesi kwa njia yako.
Imejengwa kwa utambulisho unaoweza kutumika tena · Bei kama miundombinu
KYC moja. Kila jukwaa baada ya hapo, bure.
Utambulisho halisi unaoweza kutumika tena si kipengele kimoja, ni mfumo. Utoaji, ushikiliaji, uwasilishaji, ufichuzi teule, kuonyesha upya, kubatilisha. Yote chini ya /v3/ session moja.
Mtumiaji huendesha kifurushi cha kawaida cha $0.33 kwa mara ya kwanza. Baada ya kukamilika, Didit husaini kitambulisho na kukisukuma kwenye programu ya Didit au Wallet yoyote ya Kitambulisho cha Dijitali ya EU inayotumia Architecture Reference Framework.
Credential lands in the Didit app or an EUDI Wallet.
02 · Ufichuzi Teule
Fichua tu kile ambacho mthibitishaji anahitaji.
Thibitisha umri zaidi ya miaka 18 bila kufichua tarehe ya kuzaliwa. Thibitisha nchi bila kufichua anwani. Selective Disclosure JSON Web Tokens (SD-JWT) huweka kila ufichuzi ukiwa umesainiwa kwa njia fiche.
Signed by the issuer; verifier validates on the disclosed fields.
03 · Ushirikiano wa Wallet
Kila wallet inayooana na EUDI.
Vitambulisho vilivyotolewa na Didit hufanya kazi katika programu ya Didit na Wallet yoyote ya Kitambulisho cha Dijitali ya EU (Cartera Digital, IT Wallet, wallets za kitaifa za nchi wanachama). Mtiririko sawa wa uwasilishaji wa OpenID for Verifiable Credentials kwenye kila sehemu.
Same OpenID for Verifiable Credentials flow on every surface.
04 · Mtoaji · Mwenye · Mthibitishaji
Majukumu matatu. Kitambulisho kimoja.
Mtoaji husaini kitambulisho baada ya KYC. Mtumiaji hukishikilia kwenye wallet yake. Mthibitishaji huthibitisha saini ya mtoaji kwenye sehemu zilizofichuliwa pekee. Pembetatu ya uaminifu ya kitambulisho kinachoweza kuthibitishwa.
Issuer signs the credential → holder stores it in the wallet → verifier requests fields
→ holder approves disclosure → verifier validates signature on disclosed fields only.
05 · Usasa wa Kitambulisho
Usasa wa kitambulisho, kiotomatiki.
AML inayoendelea huchunguza upya mtumiaji kila siku. Muda wa kuisha wa hati, mabadiliko ya jina, vikwazo vilivyopigwa, yote huonekana kwenye kitambulisho kiotomatiki. Vitambulisho vilivyopitwa na wakati hukataliwa wakati wa uwasilishaji.
Stale credentials are rejected at presentation time.
06 · Bure kupokea
Bure kwa kila jukwaa linalopokea.
Utoaji umejumuishwa na kila KYC. Uhifadhi wa wallet uko kwenye kifaa cha mtumiaji. Uwasilishaji, ufichuzi teule, na uthibitishaji wa saini zote ni bure, milele. Usasishaji endelevu wa AML kwa $0.07 kwa kila mtumiaji kwa mwaka kwenye akaunti zenye matumizi makubwa.
201Imeundwamtiririko uliopangishwa hugundua kitambulisho au huendesha KYC kamili
Bure wakati kitambulisho cha Didit kinawasilishwa. $0.33 wakati KYC kamili inaendeshwa.nyaraka →
GET /v3/session/{sessionId}/decision/Soma
$ curl https://verification.didit.me/v3/session/$SID/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
# Inarudisha sehemu zilizofichuliwa + mnyororo wa mtoaji
# wakati reusable_identity.presented ni 'true'.
# Inarudisha kifurushi kamili cha ushahidi wa KYC
# wakati KYC mpya ilipoendeshwa.
200OKhali Imeidhinishwa · Inapitiwa · Imekataliwa · Imeisha muda
Kifurushi kilekile cha ushahidi iwe kitambulisho kiliwasilishwa au KYC ilikuwa mpya.nyaraka →
Ujumuishaji tayari kwa agent
Tengeneza mtiririko wa kitambulisho kinachoweza kutumika tena kwa amri moja.
Bandika kwenye Claude Code, Cursor, Codex, Devin, Aider, au Replit Agent. Jaza stack yako. Agent hujenga mtiririko wa kazi, huweka utambuzi wa wallet, hutangaza sehemu zilizofichuliwa, na huunganisha webhook.
didit-integration-prompt.md
You are integrating Didit's Reusable Identity / eIDAS 2.0 acceptance into your platform. Two flows:
1. Issue — when a new user runs a full KYC on your platform, they leave with a Didit-signed Reusable Identity credential in their wallet (the Didit app or any EU Digital Identity Wallet).
2. Accept — when a user arrives at your platform already holding a Didit-signed credential, the session detects it and short-circuits, returning Approved without re-running the full KYC.
Bundle pricing (verified live 2026-05-16):
- First verification (issuance side): $0.33 per user (Sessions API full KYC bundle)
- Issuance: free — the signed credential is included with every KYC
- Reuse on the verifying side: free, forever
- Selective disclosure: free
- Continuous Anti-Money Laundering (AML) refresh: $0.07 per user per year (automatic)
- First 500 verifications free every month, forever
PRE-REQUISITES
- Production API key from https://business.didit.me (sandbox key in 60 seconds, no credit card).
- Webhook endpoint with HMAC SHA-256 verification of the X-Signature-V2 header.
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. - A workflow_id from the no-code Workflow Builder with:
* ID Verification + Passive Liveness + Face Match 1:1 + Device & IP Analysis + AML Screening (for issuance)
* Reusable Identity acceptance turned on (for acceptance — toggle in the Workflow Builder)
- Optional: the Didit mobile SDK (iOS / Android / React Native / Flutter) for native deep-link wallet handoff.
STEP 1 — Open a session that accepts a Reusable Identity if presented
POST https://verification.didit.me/v3/session/
Headers:
x-api-key: <your api key>
Content-Type: application/json
Body:
{
"workflow_id": "<wf id with Reusable Identity acceptance on>",
"vendor_data": "<your user id>",
"callback": "https://<your-app>/onboarding/callback",
"metadata": {
"purpose": "platform_onboarding",
"request_fields": ["full_name", "age_over_18", "country_of_residence"]
}
}
Optional in body: declare the exact fields you need disclosed via metadata.request_fields. Didit's hosted flow will prompt the user to approve only those specific fields when they present a Reusable Identity credential.
Response: 201 Created with the hosted session URL. Redirect the user.
STEP 2 — The hosted flow detects (or runs) the verification
Two paths from this one endpoint:
Path A — User has a Didit-signed credential
- The hosted flow detects the credential via a wallet-handoff prompt (universal link on mobile, popup-bridge on desktop)
- The user approves the disclosure of the requested fields
- Didit validates the issuer signature + credential freshness server-side
- Session returns Approved with the disclosed fields populated on the decision payload
- Cost: $0 on the verifying side
Path B — User does NOT have a credential
- The hosted flow runs the full KYC bundle (ID + Liveness + Face Match + Device & IP + AML)
- At completion, Didit issues a Reusable Identity credential to the user's wallet
- Session returns Approved with the full decision payload
- Cost: $0.33 on the verifying-and-issuing side
Same endpoint, same webhook, same status enum. The path is transparent to your back-end.
STEP 3 — Read the signed webhook
Didit POSTs to your callback. Session statuses (Title Case With Spaces):
Body (excerpted):
{
"session_id": "<uuid>",
"vendor_data": "<your user id>",
"status": "Approved",
"id_verification": { "status": "Approved" },
"liveness": { "status": "Approved" },
"face": { "status": "Approved", "similarity_score": 0.94 },
"ip_analysis": { "status": "Approved" },
"aml": { "status": "Approved", "hits": [] },
"reusable_identity": {
"presented": true,
"issuer": "<issuing-platform name>",
"issued_at": "<timestamp>",
"disclosed_fields": ["full_name", "age_over_18", "country_of_residence"]
}
}
Status enum (exact case): Approved | Declined | In Review | Resubmitted | Expired | Not Finished | Kyc Expired | Abandoned.
Verify the X-Signature-V2 header BEFORE reading the body.
When reusable_identity.presented is true, the user re-presented an existing credential and the verification was free; when false, a fresh KYC was run and billed at $0.33.
STEP 4 — Retrieve the full decision later
GET https://verification.didit.me/v3/session/{sessionId}/decision/
Headers:
x-api-key: <your api key>
Returns the full payload including: document scan + extracted Machine-Readable Zone (MRZ) data, biometric similarity, AML hits, device + IP risk signals, 200+ fraud signals, HMAC signature, and (if presented) the credential issuance chain.
Same evidence pack regardless of issuance vs reuse — the verifier never sees less than a fresh KYC would deliver.
STEP 5 — Continuous AML monitoring is automatic
Every approved user (issued OR presented) is re-screened daily against 1,300+ sanctions, PEP, and adverse-media lists at $0.07 per user per year on heavy-volume accounts. When a previously-clean user crosses an AML threshold, the credential's AML field is updated automatically; every receiving platform sees the refreshed status on next presentation.
When the user revokes a credential from their wallet, your receiving platform's webhook fires with status: Expired and the credential is dropped from the user's account.
STEP 6 — Selective disclosure at presentation time
Pass the exact fields you need via metadata.request_fields at session creation. Recommended minimum-disclosure patterns:
- Age-gate (UK Online Safety Act, France SREN): ["age_over_18"]
- Country-gate: ["country_of_residence"]
- Full name + verified-human: ["full_name", "verified_human"]
- AML-clear gate (lending): ["aml_clear", "full_name"]
- Full identity (banking, payments): ["full_name", "date_of_birth", "address", "document_number", "aml_clear"]
The user sees a single approval prompt listing the requested fields. Anything not listed is never disclosed to your platform.
WEBHOOK EVENT NAMES
- Sessions: status changes flow through the standard session webhook (verify X-Signature-V2 HMAC SHA-256).
- Credential lifecycle: status: Expired fires when a holder revokes the credential.
CONSTRAINTS
- Session statuses use Title Case With Spaces. Don't UPPER_SNAKE_CASE them.
- Reusable Identity acceptance is OFF by default; turn it on in the Workflow Builder.
- Selective disclosure is the privacy default — fields not in metadata.request_fields are never returned, even if the credential carries them.
- Default record retention is 5 years post-relationship per the EU AML package.
- 200+ fraud signals are evaluated on every session, issued or presented, at no extra cost.
Read the docs:
- https://docs.didit.me/sessions-api/create-session
- https://docs.didit.me/sessions-api/retrieve-session
- https://docs.didit.me/core-technology/reusable-kyc/overview
- https://docs.didit.me/integration/webhooks
Start free at https://business.didit.me — sandbox key in 60 seconds, 500 verifications free every month, no credit card.
Unahitaji maelezo zaidi? Tazama nyaraka kamili za moduli.docs.didit.me →
Inatii kwa muundo
Fungua nchi mpya kwa kubofya mara moja. Tunafanya kazi ngumu.
Tunafungua kampuni tanzu za ndani, tunapata leseni, tunafanya majaribio ya kupenya, tunapata vyeti, na tunalingana na kila kanuni mpya. Ili kusafirisha uthibitishaji katika nchi mpya, geuza swichi. Nchi 220+ ziko hewani, zinakaguliwa na kupimwa kila robo mwaka, mtoa huduma pekee wa utambulisho ambaye serikali ya nchi mwanachama wa EU imemwita rasmi kuwa salama zaidi kuliko uthibitishaji wa ana kwa ana.
Kwa uthibitisho wa kwanza, mara pekee mtumiaji hulipia kifurushi cha Didit KYC.
Free
Kwenye kila jukwaa linalopokea. Kila utumiaji upya, kila uwasilishaji, kila ufichuzi teule.
0
Nchi wanachama wa EU. Kitambulisho cha Didit kinafanya kazi na kila EUDI Wallet iliyojengwa kwenye Architecture Reference Framework.
0
Uthibitishaji wa bure kila mwezi, kwenye kila akaunti.
Ngazi tatu, orodha moja ya bei
Anza bure. Lipa kulingana na matumizi. Panua hadi Enterprise.
Uthibitishaji 500 bila malipo kila mwezi, milele. Lipa kadri unavyotumia kwa uzalishaji. Mikataba maalum, uhifadhi wa data, na SLA (Service Level Agreements) kwenye Enterprise.
Bure
Bure
$0 / mwezi. Hakuna kadi ya mkopo inayohitajika.
Kifurushi cha bure cha KYC (Uthibitishaji wa Kitambulisho + Passive Liveness + Face Match + Uchambuzi wa Kifaa & IP), 500 / mwezi, kila mwezi
Watumiaji Waliozuiwa
Utambuzi wa Marudio
Ishara 200+ za udanganyifu kwenye kila session
KYC inayoweza kutumika tena kwenye mtandao wa Didit
Jukwaa la Usimamizi wa Kesi
Workflow Builder
Nyaraka za umma, sandbox, SDKs, server ya MCP (Model Context Protocol)
Anza bure → lipa tu wakati ukaguzi unafanyika → fungua Enterprise kwa mkataba maalum, SLA, au uhifadhi wa data.
FAQ
Maswali ya kawaida
What is Didit?
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:
Fast, sub-2-second p99 on every session
Reliable, in production with 1,500+ companies across 220+ countries
Secure, SOC 2 Type 1, ISO 27001, GDPR-native, and formally attested by Spain's financial regulator as safer than verifying someone in person
The footprint underneath: 14,000+ document types in 48+ 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.
What is eIDAS 2.0, in plain English?
eIDAS 2.0, short for electronic IDentification, Authentication and trust Services, is the EU's 2024 update to its identity rulebook. The headline change is the European Digital Identity Wallet (often shortened to EUDI Wallet): a smartphone app every EU citizen and resident will be entitled to by the end of 2026.
The wallet holds verifiable credentials, a digital driving licence, a verified-identity attestation, an academic diploma, issued by trusted parties and presented to relying parties with cryptographic proof, optionally with selective disclosure (prove you are over 18 without revealing your full date of birth).
For businesses, eIDAS 2.0 is about both accepting wallet-presented credentials and issuing the credentials your users carry.
Who has to support the EUDI Wallet, and when?
Mandatory acceptance is rolling in by sector:
Public services, every EU member state must offer wallet-based identification for tax filing, social security, voting registration by 2026
Very Large Online Platforms (VLOPs) under the Digital Services Act, must accept wallet credentials when an identity check is required
Banks and payment service providers, wallet acceptance built into the upcoming PSD3 / Payment Services Regulation
Healthcare and academic credential issuers, voluntary at first, increasing pressure over the decade
Outside the mandatory list, every EU business has the option to issue and accept wallet credentials voluntarily, and most regulated businesses will, because the user experience is dramatically better than re-running a full KYC.
How fast is the verification for my end user?
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.
How is reusable identity different from federated login (Sign in with Apple, Google)?
Federated login proves an account exists with the identity provider, the receiving business gets an email address and maybe a name. That is not regulatory-grade identity.
Reusable identity carries:
A government-document-grade verification (passport, national identity card scanned and OCR'd)
A biometric link to the human presenting the credential (selfie matched to the document portrait)
A liveness check that catches deepfakes, masks, replay attacks
An AML status screened against sanctions, PEP, and adverse-media lists
A signed attestation from a regulated provider, time-stamped, with a verifiable trail
The verifier gets the same regulatory comfort it would get from running its own KYC, without the cost, the friction, and the conversion drop.
What happens if a user fails, abandons, or expires?
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.
Where does my customer data live and how is it protected?
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 audit in progress), 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.
Is Didit compliant for my industry?
Didit ships compliant by default for the regulators that matter to identity infrastructure:
GDPR + UK GDPR, controller / processor split, full Data Processing Agreement published, lead supervisory authority named (Spain''s AEPD).
AMLD6 + EU AML Single Rulebook, 1,300+ sanctions, politically exposed person, and adverse-media lists screened in real time.
eIDAS 2.0, EU Digital Identity Wallet aligned; reusable-identity ready.
MiCA (Markets in Crypto-Assets), ready for crypto on-ramps, exchanges, and custodians.
DORA, Digital Operational Resilience Act, EU financial-services operational resilience.
BIPA, CUBI, Washington HB 1493, CCPA / CPRA, US biometric privacy (Illinois, Texas, Washington) and California consumer privacy.
UK Online Safety Act, age-gating and child-safety obligations.
FATF Travel Rule, originator and beneficiary data on crypto transfers, IVMS-101 interoperable.
Reusable identity is a privacy upgrade on the legacy KYC stack:
Selective disclosure is built in, the verifier sees only the fields needed, not the underlying document
No central registry, the credential lives in the user's wallet, not on a Didit-owned ledger of who-presented-what-to-whom
Per-presentation consent, the user approves each disclosure explicitly
EU-resident storage, the issuer-side evidence pack stays in EU data centres; the wallet itself is on the user's device
Right to be forgotten, when a user revokes a credential, the receiving platform must drop it from its records under GDPR; Didit's per-platform revocation API makes this one call
The legal basis for processing on the receiving side is legitimate interest under GDPR, the user has explicitly presented a credential to access the service. Didit's standard Data Processing Agreement (DPA) covers the joint-controller relationship.
What if the user changes their identity document or moves country?
Three trigger types:
Document renewal (passport expires, new national identity card issued) → the user re-runs a lightweight refresh in the Didit app; the credential is reissued with the new document fingerprint
Material identity change (new legal name, gender marker change, country of residence change) → full re-verification at $0.33; the old credential is revoked and a new one issued
AML status change (a previously-clean user becomes a PEP or hits a sanctions list) → Didit's continuous monitoring flags the change automatically, the credential's AML field is updated, and every receiving platform sees the refreshed status on next presentation
The receiving platform never has to chase the user for updates, the credential carries its own freshness signal, and stale credentials are rejected at presentation time.
What evidence does a regulator see for a reused verification?
The verifier (the receiving platform) gets the same per-presentation evidence pack the original verifier got, plus the chain of issuance:
The original KYC evidence, document scan, biometric similarity, AML hits, device + IP risk signals, signed timestamps
The issuance chain, which Didit-powered platform issued the credential, when, on which workflow
The presentation log, when this user presented to your platform, which fields they disclosed, your verifier's verdict
The current AML status, refreshed daily by Didit's continuous monitoring
The HMAC SHA-256 signature on every field, so chain-of-custody is provable
Didit is the only KYC provider with a formal EU member-state government attestation, Spain's Treasury, Banco de España, and SEPBLAC jointly attested the service as safer than in-person verification. That attestation extends to every reused presentation.