Identificação Automatizada de UBOs e Grafos de Propriedade (PT-BR)

Toda obrigação KYB eventualmente chega à mesma pergunta: quem realmente é o dono desta empresa? Não os diretores da linha de frente, nem a holding no extrato do registro — mas os indivíduos cuja participação acionária significa que eles, em última instância, controlam e se beneficiam do negócio. Identificar esses beneficiários finais (UBOs) é a parte mais difícil da verificação de empresas, porque a propriedade raramente segue uma linha reta. Uma empresa é de propriedade de outra empresa, que é de propriedade de um fundo, que é de propriedade de dois indivíduos e uma terceira entidade holding em outro país. Desenrolar isso manualmente, registro por registro, é lento e propenso a erros.

A API de Verificação de Empresas da Didit faz isso automaticamente. O recurso Pessoas Chave de uma sessão KYB extrai UBOs com suas porcentagens de propriedade, retorna todo o elenco de acionistas, diretores, executivos e representantes, e resolve camadas aninhadas de propriedade corporativa para que você veja quem controla a entidade no final da cadeia. A extração de Pessoas Chave é gratuita como parte de uma sessão KYB — a verificação completa da empresa custa US$ 2,00.

Este guia explica como funciona a identificação de UBOs, o que o grafo de propriedade contém e como integrá-lo.

Principais pontos

• Extração automatizada de UBOs. O recurso kyb_key_people identifica os beneficiários finais com suas porcentagens de propriedade — sem necessidade de pesquisa manual em registros.
• O quadro completo de controle. Além dos UBOs, você obtém acionistas, diretores, executivos e representantes no mesmo resultado.
• Propriedade aninhada resolvida. Quando uma empresa é de propriedade de outras empresas, a Didit resolve as camadas de propriedade corporativa para encontrar os indivíduos no final da cadeia.
• A extração de Pessoas Chave é gratuita como parte de uma sessão KYB. A verificação completa da empresa — registro + UBO + executivos + AML da entidade — custa US$ 2,00.
• Ciclo fechado, exclusivo da Didit. Cada UBO identificado pode gerar uma sessão KYC vinculada na mesma API /v3/, para que você não apenas nomeie os proprietários — mas os verifique.
• Status em cada recurso. kyb_key_people informa NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED ou AWAITING_USER.

O que a identificação de UBOs faz

Um UBO é uma pessoa física que, em última instância, possui ou controla uma empresa, geralmente acima de um limite regulatório de propriedade. O desafio é que a propriedade é estratificada: os acionistas imediatos da empresa que você está integrando são frequentemente outras entidades legais, não pessoas. Para encontrar os verdadeiros beneficiários finais, você precisa percorrer a árvore de propriedade — empresa por empresa, camada por camada — até chegar aos indivíduos.

O recurso kyb_key_people da Didit faz esse percurso automaticamente. Ele retorna as pessoas e entidades conectadas à empresa, as classifica por função, anexa porcentagens de propriedade onde aplicável e sinaliza proprietários corporativos para que as camadas aninhadas sejam explícitas em vez de ocultas atrás de um único item. O resultado é um grafo de propriedade que você pode ler, não uma lista plana que você precisa interpretar.

Por que isso importa

A transparência da propriedade beneficiária é um pilar da regulamentação AML moderna. As diretivas AML da UE exigem que as entidades obrigadas identifiquem e verifiquem os beneficiários finais acima do limite de propriedade; o Ato de Transparência Corporativa dos EUA criou um regime federal de relatórios de propriedade beneficiária; e a Recomendação 24 do GAFI impulsiona o mesmo padrão globalmente. Integrar uma empresa sem saber quem está por trás dela é precisamente a lacuna que as estruturas de empresas de fachada exploram.

O problema operacional é a estratificação. Uma lista plana de acionistas informa que a empresa é de propriedade de outra empresa — útil, mas não a resposta que o regulador deseja. Resolver isso nos indivíduos reais é onde a maioria dos processos KYB manuais falha, e onde a resolução automatizada de grafos de propriedade ganha seu lugar.

Detalhes técnicos

A identificação de UBOs é executada dentro de uma sessão KYB criada contra a API unificada /v3/.

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your_kyb_workflow_id",
    "vendor_data": "corp_client_3310",
    "callback": "https://yourapp.com/kyb/callback"
  }'

O bloco kyb_key_people no resultado retorna o grafo de controle, com proprietários corporativos sinalizados para que as camadas aninhadas sejam explícitas:

{
  "kyb_key_people": {
    "status": "APPROVED",
    "ubos": [
      { "name": "Laura Méndez", "ownership_percentage": 60.0, "is_corporate": false },
      { "name": "Northwind Holding GmbH", "ownership_percentage": 40.0, "is_corporate": true,
        "owners": [
          { "name": "Thomas Berger", "ownership_percentage": 100.0, "is_corporate": false }
        ]
      }
    ],
    "directors": [ { "name": "Laura Méndez", "role": "DIRECTOR" } ],
    "officers": [ { "name": "Sven Albrecht", "role": "SECRETARY" } ],
    "representatives": [ { "name": "Laura Méndez", "role": "LEGAL_REPRESENTATIVE" } ]
  }
}

