Saltar al contenido principal
PATCH
Actualizar un UBO
Cambia el porcentaje de participación y/o el rol de control de un vínculo activo.
  • Un cuerpo vacío devuelve 400 VALIDATION_ERROR.
  • personId, validFrom y validTo no se pueden cambiar; finaliza el vínculo y crea uno nuevo.
Los errores usan application/problem+json con un code estable. Catálogo completo: Entity Statuses and Error Codes.

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"

uboId
string<uuid>
requerido

ID de enlace UBO.

Ejemplo:

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

Cuerpo

application/json
ownershipPercentage
number

De 0 a 100, con hasta dos decimales.

Ejemplo:

55.5

controlRole
enum<string>

Nuevo rol, uno de los códigos de Vincular un UBO. Una cadena vacía devuelve 422 INVALID_CONTROL_ROLE; el rol no se puede borrar.

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:

"PARTNER"

Respuesta

OK.

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.

Ejemplo:

55.5

controlRole
string | null

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

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