API de verificação de empresas (KYB): registro e UBO

A Verificação de empresas (KYB) da Didit permite verificar empresas e pessoas jurídicas antes de integrá-las à sua plataforma. O sistema automatiza consultas a registros de empresas, identifica beneficiários finais e diretores, faz a triagem de todas as partes contra listas de vigilância AML e coleta documentos de apoio, tudo em um único fluxo de verificação (workflow). Cada empresa verificada é acompanhada como um perfil de empresa, que agrega os resultados de várias sessões. Esta aula da Didit Academy acompanha uma verificação de empresa do início ao fim: o painel de KYB, a consulta ao registro, acionistas e UBOs, a triagem AML e o que o representante da empresa vê do lado dele. Novo no KYB da Didit? Comece pelo início rápido para um passo a passo completo de 10 minutos e depois leia o guia de integração para padrões de produção. Para o modelo de entidade Empresa em si (vínculo com Usuários, listas de bloqueio, importação/exportação), veja Empresas.

Como funciona

Crie uma sessão de empresa

Inicie uma verificação de empresa criando uma sessão com um fluxo de KYB. Quando o tipo do fluxo é KYB, a Didit cria automaticamente uma sessão de empresa:

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your-kyb-workflow-id",
    "vendor_data": "company-123"
  }'

O tipo da sessão é determinado pelo fluxo, sem necessidade de campos extras. Os fluxos de KYB criam automaticamente sessões de empresa com os recursos específicos de empresas ativados.

Consulta ao registro da empresa

A Didit consulta os registros oficiais de empresas no nível Lite, Shareholders ou UBOs, cada um com preço por país; veja preços de registros. O nível Lite obtém:

Dado	Descrição
Nome da empresa	Razão social como registrada
Número de registro	Número oficial de registro da empresa
País	País de constituição
Situação	Ativa, dissolvida, baixada etc.
Tipo de empresa	Ltd, LLC, PLC, SA, GmbH etc.
Data de constituição	Data em que a empresa foi registrada
Endereço registrado	Endereço oficial da sede registrada
Número fiscal	Número de identificação fiscal (quando disponível)

Os dados do registro são cruzados com as informações fornecidas para detectar inconsistências.

Pessoas-chave - UBOs, acionistas, diretores e representantes

O sistema identifica toda pessoa e toda entidade corporativa vinculada à empresa dentro do modelo unificado de Pessoas-chave:

UBOs - pessoas físicas que, em última instância, possuem ou controlam a empresa, com percentuais de participação e de voto
Acionistas (pessoas físicas e jurídicas) - cada um com o seu percentual de participação
Diretores, representantes, secretários, signatários autorizados e outras funções de administração - com a etiqueta da função específica
Camadas de propriedade corporativa - empresas controladoras na cadeia de propriedade, com KYB aninhado opcional

Uma mesma pessoa pode ter várias etiquetas de função (por exemplo, diretor e acionista). Cada função é configurada individualmente no fluxo: quais funções exigem KYC, qual fluxo de KYC usar e se o usuário final pode pular a verificação. Saiba mais em Pessoas-chave e Propriedade.

Triagem AML

Todas as partes identificadas passam automaticamente pela triagem contra listas de vigilância AML globais:

AML da empresa - faz a triagem da entidade empresarial contra sanções, mídia negativa e listas de ações regulatórias
AML de pessoas - faz a triagem individual de cada pessoa-chave (UBO, acionista, diretor, representante etc.)
Usa o mesmo sistema de duas pontuações de risco (pontuação de correspondência + pontuação de risco) da verificação de usuários

Coleta de documentos

Colete e verifique documentos de apoio:

Tipo de documento	Exemplos
Certificado de constituição	Certificado de formação da empresa
Contrato social	Estatuto, memorando de associação
Comprovante de endereço	Contas de serviços, extratos bancários do endereço registrado
Registro de acionistas	Registro oficial de acionistas
Demonstrações financeiras	Contas anuais, relatórios de auditoria
Certidões fiscais	Certificados de registro ou de regularidade fiscal
Documentos personalizados	Quaisquer documentos adicionais exigidos pelo seu processo de conformidade

Os analistas podem solicitar documentos adicionais à empresa durante o processo de revisão.

Revise e decida

A sessão da empresa recebe um status geral baseado em todas as verificações:

Status	Significado
Aprovada	Todas as verificações passaram - a empresa está verificada
Em revisão	Uma ou mais verificações exigem revisão manual
Recusada	Uma verificação crítica falhou (por exemplo, empresa dissolvida, entidade sancionada)

Os analistas podem revisar todos os dados coletados no Business Console, adicionar comentários, solicitar documentos adicionais e tomar a decisão final.

Ciclo de vida da sessão de empresa

Cada verificação de empresa roda dentro de uma sessão de empresa que acompanha o progresso pelos seguintes status:

