Installez les douze compétences d'agent open source de Didit dans Cursor, Claude Code, Codex ou OpenCode avec une seule commande `npx`. Demandez à l'agent en langage naturel. Il écrit le code et appelle l'API en direct.
Robinhood Ventures
Approuvé par plus de 2 000 organisations dans le monde entier.
Pourquoi des compétences, pas des docs
Donnez un onglet de documentation à Cursor et il invente des endpoints et met en minuscules les énumérations de statut. Donnez-lui une compétence Didit et chaque ligne pointe vers la vraie API, endpoint verrouillé, en-têtes verrouillés, gestionnaire de webhook signé échafaudé. Une seule commande `npx`.
Exécutez `npx skills add didit-protocol/skills` dans votre projet. La CLI détecte Cursor, Claude Code, Codex ou OpenCode et dépose chaque compétence dans le bon dossier. Installez-en une seule avec `--skill didit-face-match`.
Soit vous en obtenez une en 60 secondes sur [business.didit.me](https://business.didit.me) et `export DIDIT_API_KEY=…`, soit vous laissez l'agent s'enregistrer programmatiquement, `POST /programmatic/register/` suivi de `verify-email/`, et une clé est renvoyée dans la réponse. Aucun navigateur n'est nécessaire.
*« Ajoutez le KYC Didit à mon flux d'inscription. »* *« Vérifiez cet utilisateur par rapport aux listes AML. »* L'agent lit la compétence pertinente, écrit le code et câble le gestionnaire de webhook signé. Correct du premier coup, pas de basculement d'onglet de documentation.
Didit héberge la caméra, la capture de documents, le selfie, le transfert mobile. Moins de 30 secondes pour l'utilisateur. Verdict en moins de 2 secondes sur votre webhook, signé avec `X-Signature-V2` pour que vous puissiez lui faire confiance.
Didit · Catalogue
Didit · npx install
Didit · Hôtes
Didit · Quelles compétences verrouillent
Didit · Configuration
Didit · github.com/didit-protocol/skills
Dans chaque skill
Trois chemins d'installation
$ npx skills add didit-protocol/skills
✓ 12 compétences installées
# 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 détectés automatiquement.$ 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 $ / mois. Aucune carte de crédit requise.
Payez uniquement ce que vous utilisez. Plus de 25 modules. Tarification publique par module, sans minimum mensuel.
MSA et SLA personnalisés. Pour les gros volumes et les programmes réglementés.
Commence gratuitement → ne paie que lorsqu'une vérification est effectuée → débloque l'Enterprise pour un contrat personnalisé, un SLA ou la résidence des données.
Didit est une infrastructure pour l'identité et la fraude, la plateforme que nous aurions aimé avoir lorsque nous développions nos propres produits : ouverte, flexible et conviviale pour les développeurs, afin qu'elle s'intègre réellement à ta stack au lieu d'être une boîte noire autour de laquelle tu dois t'adapter.
Une seule API couvre la vérification des personnes (KYC, know your customer), la vérification des entreprises (KYB, know your business), le filtrage des portefeuilles crypto (KYT, know your transaction), et la surveillance des transactions en temps réel, sur une stack conçue pour être :
L'empreinte sous-jacente : plus de 14 000 types de documents dans plus de 48 langues, plus de 1 000 sources de données et plus de 200 signaux de fraude sur chaque session. L'infrastructure Didit apprend dynamiquement de chaque session et s'améliore chaque jour.
Un petit fichier Markdown qui apprend à ton agent IA comment appeler l'une des API de Didit, point de terminaison, en-têtes, format du corps, cas d'erreur, avec du code fonctionnel en TypeScript, Python et cURL.
Installe-le une seule fois. La prochaine fois que tu demanderas à Cursor ou Claude Code « ajoute le KYC à mon flux d'inscription », l'agent lira la compétence et écrira le bon code du premier coup. Pas de changement d'onglet vers la documentation. Pas de points de terminaison inventés. Pas de mauvaise casse de statut.
C'est le standard ouvert Agent Skills. Didit en propose douze, gratuits et open-source sur github.com/didit-protocol/skills.
Une compétence par capacité Didit, douze au total, 51 points de terminaison testés de bout en bout :
Installe tout en une seule commande : npx skills add didit-protocol/skills. Installe-en une seule : npx skills add didit-protocol/skills --skill didit-face-match.
Le flux complet prend normalement moins de 30 secondes de bout en bout, prend l'ID, scanne le document, prend le selfie, c'est fait. C'est le plus rapide du marché. Les fournisseurs KYC traditionnels prennent généralement plus de 90 secondes pour le même flux.
En arrière-plan, Didit renvoie le résultat en moins de deux secondes à p99, mesuré à partir du moment où l'utilisateur termine le selfie jusqu'au moment où ton webhook se déclenche. La capture mobile est optimisée pour les téléphones lents et les réseaux lents : compression d'image progressive, chargement paresseux du kit de développement logiciel, et un transfert en un clic du bureau au téléphone via code QR si l'utilisateur commence sur le web.
Cursor, Claude Code, Codex et OpenCode, plus tout ce qui suit le standard ouvert agentskills.io.
La CLI npx détecte ton agent et dépose la compétence au bon endroit, .claude/skills/, .cursor/skills/, etc. Le même fichier Markdown partout, pas de SDK spécifique à l'hôte.
En coulisses, chaque compétence pointe vers la même API https://verification.didit.me/v3/* avec le même en-tête x-api-key et le même webhook signé. La compétence est juste la façon dont l'agent la lit.
Chaque session aboutit à l'un des sept statuts clairs, afin que ton code sache toujours quoi faire :
Approved, toutes les vérifications sont passées. Fais avancer l'utilisateur.Declined, une ou plusieurs vérifications ont échoué. Tu peux permettre à l'utilisateur de soumettre à nouveau l'étape spécifique qui a échoué (par exemple, reprendre le selfie) sans relancer tout le flux.In Review, signalé pour examen de conformité. Ouvre le cas dans la console, vois tous les signaux, décide d'approuver ou de refuser.In Progress, l'utilisateur est en cours de flux.Not Started, lien envoyé, l'utilisateur ne l'a pas encore ouvert. Envoie un rappel s'il reste trop longtemps.Abandoned, l'utilisateur a ouvert le lien mais n'a pas terminé à temps. Relance ou expire.Expired, le lien de session a expiré. Crée une nouvelle session.Un webhook signé se déclenche à chaque changement de statut, afin que ta base de données reste toujours synchronisée. Les sessions abandonnées et refusées sont gratuites.
Par défaut, les données de production sont traitées et stockées dans l'Union Européenne, sur Amazon Web Services. Les contrats d'entreprise peuvent demander des régions alternatives pour les juridictions dont les régulateurs l'exigent.
Chiffrement partout. AES-256 au repos sur chaque base de données, stockage d'objets et sauvegarde. Transport Layer Security 1.3 en transit sur chaque appel API, webhook et session de la console Business. Les données biométriques sont chiffrées sous une clé de chiffrement client (Customer Master Key) distincte.
La rétention est sous ton contrôle. La rétention par défaut est indéfinie (illimitée), sauf si tu la configures plus courte, entre 30 jours et 10 ans par application, et tu peux supprimer n'importe quelle session individuelle à tout moment depuis le tableau de bord ou l'API.
Certifications : SOC 2 Type 1 (audit Type 2 en cours), ISO/IEC 27001:2022, iBeta Level 1 PAD, et une attestation publique du Tesoro / SEPBLAC / CNMV espagnol confirmant que la vérification d'identité à distance de Didit est plus sûre qu'une vérification en personne. Rapport complet sur /security-compliance.
Didit est conforme par défaut aux régulateurs importants pour l'infrastructure d'identité :
Note détaillée, chaque certificat, chaque lettre de régulateur : /security-compliance.
Trois chemins d'intégration, choisis celui qui correspond à ta stack :
Même tableau de bord, même facturation, même prix par succès pour les trois. Guide étape par étape sur docs.didit.me/integration/integration-prompt.
Une seule commande :
``bash
npx skills add didit-protocol/skills
``
La CLI détecte si tu es dans Cursor, Claude Code, Codex ou OpenCode et dépose chaque compétence dans le bon dossier. Installe-en une seule avec --skill didit-face-match.
Tu préfères Git ? git clone https://github.com/didit-protocol/skills et copie ce que tu veux. Tu préfères sans outils ? Ouvre le dépôt et copie un seul SKILL.md dans le répertoire de compétences de ton agent, chaque compétence est autonome.
La seule variable d'environnement dont chaque compétence a besoin est DIDIT_API_KEY. Obtenez-en une en 60 secondes sur business.didit.me, ou laisse l'agent s'enregistrer programmatiquement via POST /programmatic/register/.
En langage clair, sans jargon ni formules toutes faites :
L'agent lit la compétence pertinente et écrit du code prêt pour la production en TypeScript, Python ou Bash. Pas de devinettes : la compétence fournit le point de terminaison exact, l'en-tête, le corps et l'énumération de statut.
La documentation est écrite pour les humains. Les agents trébuchent encore et encore sur les mêmes choses :
POST /v3/wallet-screening/ alors que le vrai chemin se trouve dans /v3/transactions/Approved, KYB est APPROVED, les agents les mélangentLes compétences verrouillent tout cela. Versionnées en même temps que l'API : quand Didit déploie un nouveau point de terminaison, la compétence est déployée le même jour. 51 points de terminaison testés, à chaque version.
Une seule API pour le KYC, le KYB, la surveillance des transactions et le screening de portefeuilles. Intégration en 5 minutes.