API de Verificação de Empresas (KYB): Registo e UBO

A Verificação de empresas (KYB) da Didit permite verificar empresas e entidades jurídicas antes de as integrar na sua plataforma. O sistema automatiza as consultas aos registos de empresas, identifica os beneficiários efetivos e os administradores, faz a triagem de todas as partes em listas de vigilância AML e recolhe os documentos de suporte, tudo num único fluxo de verificação. Cada empresa verificada é acompanhada como um perfil empresarial, que agrega os resultados de todas as sessões. Esta lição da Didit Academy acompanha uma verificação de empresa do início ao fim: o painel KYB, a consulta ao registo, os acionistas e UBOs, a triagem AML e aquilo que o representante da empresa vê do seu lado. Novo no KYB da Didit? Comece pelo início rápido para uma visita guiada de 10 minutos do início ao fim e leia depois o guia de integração para padrões de produção. Para o modelo de entidade Business subjacente (com ligações a Utilizadores, listas de bloqueio, importação e exportação), veja Empresas.

Como funciona

Criar uma sessão empresarial

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

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 de sessão é determinado pelo fluxo, sem necessidade de campos adicionais. Os fluxos KYB criam automaticamente sessões empresariais com as funcionalidades específicas para empresas ativadas.

Consulta ao registo de empresas

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

Dados	Descrição
Nome da empresa	Nome legal tal como registado
Número de registo	Número oficial de registo da empresa
País	País de constituição
Estado	Ativa, dissolvida, cancelada do registo, etc.
Tipo de empresa	Ltd, LLC, PLC, SA, GmbH, etc.
Data de constituição	Data em que a empresa foi registada
Morada registada	Morada oficial da sede
Número de identificação fiscal	Número de identificação fiscal (quando disponível)

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

Pessoas-chave: UBO, acionistas, administradores e representantes

O sistema identifica todas as pessoas e entidades coletivas ligadas à empresa, no modelo unificado de Pessoas-chave:

UBO: pessoas singulares que, em última instância, detêm ou controlam a empresa, com as respetivas percentagens de propriedade e de voto
Acionistas (pessoas singulares e coletivas): cada um com a respetiva percentagem de participação
Administradores, representantes, secretários, signatários autorizados e outras funções de administrador ou dirigente: com a respetiva etiqueta de função
Camadas de propriedade societária: empresas-mãe na cadeia de propriedade, com KYB aninhado opcional

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

Triagem AML

Todas as partes identificadas são automaticamente sujeitas a triagem contra listas de vigilância AML globais:

AML da Empresa: faz a triagem da entidade da empresa contra listas de sanções, notícias adversas e listas de medidas de execução regulamentar
AML da Pessoa: faz a triagem de cada pessoa-chave (UBO, acionista, administrador, representante, etc.) individualmente
Utiliza o mesmo sistema de duas pontuações (pontuação de correspondência + pontuação de risco) que a verificação de utilizadores

Recolha de documentos

Recolha e verifique os documentos de suporte:

Tipo de documento	Exemplos
Certidão de constituição	Certificado de constituição da sociedade
Pacto social	Estatutos, memorando de constituição
Comprovativo de morada	Faturas de serviços e extratos bancários da morada registada
Registo de acionistas	Registo oficial de acionistas
Demonstrações financeiras	Contas anuais, relatórios de auditoria
Certidões fiscais	Certidões de inscrição ou de conformidade fiscal
Documentos personalizados	Quaisquer documentos adicionais exigidos pelo seu processo de conformidade

Os analistas podem solicitar documentos adicionais à empresa durante o processo de análise.

Análise e decisão

A sessão empresarial recebe um estado geral com base em todas as verificações:

Estado	Significado
Aprovado	Todas as verificações foram concluídas com sucesso: a empresa está verificada
Em análise	Uma ou mais verificações requerem revisão manual
Recusada	Uma verificação crítica falhou (por exemplo, empresa dissolvida, entidade sancionada)

Os analistas podem rever todos os dados recolhidos na 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 decorre numa sessão de empresa que acompanha o progresso pelos seguintes estados:

Estado	Descrição
`"Not Started"`	Sessão criada, mas a verificação ainda não começou
`"In Progress"`	A verificação está em curso: consultas ao registo, triagem AML ou recolha de documentos a decorrer
`"Approved"`	Todas as verificações foram aprovadas: a empresa está verificada
`"Declined"`	Uma verificação crítica falhou (por exemplo, empresa dissolvida ou entidade sancionada)
`"In Review"`	Uma ou mais verificações exigem revisão manual por um analista
`"Resubmitted"`	Sessão recusada anteriormente e reenviada com dados atualizados

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

Estados das funcionalidades

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

