Histórico de KYC do usuário: sessões e reverificação

Todas as sessões de Verificação de usuário (KYC) que um usuário já realizou ficam vinculadas permanentemente à sua entidade User. Você pode recuperar o histórico completo, inspecionar os resultados de cada sessão, acionar a reverificação e exportar relatórios de conformidade.

Como listar todas as sessões de um usuário

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 status: aprovadas, recusadas, em revisão, abandonadas ou expiradas.

Como entender os agregados de recursos

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

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

Use esse mapa como o caminho rápido para responder “o usuário está verificado agora?”. Para o registro histórico (todas as sessões, todos os recursos, todos os resultados), liste as sessões e inspecione cada decisão.

Como inspecionar uma única sessão

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

A decisão inclui:

Resultados por recurso (documento de identidade, prova de vida, correspondência facial, AML, comprovante de endereço, NFC etc.)
Dados e imagens extraídos do documento (URLs assinadas)
Ocorrências de 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 recuperar sessão para ver o esquema completo.

Como acionar a reverificação

Quando você precisar que um usuário faça a verificação novamente (por exemplo, re-KYC anual, vencimento do documento, nova checagem baseada em gatilho):

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 é vinculada à mesma entidade User. Quando a sessão for concluída, o mapa features da entidade será atualizado para refletir os novos resultados.

Reenvio ou nova sessão

Cenário	O que usar
A sessão do usuário foi recusada por um problema corrigível (documento desfocado, iluminação ruim)	Reenviar: mesma sessão, novo upload
Reverificação completa ou re-KYC periódico	Criar uma sessão totalmente nova
Correção acionada por uma regra de transação	A transação cria automaticamente uma sessão de correção (status `AWAITING_USER`)

Como exportar um relatório de conformidade

Para auditorias, SARs ou solicitações de órgãos 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 cobrir todo o histórico de um usuário em um único arquivo, baixe o PDF do histórico do usuário: uma página de capa (resumo do perfil, status dos recursos, índice de sessões) seguida do relatório completo de cada sessão que deve ser incluída no relatório, da mais antiga para a mais recente, limitado às 20 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 o console gera em Users → [user] → Actions → Download PDF. Para exportações em massa em CSV de muitos usuários, use a exportação geral da aplicação em Review & Operations → Export PDF/CSV.

Como compartilhar uma sessão com terceiros

Quando você precisar compartilhar a verificação de um usuário com uma aplicação parceira (por exemplo, em um cenário de KYC reutilizável), use:

POST /v3/session/{session_id}/share/: gera um token compartilhável.
POST /v3/session/import-shared/: importa uma sessão compartilhada na aplicação receptora.

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

Fluxos baseados no histórico

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

Pule etapas se o usuário já tiver uma prova de vida aprovada nos últimos N dias.
Exija verificações adicionais se a sessão mais recente do usuário tiver sido recusada.
Sinalize quando o número de sessões de um usuário tiver um pico inesperado.
Monitore as reanálises contínuas de AML com o recurso de monitoramento contínuo.

Próximos passos

Modelo de dados

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

Recuperar sessão

Esquema completo da decisão da sessão.

KYC reutilizável

Reutilize dados verificados entre aplicações.

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

Visão geral

Preços

Fluxos e verificação

Revisão e operações

Entidades (usuários e empresas)

Configurações e personalização

Segurança e conformidade

Didit Academy

Recursos

Histórico de KYC do usuário: sessões e reverificação

Como listar todas as sessões de um usuário

Como entender os agregados de recursos

Como inspecionar uma única sessão

Como acionar a reverificação

Reenvio ou nova sessão

Como exportar um relatório de conformidade

Como compartilhar uma sessão com terceiros

Fluxos baseados no histórico

Próximos passos

Modelo de dados

Recuperar sessão

KYC reutilizável

​Como listar todas as sessões de um usuário

​Como entender os agregados de recursos

​Como inspecionar uma única sessão

​Como acionar a reverificação

​Reenvio ou nova sessão

​Como exportar um relatório de conformidade

​Como compartilhar uma sessão com terceiros

​Fluxos baseados no histórico

​Próximos passos

Modelo de dados

Recuperar sessão

KYC reutilizável

Como listar todas as sessões de um usuário

Como entender os agregados de recursos

Como inspecionar uma única sessão

Como acionar a reverificação

Reenvio ou nova sessão

Como exportar um relatório de conformidade

Como compartilhar uma sessão com terceiros

Fluxos baseados no histórico

Próximos passos