Vincular un UBO
curl --request POST \
--url https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"personId": "c1e384f5-ae1c-475e-9e64-a0abe533a96f",
"ownershipPercentage": 60,
"controlRole": "CEO"
}
'import requests
url = "https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos"
payload = {
"personId": "c1e384f5-ae1c-475e-9e64-a0abe533a96f",
"ownershipPercentage": 60,
"controlRole": "CEO"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
personId: 'c1e384f5-ae1c-475e-9e64-a0abe533a96f',
ownershipPercentage: 60,
controlRole: 'CEO'
})
};
fetch('https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'personId' => 'c1e384f5-ae1c-475e-9e64-a0abe533a96f',
'ownershipPercentage' => 60,
'controlRole' => 'CEO'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos"
payload := strings.NewReader("{\n \"personId\": \"c1e384f5-ae1c-475e-9e64-a0abe533a96f\",\n \"ownershipPercentage\": 60,\n \"controlRole\": \"CEO\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"personId\": \"c1e384f5-ae1c-475e-9e64-a0abe533a96f\",\n \"ownershipPercentage\": 60,\n \"controlRole\": \"CEO\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"personId\": \"c1e384f5-ae1c-475e-9e64-a0abe533a96f\",\n \"ownershipPercentage\": 60,\n \"controlRole\": \"CEO\"\n}"
response = http.request(request)
puts response.read_body{
"id": "4584b476-ccc6-4e98-be40-0c5082748e35",
"companyId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"personId": "c1e384f5-ae1c-475e-9e64-a0abe533a96f",
"ownershipPercentage": 60,
"controlRole": "CEO",
"validFrom": "2024-01-15",
"validTo": null,
"createdAt": "2024-01-15T17:20:47Z"
}
UBOs
Vincular un UBO
POST
/
api
/
entity
/
v1
/
entities
/
{companyId}
/
ubos
Vincular un UBO
curl --request POST \
--url https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"personId": "c1e384f5-ae1c-475e-9e64-a0abe533a96f",
"ownershipPercentage": 60,
"controlRole": "CEO"
}
'import requests
url = "https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos"
payload = {
"personId": "c1e384f5-ae1c-475e-9e64-a0abe533a96f",
"ownershipPercentage": 60,
"controlRole": "CEO"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
personId: 'c1e384f5-ae1c-475e-9e64-a0abe533a96f',
ownershipPercentage: 60,
controlRole: 'CEO'
})
};
fetch('https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'personId' => 'c1e384f5-ae1c-475e-9e64-a0abe533a96f',
'ownershipPercentage' => 60,
'controlRole' => 'CEO'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos"
payload := strings.NewReader("{\n \"personId\": \"c1e384f5-ae1c-475e-9e64-a0abe533a96f\",\n \"ownershipPercentage\": 60,\n \"controlRole\": \"CEO\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"personId\": \"c1e384f5-ae1c-475e-9e64-a0abe533a96f\",\n \"ownershipPercentage\": 60,\n \"controlRole\": \"CEO\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stage.localpayment.com/api/entity/v1/entities/{companyId}/ubos")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"personId\": \"c1e384f5-ae1c-475e-9e64-a0abe533a96f\",\n \"ownershipPercentage\": 60,\n \"controlRole\": \"CEO\"\n}"
response = http.request(request)
puts response.read_body{
"id": "4584b476-ccc6-4e98-be40-0c5082748e35",
"companyId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"personId": "c1e384f5-ae1c-475e-9e64-a0abe533a96f",
"ownershipPercentage": 60,
"controlRole": "CEO",
"validFrom": "2024-01-15",
"validTo": null,
"createdAt": "2024-01-15T17:20:47Z"
}
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.
application/problem+json con un code estable. Catálogo completo: Estados de entidades y códigos de error.Autorizaciones
Encabezados
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>"
Parámetros de ruta
Cuerpo
application/json
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"
Respuesta
Creado.
Última modificación el 10 de noviembre de 2026

