Installiere Didits zwölf Open-Source Agent Skills in Cursor, Claude Code, Codex oder OpenCode mit einem einzigen `npx`-Befehl. Frage den Agenten in einfachem Deutsch. Er schreibt den Code und ruft die Live-API auf.
Robinhood Ventures
Über 2.000 Organisationen weltweit vertrauen uns.
Warum Skills, nicht Docs?
Gib Cursor einen Dokumentations-Tab und er erfindet Endpunkte und schreibt Status-Enums klein. Gib ihm einen Didit Skill und jede Zeile verweist auf die echte API, gesperrter Endpunkt, gesperrte Header, signierter Webhook-Handler als Gerüst. Ein `npx` Befehl.
Führe `npx skills add didit-protocol/skills` in deinem Projekt aus. Die CLI erkennt Cursor, Claude Code, Codex oder OpenCode und legt jeden Skill im richtigen Ordner ab. Installiere nur einen mit `--skill didit-face-match`.
Entweder holst du dir einen in 60 Sekunden auf [business.didit.me](https://business.didit.me) und `export DIDIT_API_KEY=…`, oder der Agent registriert sich programmatisch, `POST /programmatic/register/` gefolgt von `verify-email/`, und ein Key kommt in der Antwort zurück. Kein Browser nötig.
*„Füge Didit KYC zu meinem Anmelde-Flow hinzu.“* *„Überprüfe diesen Nutzer anhand von AML-Listen.“* Der Agent liest den relevanten Skill, schreibt den Code und verdrahtet den signierten Webhook-Handler. Beim ersten Versuch korrekt, kein Wechsel zwischen Dokumentations-Tabs.
Didit hostet die Kamera, die Dokumentenerfassung, das Selfie, die mobile Übergabe. Unter 30 Sekunden für den Nutzer. Unter 2 Sekunden Urteil auf deinem Webhook, signiert mit `X-Signature-V2`, damit du ihm vertrauen kannst.
Didit · Katalog
Didit · npx install
Didit · Hosts
Didit · Welche Skills sperren
Didit · Setup
Didit · github.com/didit-protocol/skills
In jedem Skill
Drei Installationspfade
$ npx skills add didit-protocol/skills
✓ 12 Skills installiert
# or just one
$ npx skills add didit-protocol/skills \
--skill didit-face-match
# set the api key
$ export DIDIT_API_KEY="sk_live_..."Cursor, Claude Code, Codex, OpenCode automatisch erkannt.$ curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workflow_id": "$DIDIT_WORKFLOW_ID",
"vendor_data": "user-42",
"callback_url": "https://app/cb"
}'{ "url": "verify.didit.me/..." }You are installing the Didit Agent Skills into this project and wiring the first verification session against the live https://verification.didit.me/v3/ API. After this prompt, the project should pass identity verification — Know Your Customer (KYC), Anti-Money Laundering (AML) screening, document Optical Character Recognition (OCR) — through Didit.
Didit ships twelve open-source Agent Skills at https://github.com/didit-protocol/skills and follows the open standard at https://agentskills.io. The CLI auto-detects whether you are running inside Cursor, Claude Code, Codex, or OpenCode and drops the skills into the right folder.
PRE-REQUISITES
- A Didit API key (DIDIT_API_KEY). Either issued from https://business.didit.me, or self-registered by the agent via POST /programmatic/register/ + POST /programmatic/verify-email/ (no browser needed).
- A workflow_id from the Workflow Builder that bundles ID Verification + Passive Liveness + Face Match + IP Analysis + AML — or just use the didit-kyc-onboarding skill below to create one programmatically.
- A webhook endpoint that verifies the X-Signature-V2 header with HMAC-SHA256 on the raw body bytes (do NOT re-serialise the parsed JSON; the signature will not match).
STEP 1 — Install the skills
Recommended:
npx skills add didit-protocol/skills
This installs all twelve skills. To install only one:
npx skills add didit-protocol/skills --skill didit-face-match
Or git clone the repo and copy what you need:
git clone https://github.com/didit-protocol/skills.git
cp -r skills/didit-kyc-onboarding .claude/skills/
cp -r skills/didit-id-document-verification .claude/skills/
The twelve skills:
- didit-verification-management : the hub. Account, sessions, workflows, billing, blocklist, webhook config. 45+ endpoints
- didit-kyc-onboarding : full KYC recipe (ID + selfie + face match) in one call
- didit-id-document-verification : passports, ID cards, driver's licences. OCR, MRZ, NFC. 4,000+ documents, 220+ countries
- didit-liveness-detection : 99.9%-accurate liveness from a single selfie
- didit-face-match : compare two faces, get a 0–100 score
- didit-face-search : 1:N face search for deduplication and blocklists
- didit-biometric-age-estimation : estimate age from a selfie
- didit-email-verification : email OTP, detects breached / disposable / undeliverable
- didit-phone-verification : phone OTP via SMS, WhatsApp, or Telegram. Catches VoIP
- didit-aml-screening : 1,300+ sanctions, PEP, adverse-media lists. Dual-score risk
- didit-proof-of-address : utility bills, bank statements. OCR + geocoding
- didit-database-validation : government databases across 18 countries
STEP 2 — Set the environment
Every skill reads DIDIT_API_KEY. Session-based skills also expect DIDIT_WORKFLOW_ID. Signed-webhook handlers expect DIDIT_WEBHOOK_SECRET.
export DIDIT_API_KEY="<your api key>"
export DIDIT_WORKFLOW_ID="<your workflow id>" # optional
export DIDIT_WEBHOOK_SECRET="<your secret>" # optional
Programmatic alternative (no browser):
curl -X POST https://apx.didit.me/auth/v2/programmatic/register/ \
-H "Content-Type: application/json" \
-d '{"email": "dev@example.com", "password": "MyStr0ng!Pass"}'
# check the email, get the 6-char code, then:
curl -X POST https://apx.didit.me/auth/v2/programmatic/verify-email/ \
-H "Content-Type: application/json" \
-d '{"email": "dev@example.com", "code": "<code>"}'
# response includes api_key — export it as DIDIT_API_KEY.
STEP 3 — Create a verification session
POST https://verification.didit.me/v3/session/
Headers:
x-api-key: $DIDIT_API_KEY
Content-Type: application/json
Body:
{
"workflow_id": "$DIDIT_WORKFLOW_ID",
"vendor_data": "<your user id, max 256 chars>",
"callback_url": "https://<your-app>/kyc/callback",
"metadata": { "source": "agent-skill" }
}
Response: 201 Created. The hosted session URL is on the `url` field. Redirect the user, or send them the link by email / SMS / WhatsApp. Sub-2-second p99 verdict on completion.
STEP 4 — Read the signed webhook
Didit POSTs to your callback. KYC session statuses are 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 },
"aml": { "status": "Approved", "hits": [] }
}
Full enum:
Approved | Declined | In Review | In Progress | Not Started | Abandoned | Expired | Resubmitted | Awaiting User | Not Finished
Verify X-Signature-V2 BEFORE parsing the body — HMAC-SHA256 of the raw bytes with your webhook secret. Re-serialising the parsed body changes whitespace and key order and the signature will not match.
STEP 5 — Read the decision on demand
GET https://verification.didit.me/v3/session/{sessionId}/decision/
Headers:
x-api-key: $DIDIT_API_KEY
Returns the full decision payload — id_verification, liveness, face, ip_analysis, aml. Use this whenever the agent needs to confirm the user's status before allowing an action. Never trust client-supplied "I'm verified" flags.
STEP 6 — Branch on status
Approved → continue
Declined → block, surface decision_reason_code, allow resubmit of the failed step
In Review → wait for the analyst webhook; don't block forever
Resubmitted → user re-took a failed step; new verdict is coming
Awaiting User → user hasn't completed the flow; nudge with a reminder
Expired → create a new session
Abandoned and Declined sessions are NOT billed.
STEP 7 — Optional: ongoing AML monitoring
If AML monitoring is enabled on the workflow ($0.07 per user per year), Didit fires status.updated whenever the user lands on a new sanctions / PEP / adverse-media list. No extra endpoint to call.
WEBHOOK EVENT NAMES
- status.updated : KYC or KYB session status changed
- data.updated : session data corrected after creation
- user.status.updated : User entity changed status (Active, Flagged, Blocked)
- user.data.updated : User entity counters, metadata, or aggregate fields changed
- activity.created : timeline activity recorded
Verify X-Signature-V2 on every payload. The webhook secret is per-environment — sandbox is separate from production.
CONSTRAINTS
- KYC session statuses use Title Case With Spaces (Approved, In Review). Do NOT transform them to UPPER_SNAKE_CASE — that casing is for Know Your Business (KYB) sessions and Transaction Monitoring, not KYC.
- HMAC verification runs against the RAW request body bytes. Never re-serialise the parsed JSON.
- Bundle price is $0.30 (ID + Liveness + Face Match + IP Analysis). AML adds $0.20. 500 verifications free every month, forever.
- Default record retention is unlimited unless you configure it shorter (30 days to 10 years per application).
Read the docs:
- https://docs.didit.me/getting-started/agent-skills
- https://docs.didit.me/sessions-api/create-session
- https://docs.didit.me/sessions-api/retrieve-session
- https://docs.didit.me/integration/webhooks
Skills repo:
- https://github.com/didit-protocol/skills
Start free at https://business.didit.me — sandbox key in 60 seconds, 500 verifications free every month, no credit card.$0 / Monat. Keine Kreditkarte erforderlich.
Zahle nur, was du nutzt. Über 25 Module. Öffentliche Preise pro Modul, keine monatliche Mindestgebühr.
Individuelle MSA & SLA. Für große Volumina und regulierte Programme.
Kostenlos starten → nur zahlen, wenn eine Prüfung läuft → Enterprise für einen individuellen Vertrag, SLA oder Datenresidenz freischalten.
Didit ist die Infrastruktur für Identität und Betrug, die Plattform, die wir uns gewünscht hätten, als wir selbst Produkte entwickelten: offen, flexibel und entwicklerfreundlich, sodass sie als echter Teil deines Stacks funktioniert, anstatt einer Blackbox, um die du herum integrieren musst.
Eine API deckt die Verifizierung von Personen (KYC, Know Your Customer), die Verifizierung von Unternehmen (KYB, Know Your Business), das Screening von Krypto-Wallets (KYT, Know Your Transaction) und die Echtzeit-Transaktionsüberwachung ab, auf einem Stack, der darauf ausgelegt ist, zu sein:
Die zugrunde liegende Abdeckung: über 14.000 Dokumententypen in über 48 Sprachen, über 1.000 Datenquellen und über 200 Betrugssignale bei jeder Sitzung. Die Didit-Infrastruktur lernt dynamisch aus jeder Sitzung und wird täglich besser.
Eine kleine Markdown-Datei, die deinem KI-Agenten beibringt, wie er eine der Didit-APIs aufruft, Endpunkt, Header, Body-Struktur, Fehlerfälle, mit funktionierendem Code in TypeScript, Python und cURL.
Einmal installieren. Wenn du Cursor oder Claude Code das nächste Mal fragst: „Füge KYC zu meinem Anmelde-Flow hinzu“, liest der Agent den Skill und schreibt den richtigen Code auf Anhieb. Kein Wechsel zu Docs. Keine erfundenen Endpunkte. Keine falschen Status-Casing.
Es ist der Agent Skills Open Standard. Didit liefert zwölf davon, kostenlos und Open Source unter github.com/didit-protocol/skills.
Ein Skill pro Didit-Funktion, insgesamt zwölf, 51 Endpunkte End-to-End getestet:
Installiere alle mit einem Befehl: npx skills add didit-protocol/skills. Installiere nur einen: npx skills add didit-protocol/skills --skill didit-face-match.
Der gesamte Flow dauert normalerweise unter 30 Sekunden End-to-End, ID aufnehmen, Dokument scannen, Selfie machen, fertig. Das ist der schnellste auf dem Markt. Herkömmliche KYC-Anbieter benötigen für denselben Flow in der Regel mehr als 90 Sekunden.
Im Backend liefert Didit das Ergebnis in unter zwei Sekunden bei p99, gemessen vom Zeitpunkt, an dem der Nutzer das Selfie beendet, bis zum Zeitpunkt, an dem dein Webhook ausgelöst wird. Die mobile Erfassung ist für langsame Telefone und langsame Netzwerke optimiert: progressive Bildkomprimierung, Lazy-Load des Software Development Kits und eine One-Tap-Übergabe vom Desktop zum Telefon per QR-Code, wenn der Nutzer am Web beginnt.
Cursor, Claude Code, Codex und OpenCode, plus alles, was dem agentskills.io Open Standard folgt.
Die npx-CLI erkennt deinen Agenten und legt jeden Skill im richtigen Ordner ab, .claude/skills/, .cursor/skills/ und so weiter. Dieselbe Markdown-Datei überall, kein hostspezifisches SDK.
Unter der Haube verweist jeder Skill auf dieselbe https://verification.didit.me/v3/* API mit demselben x-api-key-Header und demselben signierten Webhook. Der Skill ist lediglich die Art und Weise, wie der Agent ihn liest.
Jede Sitzung landet in einem von sieben klaren Status, sodass dein Code immer weiß, was zu tun ist:
Approved, alle Prüfungen bestanden. Den Nutzer weiterleiten.Declined, eine oder mehrere Prüfungen fehlgeschlagen. Du kannst dem Nutzer erlauben, den spezifischen fehlgeschlagenen Schritt (z.B. das Selfie erneut aufnehmen) erneut einzureichen, ohne den gesamten Flow erneut auszuführen.In Review, zur Compliance-Prüfung markiert. Öffne den Fall in der Konsole, sieh dir alle Signale an, entscheide über Genehmigung oder Ablehnung.In Progress, der Nutzer befindet sich mitten im Flow.Not Started, Link gesendet, Nutzer hat ihn noch nicht geöffnet. Sende eine Erinnerung, wenn er zu lange unbeachtet bleibt.Abandoned, Nutzer hat den Link geöffnet, aber nicht rechtzeitig abgeschlossen. Erneut ansprechen oder ablaufen lassen.Expired, der Sitzungslink ist abgelaufen. Erstelle eine neue Sitzung.Ein signierter Webhook wird bei jeder Statusänderung ausgelöst, sodass deine Datenbank immer synchron bleibt. Abgebrochene und abgelehnte Sitzungen sind kostenlos.
Produktionsdaten werden standardmäßig in der Europäischen Union auf Amazon Web Services verarbeitet und gespeichert. Für Enterprise-Verträge können alternative Regionen angefragt werden, wenn Aufsichtsbehörden dies erfordern.
Verschlüsselung überall. AES-256 im Ruhezustand über jede Datenbank, jeden Objektspeicher und jedes Backup. Transport Layer Security 1.3 bei der Übertragung bei jedem API-Aufruf, Webhook und jeder Business Console-Sitzung. Biometrische Daten werden mit einem separaten Customer Master Key verschlüsselt.
Die Aufbewahrung liegt in deiner Hand. Die Standardaufbewahrungsfrist ist unbegrenzt, es sei denn, du konfigurierst eine kürzere, zwischen 30 Tagen und 10 Jahren pro Anwendung, und du kannst jede einzelne Sitzung jederzeit über das Dashboard oder die API löschen.
Zertifizierungen: SOC 2 Typ 1 (Typ 2 Audit läuft), ISO/IEC 27001:2022, iBeta Level 1 PAD und eine öffentliche Bestätigung von Spaniens Tesoro / SEPBLAC / CNMV, dass Didits Fernidentitätsprüfung sicherer ist als die persönliche Verifizierung. Vollständiger Bericht unter /security-compliance.
Didit ist standardmäßig konform mit den relevanten Regulierungsbehörden für Identitätsinfrastrukturen:
Ausführliches Memo, jedes Zertifikat, jedes Schreiben der Aufsichtsbehörde: /security-compliance.
Drei Integrationswege, wähle den, der zu deinem Stack passt:
Dasselbe Dashboard, dieselbe Abrechnung, derselbe Pay-per-Success-Preis für alle drei. Eine Schritt-für-Schritt-Anleitung findest du unter docs.didit.me/integration/integration-prompt.
Ein Befehl:
``bash
npx skills add didit-protocol/skills
``
Die CLI erkennt, ob du in Cursor, Claude Code, Codex oder OpenCode bist und legt jeden Skill im richtigen Ordner ab. Installiere nur einen mit --skill didit-face-match.
Bevorzugst du Git? git clone https://github.com/didit-protocol/skills und kopiere, was du möchtest. Bevorzugst du keine Tools? Öffne das Repo und kopiere eine einzelne SKILL.md in das Skill-Verzeichnis deines Agenten, jeder Skill ist eigenständig.
Die einzige Umgebungsvariable, die jeder Skill benötigt, ist DIDIT_API_KEY. Hol dir einen in 60 Sekunden auf business.didit.me, oder lass den Agenten sich programmatisch über POST /programmatic/register/ registrieren.
Klartext, ohne Fachjargon oder Boilerplate:
Der Agent liest die relevante Skill und schreibt produktionsreifen Code in TypeScript, Python oder Bash. Kein Rätselraten, die Skill liefert den exakten Endpunkt, Header, Body und Status-Enum.
Docs sind für Menschen geschrieben. Agents stolpern immer wieder über dieselben Dinge:
POST /v3/wallet-screening/, obwohl der echte Pfad in /v3/transactions/ liegtApproved, KYB ist APPROVED, Agents verwechseln dasSkills schließen all das aus. Sie werden zusammen mit der API versioniert: Wenn Didit einen neuen Endpunkt veröffentlicht, wird die Skill am selben Tag veröffentlicht. 51 Endpunkte getestet, bei jedem Release.
Eine API für KYC, KYB, Transaktionsüberwachung und Wallet-Screening. In 5 Minuten integriert.