Histórico KYC do utilizador: sessões e reverificação

Cada sessão de Verificação de utilizadores (KYC) que um utilizador tenha realizado fica ligada permanentemente à respetiva entidade User. Pode obter o histórico completo, inspecionar os resultados de cada sessão, acionar uma reverificação e exportar relatórios de conformidade.

Listar todas as sessões de um utilizador

Filtre a lista de Sessões por vendor_data:

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"

A resposta inclui todas as sessões, independentemente do estado: aprovada, recusada, em análise, abandonada ou expirada.

Compreender os agregados de funcionalidades

O mapa features da entidade User reflete o estado mais recente de cada funcionalidade em todas as sessões:

"features": {
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW"
}

Use-o como caminho rápido para responder à pergunta “o utilizador está verificado neste momento?”. Para o registo histórico, ou seja, todas as sessões, todas as funcionalidades e todos os resultados, liste as sessões e analise cada decisão.

Inspecionar uma sessão individual

curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"

A decisão inclui:

Resultados por funcionalidade (documento de identidade, prova de vida, correspondência facial, AML, POA, NFC, entre outros)
Dados extraídos do documento e imagens (URLs assinados)
Correspondências AML com pontuações de correspondência e de risco
Análise de dispositivo e IP e contexto do dispositivo
Notas do revisor e ações manuais

Consulte obter sessão para o esquema completo.

Acionar uma reverificação

Quando precisar que um utilizador volte a verificar a identidade (por exemplo, re-KYC anual, validade do documento ou reverificação baseada em acionadores):

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_reverification",
    "vendor_data": "user-42"
  }'

A nova sessão fica associada à mesma entidade User. Quando for concluída, o mapa features da entidade é atualizado com os novos resultados.

Reenvio ou nova sessão

Cenário	Utilizar
A sessão do utilizador foi recusada por um problema corrigível (documento de identidade desfocado, iluminação deficiente)	Reenviar: mesma sessão, novo carregamento
Reverificação completa ou re-KYC periódico	Criar uma sessão totalmente nova
Remediação acionada por uma regra de transação	A transação cria automaticamente uma sessão de remediação (estado `AWAITING_USER`)

Exportar um relatório de conformidade

Para auditorias, SARs ou pedidos de reguladores, gere um PDF de qualquer sessão:

curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o session-report.pdf

Para abranger todo o histórico de um utilizador num único ficheiro, transfira o PDF do histórico do utilizador: uma capa (resumo do perfil, estado das funcionalidades, índice de sessões) seguida do relatório completo de cada sessão passível de relatório, da mais antiga para a mais recente, limitado às 20 sessões mais recentes.

curl --fail https://verification.didit.me/v3/users/user-42/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o user-history.pdf

É o mesmo documento que a consola gera em Utilizadores → [utilizador] → Ações → Transferir PDF. Para exportações CSV em massa de vários utilizadores, use a exportação global em Revisão e operações → Exportar PDF/CSV.

Partilhar uma sessão com terceiros

Quando precisar de partilhar a verificação de um utilizador com uma aplicação parceira (por exemplo, um cenário de KYC reutilizável), use:

POST /v3/session/{session_id}/share/: gera um token partilhável.
POST /v3/session/import-shared/: importa uma sessão partilhada no lado recetor.

Consulte KYC reutilizável para o padrão completo.

Fluxos de trabalho baseados no histórico

Use o histórico de sessões para tomar decisões de conformidade mais inteligentes:

Ignorar passos se o utilizador já tiver uma prova de vida aprovada nos últimos N dias.
Exigir verificações adicionais se a sessão mais recente do utilizador tiver sido recusada.
Sinalizar quando o número de sessões de um utilizador aumentar de forma inesperada.
Monitorizar as reanálises AML contínuas através da funcionalidade de monitorização contínua.

Próximos passos

Modelo de dados

Como o mapa de funcionalidades e os contadores são calculados.

Obter sessão

Esquema completo da decisão da sessão.

KYC reutilizável

Reutilize dados verificados em várias aplicações.

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

Visão geral

Preços

Fluxos e verificação

Revisão e operações

Entidades (utilizadores e empresas)

Definições e personalização

Segurança e conformidade

Didit Academy

Recursos

Histórico KYC do utilizador: sessões e reverificação

Listar todas as sessões de um utilizador

Compreender os agregados de funcionalidades

Inspecionar uma sessão individual

Acionar uma reverificação

Reenvio ou nova sessão

Exportar um relatório de conformidade

Partilhar uma sessão com terceiros

Fluxos de trabalho baseados no histórico

Próximos passos

Modelo de dados

Obter sessão

KYC reutilizável

​Listar todas as sessões de um utilizador

​Compreender os agregados de funcionalidades

​Inspecionar uma sessão individual

​Acionar uma reverificação

​Reenvio ou nova sessão

​Exportar um relatório de conformidade

​Partilhar uma sessão com terceiros

​Fluxos de trabalho baseados no histórico

​Próximos passos

Modelo de dados

Obter sessão

KYC reutilizável

Listar todas as sessões de um utilizador

Compreender os agregados de funcionalidades

Inspecionar uma sessão individual

Acionar uma reverificação

Reenvio ou nova sessão

Exportar um relatório de conformidade

Partilhar uma sessão com terceiros

Fluxos de trabalho baseados no histórico

Próximos passos