Instal·la les dotze Habilitats d'Agent de codi obert de Didit a Cursor, Claude Code, Codex o OpenCode amb una sola comanda `npx`. Pregunta a l'agent en llenguatge natural. Escriu el codi i crida l'API en viu.
Robinhood Ventures
Confiat per més de 2.000 organitzacions a tot el món.
Per què habilitats i no documentació?
Dóna-li a Cursor una pestanya de documentació i inventarà endpoints i posarà en minúscules els enums d'estat. Dóna-li una habilitat de Didit i cada línia apunta a l'API real, endpoint bloquejat, capçaleres bloquejades, scaffold de gestor de webhook signat. Una comanda `npx`.
Executa `npx skills add didit-protocol/skills` al teu projecte. La CLI detecta Cursor, Claude Code, Codex o OpenCode i col·loca cada habilitat a la carpeta correcta. Instal·la'n només una amb `--skill didit-face-match`.
O bé n'agafes una en 60 segons a [business.didit.me](https://business.didit.me) i `export DIDIT_API_KEY=…`, o bé deixes que l'agent es registri programàticament, `POST /programmatic/register/` seguit de `verify-email/`, i una clau torna a la resposta. No cal navegador.
*“Afegeix Didit KYC al meu flux de registre.”* *“Comprova aquest usuari contra les llistes AML.”* L'agent llegeix l'habilitat rellevant, escriu el codi i configura el gestor de webhook signat. Correcte al primer intent, sense canviar de pestanya de documentació.
Didit allotja la càmera, la captura de documents, el selfie, el traspàs mòbil. Menys de 30 segons per a l'usuari. Veredicte en menys de 2 segons al teu webhook, signat amb `X-Signature-V2` perquè puguis confiar-hi.
Didit · Catàleg
Didit · npx install
Didit · Hosts
Didit · Quines habilitats bloquegen
Didit · Configuració
Didit · github.com/didit-protocol/skills
A cada skill
Tres rutes d'instal·lació
$ npx skills add didit-protocol/skills
✓ 12 "skills" instal·lades
# 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 detectats automàticament.$ 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 $ / mes. No es requereix targeta de crèdit.
Paga només pel que utilitzes. Més de 25 mòduls. Preus públics per mòdul, sense quota mínima mensual.
MSA i SLA personalitzats. Per a grans volums i programes regulats.
Comença gratis → paga només quan s'executa una comprovació → desbloqueja Enterprise per a un contracte personalitzat, SLA o residència de dades.
Didit és la infraestructura per a la identitat i el frau, la plataforma que ens hauria agradat tenir quan construíem productes nosaltres mateixos: oberta, flexible i amigable per a desenvolupadors, perquè funcioni com una part real del teu stack en lloc d'una caixa negra que integres al voltant.
Una API cobreix la verificació de persones (KYC, know your customer), la verificació d'empreses (KYB, know your business), el cribratge de carteres de criptomonedes (KYT, know your transaction), i la monitorització de transaccions en temps real, en un stack construït per ser:
La petjada subjacent: més de 14.000 tipus de documents en més de 48 idiomes, més de 1.000 fonts de dades, i més de 200 senyals de frau en cada sessió. La infraestructura de Didit aprèn dinàmicament de cada sessió i millora cada dia.
Un petit fitxer Markdown que ensenya al teu agent d'IA com cridar una de les API de Didit, endpoint, capçaleres, forma del cos, casos d'error, amb codi funcional en TypeScript, Python i cURL.
Instal·la-ho una vegada. La propera vegada que preguntis a Cursor o Claude Code “afegeix KYC al meu flux de registre”, l'agent llegeix l'habilitat i escriu el codi correcte al primer intent. Sense canviar de pestanya per a la documentació. Sense endpoints inventats. Sense majúscules d'estat incorrectes.
És l'estàndard obert Agent Skills. Didit n'ofereix dotze, gratuïtes i de codi obert a github.com/didit-protocol/skills.
Una skill per cada capacitat de Didit, dotze en total, 51 endpoints provats de principi a fi:
Instal·la-ho tot amb una sola ordre: npx skills add didit-protocol/skills. Instal·la només una: npx skills add didit-protocol/skills --skill didit-face-match.
El flux complet normalment triga menys de 30 segons de principi a fi, agafa la identificació, fes la foto del document, fes la foto del selfie, fet. Això és el més ràpid del mercat. Els proveïdors de KYC antics solen trigar més de 90 segons per al mateix flux.
Al backend, Didit retorna el resultat en menys de dos segons a p99, mesurat des del moment en què l'usuari acaba el selfie fins al moment en què s'activa el teu webhook. La captura mòbil està optimitzada per a telèfons lents i xarxes lentes: compressió progressiva d'imatges, càrrega de SDK de càrrega lenta i un traspàs amb un sol toc de l'escriptori al telèfon mitjançant codi QR si l'usuari comença des del web.
Cursor, Claude Code, Codex i OpenCode, a més de qualsevol cosa que segueixi l'estàndard obert agentskills.io.
La CLI npx detecta el teu agent i col·loca cada skill al lloc correcte, .claude/skills/, .cursor/skills/, etc. El mateix fitxer Markdown a tot arreu, sense SDK específic de l'amfitrió.
Sota el capó, cada skill apunta a la mateixa API https://verification.didit.me/v3/* amb la mateixa capçalera x-api-key i el mateix webhook signat. La skill és només la manera com l'agent la llegeix.
Cada sessió té un dels set estats clars, així el teu codi sempre sap què fer:
Approved, totes les comprovacions superades. Fes avançar l'usuari.Declined, una o més comprovacions han fallat. Pots permetre a l'usuari tornar a enviar el pas específic que ha fallat (per exemple, tornar a fer-se el selfie) sense haver de tornar a executar tot el flux.In Review, marcat per a revisió de compliment. Obre el cas a la consola, consulta tots els senyals, decideix si aproves o denegues.In Progress, l'usuari està a mig flux.Not Started, enllaç enviat, l'usuari encara no l'ha obert. Envia un recordatori si triga massa.Abandoned, l'usuari va obrir l'enllaç però no va acabar a temps. Torna a contactar o caduca.Expired, l'enllaç de la sessió ha caducat. Crea una nova sessió.Un webhook signat s'activa amb cada canvi d'estat, així la teva base de dades sempre es manté sincronitzada. Les sessions abandonades i denegades són gratuïtes.
Per defecte, les dades de producció es processen i s'emmagatzemen a la Unió Europea, a Amazon Web Services. Els contractes empresarials poden sol·licitar regions alternatives per a jurisdiccions que ho requereixin els seus reguladors.
Xifratge a tot arreu. AES-256 en repòs a totes les bases de dades, emmagatzematge d'objectes i còpies de seguretat. Transport Layer Security 1.3 en trànsit a cada trucada d'API, webhook i sessió de la Consola de Negocis. Les dades biomètriques es xifren sota una Customer Master Key separada.
La retenció la controles tu. La retenció per defecte és indefinida (il·limitada), tret que configuris un període més curt,entre 30 dies i 10 anys per aplicació, i pots eliminar qualsevol sessió individual en qualsevol moment des del tauler de control o l'API.
Certificacions: SOC 2 Type 1 (auditoria Type 2 en curs), ISO/IEC 27001:2022, iBeta Level 1 PAD, i una certificació pública del Tesoro / SEPBLAC / CNMV d'Espanya que la verificació remota d'identitat de Didit és més segura que verificar algú en persona. Informe complet a /security-compliance.
Didit compleix per defecte amb els reguladors més importants per a la infraestructura d'identitat:
Memòria detallada, tots els certificats, totes les cartes reguladores: /security-compliance.
Tres rutes d'integració, tria la que millor s'adapti al teu stack:
Mateix tauler de control, mateixa facturació, mateix preu de pagament per èxit per als tres. Guia pas a pas a docs.didit.me/integration/integration-prompt.
Una ordre:
``bash
npx skills add didit-protocol/skills
``
La CLI detecta si estàs a Cursor, Claude Code, Codex o OpenCode i col·loca cada skill a la carpeta correcta. Instal·la només una amb --skill didit-face-match.
Prefereixes Git? git clone https://github.com/didit-protocol/skills i copia el que vulguis. Prefereixes sense eines? Obre el repositori i copia un sol SKILL.md al directori de skills del teu agent, cada skill és autònoma.
L'única variable d'entorn que necessita cada skill és DIDIT_API_KEY. Aconsegueix-ne una en 60 segons a business.didit.me, o deixa que l'agent es registri programàticament mitjançant POST /programmatic/register/.
Anglès senzill, sense argot ni text repetitiu:
L'agent llegeix l'habilitat rellevant i escriu codi llest per a producció en TypeScript, Python o Bash. Sense conjectures: l'habilitat proporciona l'endpoint, la capçalera, el cos i l'enumeració d'estat exactes.
La documentació està escrita per a humans. Els agents ensopeguen amb les mateixes coses una vegada i una altra:
POST /v3/wallet-screening/ quan la ruta real es troba dins de /v3/transactions/Approved, KYB és APPROVED, els agents els confonenLes habilitats bloquegen tot això. Versionades juntament amb l'API: quan Didit llança un nou endpoint, l'habilitat es llança el mateix dia. 51 endpoints provats, a cada llançament.
Una API per a KYC, KYB, monitorització de transaccions i anàlisi de carteres. Integra-la en 5 minuts.