Identificação Automatizada de UBO e Grafos de Propriedade (PT-PT)
Identifique beneficiários efetivos com percentagens de propriedade, resolva camadas aninhadas de propriedade corporativa e mapeie o grafo de controlo completo de qualquer empresa — parte de uma sessão KYB de 2,00 $.

Toda a obrigação KYB acaba por chegar à mesma questão: quem realmente é o proprietário desta empresa? Não os diretores da linha da frente, não a empresa-mãe no extrato do registo — os humanos reais cujas participações de propriedade significam que controlam e beneficiam, em última instância, do negócio. Identificar esses beneficiários efetivos (UBOs) é a parte mais difícil da verificação de negócios, porque a propriedade raramente é linear. Uma empresa é detida por outra empresa, que é detida por um fundo, que é detido por dois indivíduos e uma terceira entidade gestora noutro país. Desvendar isso manualmente, registo a registo, é lento e propenso a erros.
A API de Verificação de Negócios da Didit faz isso automaticamente. A funcionalidade Pessoas Chave de uma sessão KYB extrai os UBOs com as suas percentagens de propriedade, devolve todo o elenco de acionistas, diretores, administradores e representantes, e resolve camadas aninhadas de propriedade corporativa para que possa ver quem controla a entidade na base da cadeia. A extração de Pessoas Chave é gratuita como parte de uma sessão KYB — a verificação completa da empresa custa 2,00 $.
Este guia explica como funciona a identificação de UBO, o que o grafo de propriedade contém e como integrá-lo.
Principais conclusões
- Extração automatizada de UBO. A funcionalidade
kyb_key_peopleidentifica os beneficiários efetivos com as suas percentagens de propriedade — sem escavações manuais nos registos. - A imagem completa do controlo. Para além dos UBOs, obtém acionistas, diretores, administradores e representantes no mesmo resultado.
- Propriedade aninhada resolvida. Quando uma empresa é detida por outras empresas, a Didit resolve as camadas de propriedade corporativa para encontrar os humanos no fim da cadeia.
- A extração de Pessoas Chave é gratuita como parte de uma sessão KYB. A verificação completa da empresa — registo + UBO + administradores + AML da entidade — custa 2,00 $.
- Ciclo fechado, exclusivo da Didit. Cada UBO identificado pode gerar uma sessão KYC vinculada na mesma API
/v3/, para que não apenas nomeie os proprietários — você os verifica. - Estados em cada funcionalidade.
kyb_key_peoplereportaNOT_FINISHED,APPROVED,DECLINED,IN_REVIEW,RESUB_REQUESTEDouAWAITING_USER.
O que faz a identificação de UBO
Um UBO é uma pessoa singular que, em última instância, possui ou controla uma empresa, tipicamente acima de um limiar de propriedade regulamentar. O desafio é que a propriedade é estratificada: os acionistas imediatos da empresa que está a onboardar são frequentemente outras entidades legais, não pessoas. Para encontrar os verdadeiros proprietários beneficiários, tem de percorrer a árvore de propriedade — empresa por empresa, camada por camada — até chegar aos indivíduos.
A funcionalidade kyb_key_people da Didit faz esse percurso automaticamente. Devolve as pessoas e entidades ligadas à empresa, classifica-as por função, anexa percentagens de propriedade onde aplicável e sinaliza os proprietários corporativos para que as camadas aninhadas sejam explícitas em vez de estarem escondidas atrás de um único item. O resultado é um grafo de propriedade que pode ler, não uma lista plana que tem de interpretar.
Porque é que é importante
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 proprietários beneficiários acima do limiar de propriedade; a Lei de Transparência Corporativa dos EUA criou um regime federal de reporte de propriedade beneficiária; e a Recomendação 24 do GAFI impulsiona o mesmo padrão globalmente. Onboardar 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 diz-lhe que a empresa é detida por outra empresa — útil, mas não a resposta que o regulador quer. Resolver isso nos humanos reais é onde a maioria dos processos manuais de KYB falha, e onde a resolução automatizada de grafos de propriedade ganha o seu lugar.
Detalhes técnicos
A identificação de UBO é 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 devolve o grafo de controlo, com os 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 devolvidas. UBOs (com percentagem de propriedade), acionistas, diretores, administradores e representantes — mais camadas de propriedade corporativa, onde um proprietário corporativo tem os seus próprios proprietários até que a cadeia se resolva em indivíduos.
Estado da funcionalidade. kyb_key_people reporta NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED ou AWAITING_USER.
Webhooks. Subscreva data.updated (session_kind: business) para receber o grafo de propriedade à medida que é enriquecido, e status.updated para reagir a alterações de estado da funcionalidade.
Preço. A extração de Pessoas Chave é gratuita como parte de uma sessão KYB. A verificação completa da empresa custa 2,00 $. A execução de KYC vinculado num UBO é faturada às taxas padrão de Verificação de Utilizador.
A ler o grafo de propriedade
O grafo é construído para ser percorrido. Cada entrada tem uma função e, quando relevante, uma percentagem de propriedade. Os indivíduos são as folhas; os proprietários corporativos são ramos que têm os seus próprios owners. Uma lista de acionistas de duas linhas — uma pessoa, uma empresa — expande-se para a estrutura real: a pessoa, mais todos por trás da empresa, até aos indivíduos que, em última instância, beneficiam.
Isto é 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 numa pessoa singular, para que os UBOs que reporta sejam os humanos reais, não as empresas-mãe à sua frente.
Casos de uso
- Marketplaces que integram vendedores empresariais identificam os proprietários por trás de cada entidade vendedora antes de permitir pagamentos.
- Plataformas de fintech e banca que abrem contas corporativas resolvem a cadeia de propriedade completa para satisfazer as obrigações de propriedade beneficiária.
- Fornecedores de empréstimos que aprovam empréstimos empresariais veem quem, em última instância, controla o mutuário — e, portanto, quem é responsável.
- Plataformas Crypto B2B que integram entidades contraparte mapeiam a propriedade para garantir que nenhum indivíduo sancionado se esconde atrás de um véu corporativo.
Como integrar com a Didit
- Construa o fluxo de trabalho. Na Consola de Negócios, crie um fluxo de trabalho KYB com
kyb_key_peopleativado e ative o KYC vinculado para UBOs se quiser verificar os proprietários identificados. - Crie a sessão.
POST /v3/session/com o seuworkflow_idKYB e uma referênciavendor_datapara o seu registo de negócios interno. - Trate os webhooks. Ouça
data.updatedestatus.updated(session_kind: business) para receber e reagir ao grafo de propriedade. - Verifique os proprietários. Para cada UBO, gere uma sessão KYC vinculada na mesma API
/v3/para confirmar que o indivíduo nomeado é quem afirma ser.
Como tudo está na API unificada /v3/, identificar um UBO e verificar esse UBO é um fluxo contínuo — não duas ferramentas desconectadas e uma transferência manual.
Perguntas frequentes
Como são identificados os beneficiários efetivos?
Automaticamente, pela funcionalidade kyb_key_people de uma sessão KYB. Devolve os UBOs com percentagens de propriedade e resolve camadas aninhadas de propriedade corporativa para encontrar os indivíduos no fim da cadeia.
Lida com empresas detidas por outras empresas?
Sim. Os proprietários corporativos são sinalizados e têm os seus próprios proprietários, para que a Didit resolva as camadas aninhadas até que a propriedade atinja pessoas singulares.
Qual é o custo da identificação de UBO?
A extração de Pessoas Chave é gratuita como parte de uma sessão KYB. A verificação completa da empresa — registo, UBO, administradores e AML da entidade — custa 2,00 $. O KYC vinculado num UBO é faturado às taxas padrão de Verificação de Utilizador.
Que funções o resultado inclui?
UBOs (com percentagem de propriedade), acionistas, diretores, administradores e representantes, mais as 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 unificada /v3/ — verificação em ciclo fechado que é exclusiva da Didit.
Pronto para começar?
Leia a visão geral da Verificação de Negócios na documentação, veja como se encaixa no resto da plataforma na página do produto Verificação de Negócios 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 negócios a 2,00 $ por empresa.