Sessões alojadas (recomendado para fluxos voltados para o utilizador)
As sessões alojadas são a abordagem recomendada para a maioria das integrações. Quando cria uma sessão, a Didit gera umverification_url que apresenta ao seu utilizador. O utilizador conclui todo o fluxo de verificação na interface otimizada da Didit, e você recebe os resultados por webhook ou através da API.
Como funciona
1
Criar sessão
O seu servidor chama
POST /v3/session/ com um ID de fluxo. A Didit devolve um verification_url e um session_token.2
Apresentar ao utilizador
Redirecione o utilizador, incorpore-o através de iframe ou inicialize um SDK nativo com o token de sessão.
3
O utilizador conclui a verificação
O utilizador segue o fluxo guiado na interface otimizada da Didit: captura do documento de identidade, prova de vida e quaisquer passos adicionais.
4
Receber resultados
A Didit envia um webhook para o seu servidor com a decisão de verificação, ou consulta periodicamente através da API de recuperação.
Porque são recomendadas as sessões
Quando usar sessões
- Onboarding de utilizadores / KYC: novos utilizadores registam-se e precisam de verificar a sua identidade
- Verificação de idade: confirme que os utilizadores cumprem os requisitos mínimos de idade
- Reverificação: reverifique periodicamente os utilizadores existentes
- Autenticação biométrica: os utilizadores autenticam-se com o rosto para ações sensíveis
- Conformidade em vários passos: fluxos que exigem documento de identidade + prova de vida + AML + telefone de uma só vez
- Qualquer cenário em que o utilizador final esteja presente e interaja diretamente
Endpoints de sessão
APIs autónomas (para processamento servidor a servidor)
As APIs autónomas permitem-lhe chamar funcionalidades de verificação individuais diretamente a partir do seu servidor, sem qualquer interface para o utilizador final. Envia os dados (imagens, documentos, nomes) e recebe resultados estruturados.Como funciona
1
Enviar dados
O seu servidor chama um endpoint autónomo (por exemplo,
POST /v3/id-verification/) com os dados necessários: imagens, documentos ou campos JSON.2
Receber resultados
A Didit processa o pedido de forma síncrona e devolve os resultados de verificação estruturados na resposta.
Quando usar APIs autónomas
APIs autónomas 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 as duas?
Sim. Muitas equipas combinam as duas abordagens:- Sessões para onboarding: os novos utilizadores passam pelo fluxo completo de verificação alojado durante o registo
- Triagem AML autónoma para monitorização contínua: uma tarefa cron faz novamente a triagem de todos os utilizadores aprovados todas as noites face às listas de vigilância atualizadas
- Pesquisa facial autónoma para deteção de duplicados: quando uma nova sessão é aprovada, o seu servidor chama a Pesquisa facial para verificar duplicados
- Verificação de identidade autónoma para operações: a sua equipa de conformidade carrega documentos manualmente para revisões de casos-limite