Pular para o conteúdo principal
Uma entidade de usuário representa um único indivíduo (seu cliente, usuário final ou solicitante) em todas as interações de verificação, transação e conformidade que ele tem com a sua plataforma na Didit. Quando um usuário é criado, toda a atividade vinculada ao mesmo vendor_data é reunida no mesmo perfil: você tem uma visão unificada de identidade, risco e conformidade para cada pessoa.

​
O que um usuário contém

Consulte o modelo de dados do usuário completo para ver tipos, índices e casos de borda.

​
Quando um usuário é criado

1

Automaticamente — na primeira sessão com um novo vendor_data

É o caso mais comum. Você chama POST /v3/session/ com um valor de vendor_data que a Didit nunca viu. Uma entidade de usuário é criada com status ACTIVE e vinculada a essa sessão.
2

Explicitamente — via POST /v3/users/create/

Você cria o usuário antecipadamente, antes de qualquer sessão. É útil para preencher metadados, definir o status inicial ou fazer o onboarding em massa de clientes a partir de um banco de dados existente.
3

Pelo console

Um operador de conformidade cria o usuário na página de usuários, por exemplo, ao fazer o onboarding de um cliente verificado manualmente.

​
O que você pode fazer

​
Usuários e empresas

Um único usuário pode estar vinculado a uma ou mais empresas, por exemplo, quando a mesma pessoa é diretora de uma empresa e beneficiária final de outra. A Didit preserva esses vínculos automaticamente quando o KYB identifica pessoas a partir de registros de empresas.

​
Relação usuário ↔ sessão

O usuário agrega o estado mais recente de cada recurso em todas as sessões. Uma verificação aml reprovada na sessão mais recente aparecerá no campo features.aml do usuário, mesmo que sessões anteriores tenham sido aprovadas.

​
Próximos passos

Modelo de dados

Todos os campos, tipos e índices.

Operações

Criar, atualizar, alterar status e excluir.

Rostos e biometria

Anexe um rosto para pesquisa e inclusão na lista de bloqueio.

Lista de bloqueio

Como funciona a inclusão de usuários na lista de bloqueio.

Histórico de KYC

Todas as sessões vinculadas ao usuário.

Console

Guia completo da interface de Usuários.
Última modificação em 1 de novembro de 2026