Pular para o conteúdo principal
A Didit oferece duas abordagens complementares para a verificação de identidade. Entender a diferença entre elas é essencial para escolher a integração certa para o seu caso de uso.

​
Sessões hospedadas (recomendadas para fluxos com o usuário)

As sessões hospedadas são a abordagem recomendada para a maioria das integrações. Quando você cria uma sessão, a Didit gera uma verification_url que você apresenta ao seu usuário. O usuário conclui todo o fluxo de verificação na interface otimizada da Didit, e você recebe os resultados por webhook ou pela API.

​
Como funciona

1

Criar a sessão

Seu servidor chama POST /v3/session/ com o ID de um fluxo de verificação (workflow). A Didit retorna uma verification_url e um session_token.
2

Apresentar ao usuário

Redirecione o usuário, incorpore via iframe ou inicialize um SDK nativo usando o token da sessão.
3

O usuário conclui a verificação

O usuário segue o fluxo guiado na interface otimizada da Didit: captura do documento, prova de vida e quaisquer etapas adicionais.
4

Receber os resultados

A Didit envia um webhook ao seu servidor com a decisão da verificação, ou você consulta periodicamente pela API de recuperação.

​
Por que as sessões são recomendadas

​
Quando usar sessões

  • Onboarding de usuários / KYC: novos usuários se cadastram e precisam verificar a identidade
  • Verificação de idade: confirme que os usuários atendem aos requisitos de idade mínima
  • Reverificação: reverifique periodicamente os usuários existentes
  • Autenticação biométrica: os usuários se autenticam com o rosto para ações sensíveis
  • Conformidade em várias etapas: fluxos que exigem documento + prova de vida + AML + telefone de uma só vez
  • Qualquer cenário em que o usuário final esteja presente e interaja diretamente

​
Endpoints de sessão

​
APIs independentes (para processamento servidor a servidor)

As APIs independentes permitem chamar recursos de verificação individuais diretamente do seu servidor, sem nenhuma interface para o usuário final. Você envia os dados (imagens, documentos, nomes) e recebe resultados estruturados.

​
Como funciona

1

Enviar dados

Seu servidor chama um endpoint independente (por exemplo, POST /v3/id-verification/) com os dados necessários: imagens, documentos ou campos JSON.
2

Receber resultados

A Didit processa a requisição de forma síncrona e retorna os resultados estruturados da verificação na resposta.

​
Quando usar as APIs independentes

​
APIs independentes disponíveis

Identidade e documentos Document AI Biometria e rosto Conformidade e risco Verificação bancária Verificação de Empresas (KYB)

​
Comparação lado a lado

​
Posso usar os dois?

Sim. Muitas equipes combinam as duas abordagens:
  1. Sessões para onboarding: novos usuários passam pelo fluxo de verificação hospedado completo durante o cadastro
  2. AML independente para monitoramento contínuo: um cron job reanalisa todas as noites todos os usuários aprovados em relação às listas de monitoramento atualizadas
  3. Busca facial independente para detecção de duplicatas: quando uma nova sessão é aprovada, seu servidor chama a API de busca facial para verificar se há duplicatas
  4. Verificação de identidade independente para operações: sua equipe de conformidade envia documentos manualmente para revisões de casos atípicos

​
Exemplo: arquitetura combinada

​
Primeiros passos

Última modificação em 1 de novembro de 2026