Pular para o conteúdo principal
POST
Vincule um UBO
Vincula uma entidade INDIVIDUAL como beneficiário final (UBO) de uma entidade COMPANY, com o percentual de participação e o papel de controle. Ambas as entidades já devem existir.
  • A vinculação é permitida enquanto a empresa estiver em PENDING_KYC ou ACTIVE. Enquanto estiver em IN_REVIEW, retorna 409 ENTITY_IN_REVIEW; não é permitida quando estiver em CLOSED, BLOCKED ou REJECTED.
  • Até 50 vínculos de UBO ativos por empresa. A mesma pessoa não pode ser vinculada duas vezes enquanto houver um vínculo ativo.
  • Após a vinculação, Get an Entity na empresa retorna uboCount e uboRequirementMet.
Os erros usam application/problem+json com um code estável. Catálogo completo: Entity Statuses and Error Codes.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cabeçalhos

Authorization
string
obrigatório

Token de acesso Bearer para autenticação. Este token é obtido nos endpoints Obter token de acesso ou Renovar token de acesso. Sua conta de comerciante e o usuário que realiza a ação são identificados a partir dele.

Exemplo:

"Bearer <your_access_token>"

X-Correlation-ID
string

Identificador de rastreamento (UUID). Exibido na resposta; gerado pelo Localpayment se ausente.

Exemplo:

"0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10"

Parâmetros de caminho

companyId
string<uuid>
obrigatório

ID interno da EMPRESA.

Exemplo:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

Corpo

application/json
personId
string<uuid>
obrigatório

ID interno do INDIVÍDUO.

Exemplo:

"c1e384f5-ae1c-475e-9e64-a0abe533a96f"

ownershipPercentage
number | null
obrigatório

De 0 a 100, com até duas casas decimais. Envie null quando a porcentagem for desconhecida e 0 para um representante legal que não possui ações.

Exemplo:

60

controlRole
enum<string>

Função da pessoa, um dos 24 códigos. Diferencia maiúsculas de minúsculas: director retorna 422 INVALID_CONTROL_ROLE. Use LEGAL_REPRESENTATIVE para o representante legal e AUTHORIZED_SIGNATORY para uma pessoa que assina mediante procuração.

Opções disponíveis:
CEO,
CFO,
COO,
CTO,
PRESIDENT,
VICE_PRESIDENT,
DIRECTOR,
MANAGING_DIRECTOR,
MANAGING_PARTNER,
GENERAL_PARTNER,
PARTNER,
SECRETARY,
TREASURER,
CHAIRMAN,
BOARD_MEMBER,
AUTHORIZED_SIGNATORY,
GENERAL_COUNSEL,
OWNER,
FOUNDER,
MANAGER,
MEMBER,
COMPTROLLER,
CHIEF_COMPLIANCE_OFFICER,
LEGAL_REPRESENTATIVE
Exemplo:

"CEO"

validFrom
string<date>

AAAA-MM-DD. Padrão: hoje.

Exemplo:

"2024-01-15"

validTo
string<date>

AAAA-MM-DD, a partir de validFrom. Omita para links abertos.

Exemplo:

"2025-01-15"

Resposta

Criado.

id
string

Identificador de link UBO (uboId).

Exemplo:

"4584b476-ccc6-4e98-be40-0c5082748e35"

companyId
string<uuid>

A entidade COMPANY.

Exemplo:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

personId
string<uuid>

A entidade INDIVIDUAL. Nenhum dado pessoal da pessoa é retornado aqui.

Exemplo:

"c1e384f5-ae1c-475e-9e64-a0abe533a96f"

ownershipPercentage
number | null

De 0 a 100, com até duas casas decimais. null quando a porcentagem for desconhecida.

Exemplo:

60

controlRole
string

Função em maiúsculas, por exemplo CEO, PARTNER, DIRECTOR, LEGAL_REPRESENTATIVE. null quando não informada.

Exemplo:

"CEO"

validFrom
string<date>

Validade do link. O parâmetro validTo é nulo enquanto o link estiver ativo.

Exemplo:

"2024-01-15"

validTo
string<date> | null

Validade do link. O parâmetro validTo é nulo enquanto o link estiver ativo.

createdAt
string<date-time>

Tempo de criação.

Exemplo:

"2024-01-15T17:20:47Z"

Última modificação em 10 de novembro de 2026