Pular para o conteúdo principal
Todo documento que um usuário envia durante a verificação fica vinculado permanentemente à sua entidade User. Esta página explica o que é coletado, como recuperar esses dados e como enviar documentos adicionais manualmente.

​
O que a Didit coleta

Tipos de documento compatíveis traz a matriz completa de país × documento (14,000+ documentos em 220+ países).

​
Como recuperar documentos

Os documentos ficam associados à sessão que os coletou, e não diretamente ao usuário. Para listar todos os documentos de um usuário:
1

Liste as sessões do usuário

2

Busque a decisão de cada sessão

A decisão de cada sessão inclui as URLs dos documentos coletados.
Verifique os campos id_verification.document_images, proof_of_address.document_images e liveness.images na resposta.
3

Use URLs assinadas

As URLs das imagens na resposta são URLs assinadas de curta duração. Armazene-as em cache no cliente enquanto estiverem em uso ou busque a decisão novamente quando expirarem.

​
Como gerar um relatório em PDF

Para exportar, em formato legível, tudo o que foi coletado em uma sessão, incluindo todos os documentos, use: GET /v3/session/{session_id}/generate-pdf/ Retorna um PDF com os detalhes da sessão, os resultados dos recursos e as imagens dos documentos incorporadas. É útil para auditorias de conformidade, anexos de SAR e protocolizações regulatórias.

​
Como enviar documentos pelo console

Operadores de conformidade podem enviar documentos adicionais vinculados a um usuário ou a uma sessão ativa:
  1. Acesse Users → [usuário] → Documents → Upload document.
  2. Escolha um tipo de documento (identidade, comprovante de endereço, personalizado).
  3. Envie um arquivo; o OCR é executado automaticamente para os tipos compatíveis.
  4. O documento é anexado à sessão mais recente (ou você pode criar uma sessão de correção).
A interface de envio de documentos existe apenas no console: não há endpoint público de API para anexar documentos diretamente a um usuário. Use as sessões como ponto de entrada para toda a captura de documentos.

​
Cruzamento de documentos

Quando uma sessão coleta vários tipos de documento, a Didit faz o cruzamento entre eles:
  • Identidade ↔ Prova de vida: o rosto no documento de identidade corresponde à selfie da prova de vida.
  • Identidade ↔ Comprovante de endereço: o nome no comprovante de endereço corresponde ao nome extraído do documento de identidade.
  • Identidade ↔ NFC: os dados da MRZ e os dados visuais correspondem aos dados do chip NFC.
As inconsistências aparecem como avisos na decisão da sessão e podem ser configuradas para acionar uma revisão manual.

​
Monitoramento de documentos e reverificação

Para casos de uso que exigem validade contínua dos documentos (por exemplo, documentos de identidade expirados):
  • A validade do documento é acompanhada em todo documento de identidade verificado. Consulte o campo expiration_date na decisão da sessão.
  • Monitoramento de documentos: ativado por padrão e automático, sem nada para habilitar. Quando a data de validade do documento expira, uma sessão "Approved" muda para "Kyc Expired", o resultado da verificação de identidade recebe um aviso DOCUMENT_EXPIRED e um webhook status.updated é disparado. Nenhum aviso é enviado antes de a data expirar.
  • Como desativar: defina Expiration mode como Allow expired para aquele país e tipo de documento nas configurações de verificação de identidade. Reject expired, o padrão, é o modo que faz o monitoramento. Um documento aceito como Allow expired nunca é monitorado.
  • Reverificação: acione uma nova sessão com o mesmo vendor_data para atualizar os documentos.

​
Geolocalização de documentos

A verificação de geolocalização do documento de identidade compara a localização do endereço IP do remetente com o país emissor do documento. Os resultados são anexados à decisão da sessão.

​
Privacidade e retenção

  • Todos os documentos são criptografados em repouso.
  • O acesso às imagens é feito por URLs assinadas de curta duração.
  • A retenção segue a política de retenção de dados da aplicação.
  • Os usuários têm o direito de solicitar a exclusão; a exclusão remove as imagens, os dados extraídos por OCR e os dados de NFC.

​
Próximos passos

Verificação de identidade

Como funcionam a captura do documento de identidade e o OCR.

Comprovante de endereço

Coleta de comprovantes de endereço.

Decisão da sessão

Referência de GET /v3/session//decision/.
Última modificação em 1 de novembro de 2026