Status	Descrição
`NOT_STARTED`	Sessão criada, mas a verificação ainda não começou
`IN_PROGRESS`	A verificação está em andamento - consultas a registros, triagem AML ou coleta de documentos em curso
`APPROVED`	Todas as verificações passaram - a empresa está verificada
`DECLINED`	Uma verificação crítica falhou (por exemplo, empresa dissolvida, entidade sancionada)
`IN_REVIEW`	Uma ou mais verificações exigem revisão manual de um analista
`RESUBMITTED`	Sessão anteriormente recusada, reenviada com dados atualizados

Cada sessão tem um session_id único, um session_number sequencial e um session_token para o link de verificação hospedado. Quando uma sessão é criada com um identificador vendor_data, a Didit a vincula automaticamente ao perfil de empresa correspondente.

Status por recurso

A verificação de empresas acompanha o status de cada componente de forma independente:

Recurso	Descrição
Verificação de registro	Consulta ao registro da empresa e extração de dados
AML da empresa	Triagem AML no nível da empresa contra sanções e listas de vigilância
Documentos	Coleta de documentos, OCR e verificação cruzada
Pessoas-chave	Identificação de beneficiários finais e diretores, AML e KYC

Cada recurso pode estar em: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW ou RESUB_REQUESTED. O status geral da sessão agrega os status individuais dos recursos - a sessão só fica APPROVED quando todos os recursos obrigatórios passam.

Eventos de webhook

As sessões de empresa geram os seguintes eventos de webhook:

Evento	Gatilho
`status.updated`	O status da sessão mudou. O payload traz `session_kind: "business"` para sessões de KYB.
`data.updated`	Os dados da sessão mudaram (registro, pessoas-chave, documentos, AML). O payload traz `session_kind: "business"`.
`business.status.updated`	O status da entidade Empresa vinculada mudou (`ACTIVE` / `FLAGGED` / `BLOCKED`).
`business.data.updated`	Os campos de perfil ou os contadores agregados da entidade Empresa vinculada mudaram.

Os payloads de webhook incluem session_kind: "business" e o business_session_id para distingui-los dos eventos de verificação de usuários. Veja Webhooks para a verificação de assinatura e detalhes de entrega.

Principais capacidades

Capacidade	Descrição
Consultas automáticas a registros	Consulte registros oficiais de empresas nos países compatíveis no nível Lite, Shareholders ou UBOs, com preço por país
Identificação de UBO	Extraia automaticamente estruturas de beneficiários finais com percentuais
Triagem de diretores	Identifique e verifique diretores, secretários e outros administradores
AML da empresa	Faça a triagem da entidade empresarial contra sanções e listas de vigilância
AML de pessoas	Faça a triagem individual de todos os UBOs e diretores identificados
Vínculo com KYC	Vincule cada pessoa identificada a uma sessão de Verificação de usuários (KYC) para a verificação de identidade
Coleta de documentos	Solicitações estruturadas de documentos com acompanhamento de uploads
Verificação cruzada por OCR	Extraia dados de documentos enviados e cruze-os com os dados do registro
Perfis de empresa	Criação automática de perfis e agregação de sessões para cada empresa verificada
Status por recurso	Acompanhamento independente de status para registro, AML, documentos e pessoas-chave
Avaliação de risco	Nível de risco geral baseado na situação da empresa, nos resultados de AML e na complexidade da estrutura societária
Webhooks	Receba eventos do ciclo de vida da sessão e de atualização de dados em tempo real por webhooks

Sessões de empresa vs. sessões de usuário

Recurso	Sessão de usuário	Sessão de empresa
Alvo	Pessoa física	Empresa ou pessoa jurídica
Tipo de sessão	`user` (padrão)	`business`
Verificações principais	Documento, prova de vida, correspondência facial, AML	Consulta ao registro, UBO, diretores, AML da empresa
Verificações adicionais	Telefone, e-mail, comprovante de endereço, NFC	Coleta de documentos, AML de pessoas, vínculo com KYC
Payloads de webhook	Eventos de sessão padrão	Incluem `session_kind: "business"` e `business_session_id`

Próximos passos

Perfis de empresa

Acompanhe empresas entre sessões com perfis, tags e operações em massa.

Dados da empresa

Consultas a registros, situação da empresa e verificação cruzada de dados.

Estrutura de propriedade

Identificação de UBO, acionistas corporativos e cadeias de propriedade.

Diretores e administradores

Identificação de diretores, funções e vínculo com KYC.

Triagem AML

Verificações AML no nível da empresa e das pessoas.

Documentos

Coleta de documentos, solicitações e verificação por OCR.

​Como funciona

​Ciclo de vida da sessão de empresa

​Status por recurso

​Eventos de webhook

​Principais capacidades

​Sessões de empresa vs. sessões de usuário

​Próximos passos

Perfis de empresa

Dados da empresa

Estrutura de propriedade

Diretores e administradores

Triagem AML

Documentos

Como funciona

Ciclo de vida da sessão de empresa

Status por recurso

Eventos de webhook

Principais capacidades

Sessões de empresa vs. sessões de usuário

Próximos passos