Funções retornadas. UBOs (com porcentagem de propriedade), acionistas, diretores, executivos e representantes — além das camadas de propriedade corporativa, onde um proprietário corporativo carrega seus próprios proprietários até que a cadeia se resolva em indivíduos.

Status do recurso. kyb_key_people informa NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED ou AWAITING_USER.

Webhooks. Assine data.updated (session_kind: business) para receber o grafo de propriedade à medida que é enriquecido, e status.updated para reagir às mudanças de status do recurso.

Preço. A extração de Pessoas Chave é gratuita como parte de uma sessão KYB. A verificação completa da empresa custa US$ 2,00. A execução de KYC vinculado em um UBO identificado é cobrada pelas taxas padrão de Verificação de Usuário.

Lendo o grafo de propriedade

O grafo é construído para ser percorrido. Cada entrada possui uma função e, quando relevante, uma porcentagem de propriedade. Indivíduos são as folhas; proprietários corporativos são ramos que carregam seus próprios owners. Uma lista de acionistas de duas linhas — uma pessoa, uma empresa — se expande na estrutura real: a pessoa, mais todos por trás da empresa, até os indivíduos que, em última instância, se beneficiam.

Isso é o que separa a identificação de UBO de um despejo de acionistas. Uma lista de acionistas para na primeira camada. Um grafo de propriedade continua a resolver até que cada ramo termine em uma pessoa física, para que os UBOs que você relata sejam os indivíduos reais, e não as holdings que os precedem.

Casos de uso

• Marketplaces que integram vendedores empresariais identificam os proprietários por trás de cada entidade vendedora antes de habilitar os pagamentos.
• Plataformas de fintech e bancárias que abrem contas corporativas resolvem a cadeia completa de propriedade para satisfazer as obrigações de propriedade beneficiária.
• Provedores de empréstimos que avaliam mutuários empresariais veem quem, em última instância, controla o mutuário — e, portanto, quem é responsável.
• Plataformas Crypto B2B que integram entidades contrapartes mapeiam a propriedade para garantir que nenhum indivíduo sancionado esteja por trás de um véu corporativo.

Como integrar com a Didit

1. Construa o fluxo de trabalho. No Business Console, crie um fluxo de trabalho KYB com kyb_key_people habilitado e ative o KYC vinculado para UBOs se você quiser verificar os proprietários identificados.
2. Crie a sessão. POST /v3/session/ com seu workflow_id KYB e uma referência vendor_data para seu registro comercial interno.
3. Lide com webhooks. Ouça data.updated e status.updated (session_kind: business) para receber e reagir ao grafo de propriedade.
4. Verifique os proprietários. Para cada UBO, crie uma sessão KYC vinculada na mesma API /v3/ unificada para confirmar que o indivíduo nomeado é quem ele afirma ser.

Como tudo está na API unificada /v3/, identificar um UBO e verificar esse UBO são um fluxo contínuo — não duas ferramentas desconectadas e uma transferência manual.

Perguntas frequentes

Como os beneficiários finais são identificados?

Automaticamente, pelo recurso kyb_key_people de uma sessão KYB. Ele retorna UBOs com porcentagens de propriedade e resolve camadas aninhadas de propriedade corporativa para encontrar os indivíduos no final da cadeia.

Ele lida com empresas de propriedade de outras empresas?

Sim. Os proprietários corporativos são sinalizados e carregam seus próprios proprietários, então a Didit resolve as camadas aninhadas até que a propriedade atinja pessoas físicas.

Quanto custa a identificação de UBOs?

A extração de Pessoas Chave é gratuita como parte de uma sessão KYB. A verificação completa da empresa — registro, UBO, executivos e AML da entidade — custa US$ 2,00. O KYC vinculado em um UBO é cobrado pelas taxas padrão de Verificação de Usuário.

Quais funções o resultado inclui?

UBOs (com porcentagem de propriedade), acionistas, diretores, executivos e representantes, além das camadas de propriedade corporativa que os conectam.

Posso verificar os UBOs, não apenas nomeá-los?

Sim. Cada UBO identificado pode gerar uma sessão KYC vinculada na mesma API /v3/ unificada — verificação em ciclo fechado que é exclusiva da Didit.

Pronto para começar?

Leia a visão geral da Verificação de Empresas na documentação, veja como ela se encaixa no restante da plataforma na página do produto Verificação de Empresas e verifique os preços transparentes por chamada na página de preços. Quando estiver pronto, comece gratuitamente — 500 verificações KYC gratuitas todos os meses e verificação de empresas por US$ 2,00 por empresa.