Instale as doze Habilidades de Agente de código aberto da Didit no Cursor, Claude Code, Codex ou OpenCode com um único comando `npx`. Pergunte ao agente em português claro. Ele escreve o código e chama a API em tempo real.
Robinhood Ventures
Confiado por mais de 2.000 organizações em todo o mundo.
Por que habilidades, não docs
Dê ao Cursor uma aba de documentação e ele inventa endpoints e coloca em minúsculas os enums de status. Dê a ele uma habilidade Didit e cada linha aponta para a API real, endpoint bloqueado, cabeçalhos bloqueados, scaffold de manipulador de webhook assinado. Um comando `npx`.
Execute `npx skills add didit-protocol/skills` no seu projeto. A CLI detecta Cursor, Claude Code, Codex ou OpenCode e coloca cada habilidade na pasta correta. Instale apenas uma com `--skill didit-face-match`.
Pegue uma em 60 segundos em [business.didit.me](https://business.didit.me) e `export DIDIT_API_KEY=…`, ou deixe o agente se registrar programaticamente, `POST /programmatic/register/` seguido por `verify-email/`, e uma chave será retornada na resposta. Não precisa de navegador.
*“Adicione Didit KYC ao meu fluxo de cadastro.”* *“Verifique este usuário contra listas AML.”* O agente lê a habilidade relevante, escreve o código e conecta o manipulador de webhook assinado. Correto na primeira tentativa, sem alternar abas de documentação.
Didit hospeda a câmera, a captura de documentos, a selfie, a transferência móvel. Menos de 30 segundos para o usuário. Veredito em menos de 2 segundos no seu webhook, assinado com `X-Signature-V2` para que você possa confiar.
Didit · Catálogo
Didit · npx install
Didit · Hosts
Didit · Quais skills bloqueiam
Didit · Configuração
Didit · github.com/didit-protocol/skills
Em cada skill
Três caminhos de instalação
$ 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 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.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 / mês. Não precisa de cartão de crédito.
Pague apenas pelo que usar. 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 regulamentados.
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 construindo produtos: aberta, flexível e amigável para desenvolvedores, para que funcione como uma parte real da sua stack, em vez de uma caixa preta que você integra por fora.
Uma API cobre a verificação de pessoas (KYC, know your customer), verificação de empresas (KYB, know your business), triagem de carteiras de cripto (KYT, know your transaction), e monitoramento de transações em tempo real, em uma stack construída para ser:
A base: 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 da Didit aprende dinamicamente de cada sessão e melhora a cada dia.
Um pequeno arquivo Markdown que ensina 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. Na próxima vez que você perguntar ao Cursor ou Claude Code “adicione KYC ao meu fluxo de cadastro”, o agente lê a skill e escreve o código certo na primeira tentativa. Sem alternar para a documentação. Sem endpoints inventados. Sem erros de maiúsculas e minúsculas no status.
É o padrão aberto Agent Skills. A Didit oferece doze delas, gratuitas e de código aberto em github.com/didit-protocol/skills.
Uma skill por capacidade da Didit, doze no total, 51 endpoints testados de ponta a ponta:
Instale tudo em um comando: npx skills add didit-protocol/skills. Instale apenas um: npx skills add didit-protocol/skills --skill didit-face-match.
O fluxo completo normalmente leva menos de 30 segundos de ponta a ponta, pegue o ID, tire a foto do documento, tire a selfie, pronto. Essa é a velocidade mais rápida do mercado. Provedores de KYC legados geralmente levam mais de 90 segundos para o mesmo fluxo.
No back-end, a Didit retorna o resultado em menos de dois segundos no p99, medido desde o momento em que o usuário termina a selfie até o momento em que seu webhook é acionado. A captura móvel é otimizada para telefones lentos 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 telefone via QR code se o usuário 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 detecta seu agente e coloca a skill no lugar certo, .claude/skills/, .cursor/skills/, e assim por diante. O mesmo arquivo Markdown em todos os lugares, sem SDK específico do host.
Por baixo dos panos, 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 como o agente a lê.
Cada sessão chega a um dos sete status claros, para que seu código sempre saiba o que fazer:
Approved, todas as verificações aprovadas. Avance o usuário.Declined, uma ou mais verificações falharam. Você pode permitir que o usuário reenvie a etapa específica que falhou (por exemplo, refazer a selfie) sem executar todo o fluxo novamente.In Review, sinalizado para revisão de conformidade. Abra o caso no console, veja todos os sinais, decida aprovar ou recusar.In Progress, o usuário está no meio do fluxo.Not Started, link enviado, o usuário ainda não o abriu. Envie um lembrete se demorar muito.Abandoned, o usuário 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 status, para que seu banco de dados esteja sempre sincronizado. Sessões abandonadas e recusadas são gratuitas.
Por padrão, os dados de produção são processados e armazenados na União Europeia, na Amazon Web Services. Contratos empresariais podem solicitar regiões alternativas para jurisdições cujos reguladores assim o exijam.
Criptografia em todos os lugares. AES-256 em repouso em todos os bancos de dados, armazenamentos de objetos e backups. Transport Layer Security 1.3 em trânsito em cada chamada de API, webhook e sessão do Business Console. Dados biométricos são criptografados sob uma Customer Master Key separada.
A retenção é sua para controlar. A retenção padrão é indefinida (ilimitada), a menos que você configure um período menor, entre 30 dias e 10 anos por aplicação, e você pode excluir qualquer sessão individual a qualquer momento do painel ou da API.
Certificações: SOC 2 Tipo 1 (auditoria Tipo 2 em andamento), ISO/IEC 27001:2022, iBeta Nível 1 PAD, e uma declaração pública do Tesoro / SEPBLAC / CNMV da Espanha de que a verificação de identidade remota da Didit é mais segura do que verificar alguém pessoalmente. Relatório completo em /security-compliance.
A Didit já vem em conformidade por padrão com os reguladores importantes 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, mesma cobrança, mesmo preço de pagamento por sucesso para todos 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 detecta se você está no Cursor, Claude Code, Codex ou OpenCode e coloca cada skill na pasta certa. 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 é autocontida.
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 se registrar programaticamente via POST /programmatic/register/.
Em português claro, sem jargões ou "blablablá":
O agente lê a skill relevante e escreve código pronto para produção em TypeScript, Python ou Bash. Sem adivinhação, a skill entrega o endpoint, cabeçalho, corpo e enum de status exatos.
A documentação é escrita para humanos. Agentes tropeçam nas mesmas coisas repetidamente:
POST /v3/wallet-screening/ quando o caminho real está dentro de /v3/transactions/Approved, KYB é APPROVED, agentes os confundemSkills resolvem tudo isso. Versionadas junto com a API: quando a Didit lança um novo endpoint, a skill é lançada no mesmo dia. 51 endpoints testados, a cada lançamento.
Uma API para KYC, KYB, Monitoramento de Transações e Análise de Carteiras. Integre em 5 minutos.