Saltar al contenido principal
Un UBO es una persona física que posee o controla una empresa. En Entidades, un UBO no es un objeto separado: es un vínculo entre una entidad COMPANY y una entidad INDIVIDUAL.

Requisitos previos

  • La empresa registrada como entidad COMPANY. Consulta Crear una entidad.
  • Cada propietario registrado como entidad INDIVIDUAL, con sus propios documentos y archivos.
  • El internalId de la empresa y de cada propietario.

Flujo

El vínculo necesita ambos valores de internalId, así que primero crea las entidades. Los propietarios pueden vincularse mientras la empresa aún está en estado PENDING_KYC. Vincula a Jane Doe como directora ejecutiva con el 60% de la propiedad:
Request
Response
Vincula a John Doe como socio con el 40%. Envía el rol en mayúsculas; en minúsculas o con mayúsculas y minúsculas mezcladas (Partner) se devuelve el error 422 INVALID_CONTROL_ROLE:
Request
Response
Después de vincular, Obtener una entidad de la empresa devuelve uboCount y uboRequirementMet.

Normas

Error al vincular a la misma persona dos veces:
Considera UBO_ALREADY_LINKED como un éxito cuando vuelvas a intentar un vínculo, y lee los vínculos actuales con Listar los UBO de una empresa.
Cada propietario es una entidad con su propio KYC, revisado por Localpayment junto con la empresa. uboRequirementMet solo indica que hay al menos un propietario vinculado, no que los propietarios estén aprobados.

Próximos pasos

Realiza el seguimiento de las revisiones y corrige los rechazos.

Sigue la reseña de la empresa y de cada propietario.

Enlace a una referencia de UBO

Todos los campos de solicitud, campos de respuesta y códigos de error.
Última modificación el 10 de noviembre de 2026