Instale as doze Agent Skills de código aberto da Didit no Cursor, Claude Code, Codex ou OpenCode com um único comando `npx`. Pergunte ao agente em português simples. Ele escreve o código e chama a API em tempo real.
Confiado por mais de 2.000 organizações em todo o mundo.
Porquê skills, e não docs
Dê ao Cursor um separador de documentação e ele inventa endpoints e coloca em minúsculas os enums de estado. Dê-lhe uma skill Didit e cada linha aponta para a API real, endpoint bloqueado, cabeçalhos bloqueados, scaffold do handler de webhook assinado. Um comando `npx`.
Execute `npx skills add didit-protocol/skills` no seu projeto. A CLI deteta Cursor, Claude Code, Codex ou OpenCode e coloca cada skill na pasta correta. Instale apenas uma com `--skill didit-face-match`.
Ou obtenha uma em 60 segundos em [business.didit.me](https://business.didit.me) e `export DIDIT_API_KEY=…`, ou deixe o agente registar-se programaticamente, `POST /programmatic/register/` seguido de `verify-email/`, e uma chave é devolvida na resposta. Não é necessário browser.
*“Adicione o KYC da Didit ao meu fluxo de registo.”* *“Verifique este utilizador contra as listas AML.”* O agente lê a skill relevante, escreve o código e configura o handler de webhook assinado. Correto à primeira, sem alternar entre separadores de documentação.
A Didit aloja a câmara, a captura de documentos, a selfie, a transferência móvel. Menos de 30 segundos para o utilizador. Veredito em menos de 2 segundos no seu webhook, assinado com `X-Signature-V2` para que possa confiar.
$ npx skills add didit-protocol/skills
✓ 12 competências 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 detetados automaticamente.$ 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.33 (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 / mês. Não é necessário cartão de crédito.
Pague apenas pelo que usa. Mais de 25 módulos. Preços públicos por módulo, sem taxa mínima mensal.
MSA e SLA personalizados. Para grandes volumes e programas regulados.
Comece grátis → pague apenas quando uma verificação for executada → desbloqueie o Enterprise para um contrato personalizado, SLA ou residência de dados.
A Didit é uma infraestrutura para identidade e fraude, a plataforma que gostaríamos que existisse quando estávamos a desenvolver os nossos próprios produtos: aberta, flexível e pensada para programadores, para que funcione como uma parte real da sua stack, em vez de uma caixa preta à qual se integra.
Uma única API abrange a verificação de pessoas (KYC, know your customer), a verificação de empresas (KYB, know your business), a análise de carteiras de criptomoedas (KYT, know your transaction) e a monitorização de transações em tempo real, numa stack construída para ser:
A base subjacente: mais de 14.000 tipos de documentos em mais de 48 idiomas, mais de 1.000 fontes de dados e mais de 200 sinais de fraude em cada sessão. A infraestrutura Didit aprende dinamicamente com cada sessão e melhora a cada dia.
Um pequeno ficheiro Markdown que ensina o seu agente de IA a chamar uma das APIs da Didit, endpoint, cabeçalhos, formato do corpo, casos de erro, com código funcional em TypeScript, Python e cURL.
Instale uma vez. Da próxima vez que perguntar ao Cursor ou Claude Code “adicionar KYC ao meu fluxo de registo”, o agente lê a skill e escreve o código certo à primeira tentativa. Sem alternar entre separadores para a documentação. Sem endpoints inventados. Sem erros na capitalização do status.
É o padrão aberto Agent Skills. A Didit disponibiliza doze, gratuitas e de código aberto em github.com/didit-protocol/skills.
Uma skill por capacidade Didit, doze no total, 51 endpoints testados de ponta a ponta:
Instale tudo com um comando: npx skills add didit-protocol/skills. Instale apenas uma: npx skills add didit-protocol/skills --skill didit-face-match.
O fluxo completo normalmente leva menos de 30 segundos de ponta a ponta, pegar no ID, tirar foto do documento, tirar selfie, pronto. É o mais rápido do mercado. Os fornecedores de KYC legados geralmente levam mais de 90 segundos para o mesmo fluxo.
No back-end, a Didit devolve o resultado em menos de dois segundos no p99, medido desde o momento em que o utilizador termina a selfie até ao momento em que o seu webhook é acionado. A captura móvel é otimizada para telemóveis e redes lentas: compressão progressiva de imagem, carregamento preguiçoso do kit de desenvolvimento de software e uma transferência com um toque do desktop para o telemóvel via código QR se o utilizador começar na web.
Cursor, Claude Code, Codex e OpenCode, além de qualquer coisa que siga o padrão aberto agentskills.io.
O CLI npx deteta o seu agente e coloca a skill na pasta certa, .claude/skills/, .cursor/skills/, e assim por diante. O mesmo ficheiro Markdown em todo o lado, sem SDK específico do host.
Por baixo, cada skill aponta para a mesma API https://verification.didit.me/v3/* com o mesmo cabeçalho x-api-key e o mesmo webhook assinado. A skill é apenas a forma como o agente a lê.
Cada sessão atinge um dos sete estados claros, para que o seu código saiba sempre o que fazer:
Approved, todas as verificações passaram. Avance com o utilizador.Declined, uma ou mais verificações falharam. Pode permitir que o utilizador reenvie o passo específico que falhou (por exemplo, tirar novamente a selfie) sem ter de executar todo o fluxo novamente.In Review, sinalizado para revisão de conformidade. Abra o caso na consola, veja todos os sinais, decida aprovar ou recusar.In Progress, o utilizador está a meio do fluxo.Not Started, link enviado, o utilizador ainda não o abriu. Envie um lembrete se demorar muito.Abandoned, o utilizador abriu o link mas não terminou a tempo. Reengaje ou expire.Expired, o link da sessão expirou. Crie uma nova sessão.Um webhook assinado é acionado em cada mudança de estado, para que a sua base de dados esteja sempre sincronizada. As sessões abandonadas e recusadas são gratuitas.
Os dados de produção são processados e armazenados na União Europeia por predefinição, nos Amazon Web Services. Contratos empresariais podem solicitar regiões alternativas para jurisdições cujos reguladores o exijam.
Criptografia em todo o lado. AES-256 em repouso em todas as bases de dados, armazenamento de objetos e backups. Transport Layer Security 1.3 em trânsito em cada chamada de API, webhook e sessão da Business Console. Os dados biométricos são criptografados sob uma Customer Master Key separada.
A retenção é sua para controlar. A retenção predefinida é indefinida (ilimitada), a menos que configure um período mais curto, entre 30 dias e 10 anos por aplicação, e pode eliminar qualquer sessão individual a qualquer momento a partir do dashboard ou da API.
Certificações: SOC 2 Tipo 1 e Tipo 2, ISO/IEC 27001:2022, iBeta Nível 1 PAD, e uma atestação pública do Tesoro / SEPBLAC / CNMV de Espanha de que a verificação remota de identidade da Didit é mais segura do que verificar alguém presencialmente. Relatório completo em /security-compliance.
A Didit está em conformidade por predefinição com os reguladores relevantes para a infraestrutura de identidade:
Memorando detalhado, todos os certificados, todas as cartas regulatórias: /security-compliance.
Três caminhos de integração, escolha o que melhor se adapta à sua stack:
Mesmo painel de controlo, mesma faturação, mesmo preço de pagamento por sucesso para os três. Guia passo a passo em docs.didit.me/integration/integration-prompt.
Um comando:
``bash
npx skills add didit-protocol/skills
``
O CLI deteta se está no Cursor, Claude Code, Codex ou OpenCode e coloca cada skill na pasta correta. Instale apenas uma com --skill didit-face-match.
Prefere Git? git clone https://github.com/didit-protocol/skills e copie o que quiser. Prefere sem ferramentas? Abra o repositório e copie um único SKILL.md para o diretório de skills do seu agente, cada skill é autónoma.
A única variável de ambiente que cada skill precisa é DIDIT_API_KEY. Obtenha uma em 60 segundos em business.didit.me, ou deixe o agente registar-se programaticamente via POST /programmatic/register/.
Em português simples, sem jargão nem "chavões":
O agente lê a "skill" relevante e escreve código pronto para produção em TypeScript, Python ou Bash. Sem "adivinhas", a "skill" fornece o endpoint exato, o cabeçalho, o corpo e o enum de estado.
A documentação é escrita para humanos. Os agentes tropeçam nas mesmas coisas repetidamente:
POST /v3/wallet-screening/ quando o caminho real está dentro de /v3/transactions/Approved, KYB é APPROVED, os agentes confundem-nosAs "skills" resolvem tudo isso. Versionadas juntamente com a API: quando a Didit lança um novo endpoint, a "skill" é lançada no mesmo dia. 51 endpoints testados, em cada lançamento.
Uma API para KYC, KYB, Monitorização de Transações e Rastreio de Carteiras. Integre em 5 minutos.