Pular para o conteúdo principal
Um UBO é uma pessoa física que possui ou controla uma empresa. Em Entities, um UBO não é um objeto separado: é um vínculo entre uma entidade COMPANY e uma entidade INDIVIDUAL.

Pré-requisitos

  • A empresa registrada como uma entidade COMPANY. Consulte Criar uma entidade.
  • Cada proprietário registrado como uma entidade INDIVIDUAL, com seus próprios documentos e arquivos.
  • O internalId da empresa e de cada proprietário.

Fluxo

O link precisa de ambos os valores de internalId, então crie as entidades primeiro. Os proprietários podem ser vinculados enquanto a empresa ainda estiver PENDING_KYC. Link para Jane Doe como CEO com 60% de participação acionária:
Request
Response
Vincule John Doe como sócio com 40%. Envie a função em letras maiúsculas; minúsculas ou maiúsculas e minúsculas misturadas (Partner) retornam 422 INVALID_CONTROL_ROLE:
Request
Response
Após vincular, Obter uma Entidade na empresa retorna uboCount e uboRequirementMet.

Regras

Erro ao vincular a mesma pessoa duas vezes:
Considere UBO_ALREADY_LINKED como um sucesso ao tentar novamente um link e leia os links atuais com Listar UBOs de uma empresa.
Cada proprietário é uma entidade com seu próprio KYC, analisado pela Localpayment junto com a empresa. uboRequirementMet apenas informa que pelo menos um proprietário está vinculado, não que os proprietários estejam aprovados.

Próximos passos

Acompanhe a revisão e corrija as rejeições.

Acompanhe a avaliação da empresa e de cada proprietário.

Inclua uma referência UBO

Todos os campos de solicitação, campos de resposta e códigos de erro.
Última modificação em 10 de novembro de 2026