Saltar para o conteúdo principal
Cada documento que um utilizador carrega durante a verificação fica associado de forma permanente à sua entidade User. Esta página explica o que é recolhido, como obter esses documentos e como carregar documentos adicionais manualmente.

​
O que a Didit recolhe

A lista de tipos de documentos suportados abrange a matriz completa de país × documento (14,000+ documentos em 220+ países).

​
Obter documentos

Os documentos estão associados à sessão que os recolheu, e não diretamente ao utilizador. Para listar todos os documentos de um utilizador:
1

Listar as sessões do utilizador

2

Obter a decisão de cada sessão

Cada decisão de sessão inclui URLs para os documentos recolhidos.
Analise os campos id_verification.document_images, proof_of_address.document_images e liveness.images na resposta.
3

Utilizar URLs assinados

Os URLs das imagens na resposta são URLs assinados de curta duração. Guarde-os em cache no cliente enquanto forem necessários, ou volte a obter a decisão quando expirarem.

​
Gerar um relatório em PDF

Para uma exportação legível de tudo o que foi recolhido para uma sessão, incluindo todos os documentos, utilize: GET /v3/session/{session_id}/generate-pdf/ Devolve um PDF com os detalhes da sessão, os resultados das funcionalidades e as imagens dos documentos incorporadas. Útil para auditorias de conformidade, anexos de SAR e submissões regulamentares.

​
Carregar documentos a partir da consola

Os operadores de conformidade podem carregar documentos adicionais associados a um utilizador ou a uma sessão ativa:
  1. Aceda a Users → [user] → Documents → Upload document.
  2. Escolha um tipo de documento (ID, POA, personalizado).
  3. Carregue um ficheiro; o OCR é executado automaticamente para os tipos suportados.
  4. O documento fica associado à sessão mais recente (ou pode criar uma sessão de correção).
A interface de carregamento de documentos existe apenas na consola: não há nenhum endpoint de API público para associar documentos diretamente a um utilizador. Utilize as sessões como ponto de entrada para toda a recolha de documentos.

​
Validação cruzada de documentos

Quando uma sessão recolhe vários tipos de documentos, a Didit faz a validação cruzada entre eles:
  • ID ↔ Prova de vida — a face no documento de identificação corresponde à selfie de prova de vida.
  • ID ↔ POA — o nome no comprovativo de morada corresponde ao nome extraído do documento de identificação.
  • ID ↔ NFC — os dados MRZ / visuais correspondem aos dados do chip NFC.
As inconsistências são apresentadas como avisos na decisão da sessão e podem ser configuradas para acionar uma revisão manual.

​
Monitorização de documentos e reverificação

Para casos de utilização que exigem validade contínua dos documentos (por exemplo, documentos de identificação expirados):
  • A validade do documento é registada em todos os documentos de identificação verificados. Consulte a decisão da sessão para obter o campo expiration_date.
  • Monitorização de documentos — ativada por predefinição e automática: não é necessário ativar nada. Quando a data de validade do documento de identificação passa, uma sessão "Approved" passa para "Kyc Expired", o resultado da verificação de identidade recebe um aviso DOCUMENT_EXPIRED e é disparado um webhook status.updated. Não é enviado nenhum aviso antes de a data passar.
  • Desativar — defina o Expiration mode como Allow expired para esse país e tipo de documento nas definições de verificação de identidade. Reject expired, a predefinição, é o modo que monitoriza. Um documento aceite com Allow expired nunca é monitorizado.
  • Reverificação — inicie uma nova sessão com o mesmo vendor_data para atualizar os documentos.

​
Geolocalização do documento

A verificação de geolocalização do documento de identificação compara a localização IP de quem submete com o país emissor do documento de identificação. Os resultados ficam associados à decisão da sessão.

​
Privacidade e conservação

  • Todos os documentos são cifrados em repouso.
  • O acesso às imagens é feito através de URLs assinados de curta duração.
  • A conservação segue a política de conservação de dados da aplicação.
  • Os utilizadores têm o direito de pedir a eliminação; a eliminação remove as imagens, os dados extraídos por OCR e os dados NFC.

​
Próximos passos

Verificação de identidade

Como funcionam a captura do documento de identificação e o OCR.

Comprovativo de morada

Recolha de comprovativos de morada.

Decisão da sessão

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