Pular para o conteúdo principal
Cada entidade de usuário e de empresa no Didit passa por um ciclo de vida previsível. Entender esse ciclo de vida é essencial para projetar seus fluxos de onboarding, monitoramento contínuo e remediação.

​
Diagrama do ciclo de vida

​
Status em detalhes

Alterar o status via PATCH /v3/users/{vendor_data}/update-status/ ou PATCH /v3/businesses/{vendor_data}/update-status/ emite um webhook (user.status.updated / business.status.updated) para que os sistemas downstream possam reagir em tempo real.

​
Fases do ciclo de vida

Criação

Uma entidade é criada de uma destas três formas:
  • Criada automaticamente quando você inicia uma sessão com um novo vendor_data. A entidade é criada com o status ACTIVE.
  • Pré-criada via API usando POST /v3/users/create/ ou POST /v3/businesses/create/. O status padrão é ACTIVE.
  • Criada no console por um operador de conformidade: o status começa como ACTIVE, a menos que o operador especifique outro.
Toda entidade recebe um uuid gerado pelo Didit e um identificador vendor_data de propriedade do cliente.

Verificação

As sessões são vinculadas à entidade via vendor_data. Cada sessão passa pelo fluxo de verificação (workflow) que você configurou: verificação de identidade, prova de vida, correspondência facial, AML, documentos, consulta ao registro de empresas para KYB e assim por diante.As sessões concluídas atualizam os contadores agregados da entidade:
  • session_count, approved_count, declined_count, in_review_count
  • Mapa features: o status mais recente de cada recurso em todas as sessões (por exemplo, { "id_verification": "APPROVED", "aml": "IN_REVIEW" })
  • Os campos de perfil são propagados a partir da sessão aprovada mais recente (por exemplo, full_name, date_of_birth, portrait_image).

Uso ativo

Quando uma entidade tem uma ou mais sessões aprovadas, você pode:
  • Enviar transações que fazem referência à entidade via vendor_data no payload da transação
  • Executar o monitoramento AML contínuo: novas varreduras periódicas das listas de sanções, PEP e mídia adversa
  • Reverificar periodicamente: criar novas sessões para o mesmo vendor_data em intervalos regulares
  • Agregar sinais de risco de sessões e transações

Transições de status

As mudanças de status da entidade acontecem de forma automática ou manual.Transições automáticas
  • ACTIVE → BLOCKED quando uma sessão é DECLINED e seu fluxo está configurado para bloquear automaticamente.
  • ACTIVE → FLAGGED quando uma transação ultrapassa o limiar de revisão ou uma regra adiciona a entidade a uma lista de monitoramento.
  • ACTIVE → BLOCKED quando uma biometria facial corresponde a uma entrada da lista de bloqueio.
Transições manuais acontecem quando um analista altera o status pelo console ou quando você chama o endpoint update-status.Toda transição emite um webhook user.status.updated ou business.status.updated.

Exclusão

As entidades são excluídas via POST /v3/users/delete/ ou POST /v3/businesses/delete/ (em lote). O registro da entidade é removido permanentemente. Excluir um usuário também elimina todos os templates biométricos retidos para ele após a exclusão da sessão, de modo que a pessoa deixa de gerar correspondências na detecção de duplicatas e na Busca facial.As sessões de verificação não são abrangidas por esses endpoints, nem as transações. Exclua sessões com Excluir sessão ou Excluir sessões em lote; as transações são excluídas pelo Console.

​
Registros de data e hora de atividade

As entidades registram atividade para ajudar você a identificar perfis inativos ou ativos: Use esses registros de data e hora para filtrar entidades inativas, agendar reverificações ou acionar o monitoramento contínuo.

​
Eventos emitidos durante o ciclo de vida

Consulte webhooks de entidades para ver os formatos de payload e a semântica de entrega.

​
Próximos passos

Vinculação com vendor_data

Como o vendor_data conecta sessões, transações e entidades.

Operações de usuários

Crie, atualize, altere o status e exclua entidades de usuário.

Operações de empresas

Crie, atualize, altere o status e exclua entidades de empresa.
Última modificação em 1 de novembro de 2026