Funcionalidade	Descrição
Verificação de registo	Consulta ao registo de empresas e extração de dados
AML da Empresa	Triagem AML ao nível da empresa, contra listas de sanções e de vigilância
Documentos	Recolha de documentos, OCR e cruzamento de informação
Pessoas-chave	Identificação de beneficiários efetivos e responsáveis, AML e KYC

Cada funcionalidade pode estar em: "Not Finished", "Approved", "Declined", "In Review" ou "Resub Requested". O estado geral da sessão resulta da agregação dos estados individuais das funcionalidades: a sessão só fica "Approved" quando todas as funcionalidades obrigatórias forem aprovadas.

Eventos de webhook

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

Evento	Acionador
`status.updated`	O estado da sessão mudou. O payload inclui `session_kind: "business"` nas sessões KYB.
`data.updated`	Um revisor editou os dados do registo ou as Pessoas-chave na consola, ou o registo comunicou uma alteração. O payload inclui `session_kind: "business"`. Acompanhe o progresso através de `status.updated`.
`business.status.updated`	O estado da entidade empresarial associada mudou (`ACTIVE` / `FLAGGED` / `BLOCKED`).
`business.data.updated`	Os campos do perfil ou os contadores agregados da entidade de empresa associada foram alterados.

Os payloads dos webhooks incluem session_kind: "business" e o business_session_id para os distinguir dos eventos de verificação de utilizadores. Consulte Webhooks para a verificação da assinatura e os detalhes de entrega.

Principais capacidades

Capacidade	Descrição
Consultas automáticas ao registo	Consulta aos registos oficiais de empresas nos países suportados, nos níveis Lite, Shareholders ou UBOs, com preço por país
Identificação de UBO	Extração automática das estruturas de propriedade efetiva, com percentagens
Triagem de responsáveis	Identificação e verificação de administradores, secretários e outros responsáveis
AML da Empresa	Triagem da entidade empresarial contra listas de sanções e de vigilância
AML de pessoas	Triagem AML de todos os UBOs e responsáveis identificados, individualmente
Ligação KYC	Ligação de cada pessoa identificada a uma sessão de Verificação de utilizadores (KYC) para verificação de identidade
Recolha de documentos	Pedidos de documentos estruturados, com acompanhamento dos carregamentos
Cruzamento OCR	Extração de dados dos documentos carregados e cruzamento com os dados do registo
Perfis de empresa	Criação automática de perfis e agregação de sessões para cada empresa verificada
Estados por funcionalidade	Acompanhamento independente do estado do registo, da AML, dos documentos e das pessoas-chave
Avaliação de risco	Etiquetas de aviso em cada verificação e ações do fluxo que convertem o estado da empresa, os resultados AML e as conclusões sobre a propriedade num resultado
Webhooks	Receção de eventos do ciclo de vida da sessão e de atualização de dados em tempo real, através de webhooks

Sessões de empresa vs. sessões de utilizador

Funcionalidade	Sessão de utilizador	Sessão de empresa
Alvo	Pessoa individual	Empresa ou entidade jurídica
Tipo de sessão	`user` (predefinido)	`business`
Verificações principais	Verificação de identidade, prova de vida, correspondência facial, AML	Consulta ao registo, UBO, responsáveis, AML da Empresa
Verificações adicionais	Verificação de telefone, verificação de e-mail, comprovativo de morada, verificação NFC	Recolha de documentos, AML de pessoas, ligação 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 em várias sessões com perfis, etiquetas e operações em massa.

Dados da empresa

Consultas ao registo, estado da empresa e cruzamento de dados.

Estrutura de propriedade

Identificação de UBO, acionistas societários e cadeias de propriedade.

Responsáveis e administradores

Identificação de administradores, funções e ligação KYC.

Triagem AML

Verificações AML ao nível da empresa e de pessoas.

Documentos

Recolha de documentos, pedidos e verificação OCR.

Primeiros passos

Funcionalidades

Perfis de empresas

Referência

Consola

API de Verificação de Empresas (KYB): Registo e UBO

Como funciona

Ciclo de vida da sessão de empresa

Estados das funcionalidades

Eventos de webhook

Principais capacidades

Sessões de empresa vs. sessões de utilizador

Próximos passos

Perfis de empresa

Dados da empresa

Estrutura de propriedade

Responsáveis e administradores

Triagem AML

Documentos

​Como funciona

​Ciclo de vida da sessão de empresa

​Estados das funcionalidades

​Eventos de webhook

​Principais capacidades

​Sessões de empresa vs. sessões de utilizador

​Próximos passos

Perfis de empresa

Dados da empresa

Estrutura de propriedade

Responsáveis e administradores

Triagem AML

Documentos

Como funciona

Ciclo de vida da sessão de empresa

Estados das funcionalidades

Eventos de webhook

Principais capacidades

Sessões de empresa vs. sessões de utilizador

Próximos passos