Instala las doce Habilidades de Agente de código abierto de Didit en Cursor, Claude Code, Codex u OpenCode con un solo comando `npx`. Pregúntale al agente en español. Escribe el código y llama a la API en vivo.
Robinhood Ventures
Con la confianza de más de 2.000 organizaciones en todo el mundo.
¿Por qué habilidades y no documentación?
Dale a Cursor una pestaña de documentación e inventará endpoints y convertirá a minúsculas los enums de estado. Dale una habilidad de Didit y cada línea apuntará a la API real: endpoint bloqueado, encabezados bloqueados, manejador de webhook firmado preconfigurado. Un solo comando `npx`.
Ejecuta `npx skills add didit-protocol/skills` en tu proyecto. La CLI detecta Cursor, Claude Code, Codex u OpenCode y coloca cada habilidad en la carpeta correcta. Instala solo una con `--skill didit-face-match`.
Consigue una en 60 segundos en [business.didit.me](https://business.didit.me) y `export DIDIT_API_KEY=…`, o deja que el agente se registre programáticamente, `POST /programmatic/register/` seguido de `verify-email/`, y una clave te llegará en la respuesta. No necesitas navegador.
*“Añade Didit KYC a mi flujo de registro.”* *“Comprueba a este usuario contra las listas AML.”* El agente lee la habilidad relevante, escribe el código y conecta el manejador de webhook firmado. Correcto al primer intento, sin cambiar de pestaña de documentación.
Didit aloja la cámara, la captura de documentos, el selfie y la transferencia móvil. Menos de 30 segundos para el usuario. Veredicto en menos de 2 segundos en tu webhook, firmado con `X-Signature-V2` para que puedas confiar en él.
Didit · Catálogo
Didit · npx install
Didit · Hosts
Didit · Qué habilidades bloquea
Didit · Configuración
Didit · github.com/didit-protocol/skills
En cada skill
Tres rutas de instalación
$ npx skills add didit-protocol/skills
✓ 12 habilidades instaladas
# 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 detectados automáticamente.$ 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 se requiere tarjeta de crédito.
Paga solo por lo que usas. Más de 25 módulos. Precios públicos por módulo, sin cuota mínima mensual.
MSA y SLA personalizados. Para grandes volúmenes y programas regulados.
Empieza gratis → paga solo cuando se ejecuta una verificación → desbloquea Enterprise para un contrato personalizado, SLA o residencia de datos.
Didit es infraestructura para identidad y fraude, la plataforma que nos hubiera gustado tener cuando construíamos nuestros propios productos: abierta, flexible y amigable para desarrolladores, para que funcione como una parte real de tu stack en lugar de una caja negra que integras de forma externa.
Una API cubre la verificación de personas (KYC, know your customer), la verificación de empresas (KYB, know your business), el cribado de carteras de criptomonedas (KYT, know your transaction), y el monitoreo de transacciones en tiempo real, en un stack construido para ser:
La huella subyacente: más de 14.000 tipos de documentos en más de 48 idiomas, más de 1.000 fuentes de datos y más de 200 señales de fraude en cada sesión. La infraestructura de Didit aprende dinámicamente de cada sesión y mejora cada día.
Un pequeño archivo Markdown que enseña a tu agente de IA cómo llamar a una de las APIs de Didit, endpoint, cabeceras, estructura del cuerpo, casos de error, con código funcional en TypeScript, Python y cURL.
Instálalo una vez. La próxima vez que le preguntes a Cursor o Claude Code “añade KYC a mi flujo de registro”, el agente leerá la skill y escribirá el código correcto al primer intento. Sin cambiar de pestaña a la documentación. Sin endpoints inventados. Sin errores en el formato de estado.
Es el estándar abierto de Agent Skills. Didit ofrece doce de ellas, gratuitas y de código abierto en github.com/didit-protocol/skills.
Una skill por capacidad de Didit, doce en total, 51 endpoints probados de extremo a extremo:
Instala todas con un comando: npx skills add didit-protocol/skills. Instala solo una: npx skills add didit-protocol/skills --skill didit-face-match.
El flujo completo normalmente tarda menos de 30 segundos de principio a fin, coge el DNI, haz una foto al documento, haz una foto al selfie, listo. Esto es lo más rápido del mercado. Los proveedores de KYC tradicionales suelen tardar más de 90 segundos para el mismo flujo.
En el backend, Didit devuelve el resultado en menos de dos segundos en p99, medido desde el momento en que el usuario termina el selfie hasta que se activa tu webhook. La captura móvil está optimizada para teléfonos lentos y redes lentas: compresión progresiva de imágenes, carga diferida del kit de desarrollo de software y una transferencia con un solo toque de escritorio a teléfono mediante código QR si el usuario empieza en la web.
Cursor, Claude Code, Codex y OpenCode, además de cualquier cosa que siga el estándar abierto agentskills.io.
La CLI npx detecta tu agente y coloca la skill en la carpeta correcta, .claude/skills/, .cursor/skills/, etc. El mismo archivo Markdown en todas partes, sin SDK específico del host.
Por debajo, cada skill apunta a la misma API https://verification.didit.me/v3/* con la misma cabecera x-api-key y el mismo webhook firmado. La skill es simplemente cómo el agente lo lee.
Cada sesión aterriza en uno de siete estados claros, para que tu código siempre sepa qué hacer:
Approved, todas las comprobaciones superadas. Haz avanzar al usuario.Declined, una o más comprobaciones fallaron. Puedes permitir al usuario reenviar el paso específico fallido (por ejemplo, volver a hacer el selfie) sin volver a ejecutar todo el flujo.In Review, marcado para revisión de cumplimiento. Abre el caso en la consola, consulta todas las señales, decide aprobar o denegar.In Progress, el usuario está a mitad del flujo.Not Started, enlace enviado, el usuario aún no lo ha abierto. Envía un recordatorio si pasa demasiado tiempo.Abandoned, el usuario abrió el enlace pero no terminó a tiempo. Vuelve a interactuar o expira.Expired, el enlace de la sesión caducó. Crea una nueva sesión.Un webhook firmado se activa con cada cambio de estado, para que tu base de datos siempre esté sincronizada. Las sesiones abandonadas y denegadas son gratuitas.
Por defecto, los datos de producción se procesan y almacenan en la Unión Europea, en Amazon Web Services. Los contratos empresariales pueden solicitar regiones alternativas para aquellas jurisdicciones que lo requieran.
Cifrado en todas partes. AES-256 en reposo en cada base de datos, almacén de objetos y copia de seguridad. Transport Layer Security 1.3 en tránsito en cada llamada API, webhook y sesión de la Consola de Negocio. Los datos biométricos se cifran bajo una Customer Master Key independiente.
Tú controlas la retención. La retención por defecto es indefinida (ilimitada) a menos que configures un periodo más corto,entre 30 días y 10 años por aplicación, y puedes eliminar cualquier sesión individual en cualquier momento desde el panel de control o la API.
Certificaciones: SOC 2 Tipo 1 (auditoría Tipo 2 en curso), ISO/IEC 27001:2022, iBeta Nivel 1 PAD, y una certificación pública del Tesoro / SEPBLAC / CNMV de España de que la verificación remota de identidad de Didit es más segura que verificar a alguien en persona. Informe completo en /security-compliance.
Didit cumple con la normativa por defecto para los reguladores clave en infraestructura de identidad:
Memorándum detallado, cada certificado, cada carta del regulador: /security-compliance.
Tres rutas de integración, elige la que mejor se adapte a tu stack:
El mismo panel de control, la misma facturación, el mismo precio de pago por éxito para los tres. Guía paso a paso en docs.didit.me/integration/integration-prompt.
Un comando:
``bash
npx skills add didit-protocol/skills
``
La CLI detecta si estás en Cursor, Claude Code, Codex u OpenCode y coloca cada skill en la carpeta correcta. Instala solo una con --skill didit-face-match.
¿Prefieres Git? git clone https://github.com/didit-protocol/skills y copia lo que quieras. ¿Prefieres no usar herramientas? Abre el repositorio y copia un único SKILL.md en el directorio de skills de tu agente, cada skill es autocontenida.
La única variable de entorno que cada skill necesita es DIDIT_API_KEY. Consigue una en 60 segundos en business.didit.me, o deja que el agente se registre programáticamente a través de POST /programmatic/register/.
Lenguaje sencillo, sin jerga ni plantillas:
El agente lee la habilidad relevante y escribe código listo para producción en TypeScript, Python o Bash. Sin conjeturas: la habilidad proporciona el endpoint exacto, la cabecera, el cuerpo y el enumerador de estado.
La documentación está escrita para humanos. Los agentes tropiezan con las mismas cosas una y otra vez:
POST /v3/wallet-screening/ cuando la ruta real está dentro de /v3/transactions/Approved, KYB es APPROVED, los agentes los confundenLas habilidades bloquean todo eso. Se versionan junto con la API: cuando Didit lanza un nuevo endpoint, la habilidad se lanza el mismo día. 51 endpoints probados en cada lanzamiento.
Una API para KYC, KYB, Monitoreo de Transacciones y Detección de Fraude en Wallets. Intégrala en 5 minutos.