Saltar al contenido principal
POST
Vincular un UBO
Vincula una entidad INDIVIDUAL como beneficiario final (UBO) de una entidad COMPANY, con el porcentaje de participación y el rol de control. Ambas entidades deben existir previamente.
  • Se permite vincular mientras la empresa esté en PENDING_KYC o ACTIVE. Mientras esté en IN_REVIEW devuelve 409 ENTITY_IN_REVIEW; no se permite cuando está en CLOSED, BLOCKED o REJECTED.
  • Hasta 50 vínculos UBO activos por empresa. La misma persona no puede vincularse dos veces mientras haya un vínculo activo.
  • Después de vincular, Obtener una entidad sobre la empresa devuelve uboCount y uboRequirementMet.
Los errores usan application/problem+json con un code estable. Catálogo completo: Estados de entidades y códigos de error.

Autorizaciones

Authorization
string
header
requerido

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

Encabezados

Authorization
string
requerido

Token de acceso Bearer para la autenticación. Este token se obtiene de los endpoints Get Access Token o Refresh Access Token. Tu cuenta de comerciante y el usuario que actúa se determinan a partir de él.

Ejemplo:

"Bearer <your_access_token>"

X-Correlation-ID
string

Identificador de seguimiento (UUID). Se incluye en la respuesta; Localpayment lo genera si no está presente.

Ejemplo:

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

Parámetros de ruta

companyId
string<uuid>
requerido

internalId de la COMPANY.

Ejemplo:

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

Cuerpo

application/json
personId
string<uuid>
requerido

internalId del INDIVIDUAL.

Ejemplo:

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

ownershipPercentage
number | null
requerido

De 0 a 100, con hasta dos decimales. Envía null cuando se desconozca el porcentaje, y 0 para un representante legal que no posee participación accionaria.

Ejemplo:

60

controlRole
enum<string>

Rol de la persona, uno de los 24 códigos. Distingue mayúsculas y minúsculas: director devuelve 422 INVALID_CONTROL_ROLE. Usa LEGAL_REPRESENTATIVE para el representante legal y AUTHORIZED_SIGNATORY para una persona que firma en virtud de un poder notarial.

Opciones disponibles:
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
Ejemplo:

"CEO"

validFrom
string<date>

AAAA-MM-DD. Predeterminado: hoy.

Ejemplo:

"2024-01-15"

validTo
string<date>

AAAA-MM-DD, en o después de validFrom. Omitir para un enlace abierto.

Ejemplo:

"2025-01-15"

Respuesta

Creado.

id
string

Identificador de enlace UBO (uboId).

Ejemplo:

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

companyId
string<uuid>

La entidad COMPAÑÍA.

Ejemplo:

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

personId
string<uuid>

La entidad INDIVIDUAL. Aquí no se devuelve ningún dato personal de la persona.

Ejemplo:

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

ownershipPercentage
number | null

De 0 a 100, con hasta dos decimales. null cuando se desconoce el porcentaje.

Ejemplo:

60

controlRole
string

Cargo en mayúsculas, por ejemplo CEO, PARTNER, DIRECTOR, LEGAL_REPRESENTATIVE. Nulo cuando no se informa.

Ejemplo:

"CEO"

validFrom
string<date>

Validez del enlace. validTo es nulo mientras el enlace está activo.

Ejemplo:

"2024-01-15"

validTo
string<date> | null

Validez del enlace. validTo es nulo mientras el enlace está activo.

createdAt
string<date-time>

Tiempo de creación.

Ejemplo:

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

Última modificación el 10 de noviembre de 2026