Identificación Automatizada de UBO y Grafos de Propiedad (ES)
Identifique a los beneficiarios finales con porcentajes de propiedad, resuelva capas anidadas de propiedad corporativa y mapee el grafo de control completo de cualquier empresa, como parte de una sesión KYB de $2.00.

Toda obligación KYB finalmente llega a la misma pregunta: ¿quién es el verdadero dueño de esta empresa? No los directores de primera línea, no la sociedad holding en el extracto del registro, sino las personas físicas cuyas participaciones accionariales significan que, en última instancia, controlan y se benefician del negocio. Identificar a esos beneficiarios finales (UBOs) es la parte más difícil de la verificación de empresas, porque la propiedad rara vez es lineal. Una empresa es propiedad de otra empresa, que es propiedad de un fondo, que es propiedad de dos personas y una tercera entidad holding en otro país. Desenredar eso a mano, registro por registro, es lento y propenso a errores.
La API de Verificación de Empresas de Didit lo hace automáticamente. La función Personas Clave de una sesión KYB extrae los UBOs con sus porcentajes de propiedad, devuelve el elenco completo de accionistas, directores, funcionarios y representantes, y resuelve las capas anidadas de propiedad corporativa para que vea quién controla la entidad al final de la cadena. La extracción de Personas Clave es gratuita como parte de una sesión KYB; la verificación completa de la empresa cuesta $2.00.
Esta guía explica cómo funciona la identificación de UBO, qué contiene el grafo de propiedad y cómo integrarlo.
Puntos clave
- Extracción automatizada de UBO. La función
kyb_key_peopleidentifica a los beneficiarios finales con sus porcentajes de propiedad, sin necesidad de buscar manualmente en registros. - El panorama completo de control. Más allá de los UBOs, obtendrá accionistas, directores, funcionarios y representantes en el mismo resultado.
- Propiedad anidada resuelta. Cuando una empresa es propiedad de otras empresas, Didit resuelve las capas de propiedad corporativa para encontrar a las personas al final de la cadena.
- La extracción de Personas Clave es gratuita como parte de una sesión KYB. La verificación completa de la empresa —registro + UBO + funcionarios + AML de entidad— cuesta $2.00.
- De circuito cerrado, exclusivo de Didit. Cada UBO identificado puede generar una sesión KYC vinculada en la misma API
/v3/, por lo que no solo nombra a los propietarios, sino que también los verifica. - Estados en cada función.
kyb_key_peopleinformaNOT_FINISHED,APPROVED,DECLINED,IN_REVIEW,RESUB_REQUESTEDoAWAITING_USER.
Qué hace la identificación de UBO
Un UBO es una persona física que, en última instancia, posee o controla una empresa, generalmente por encima de un umbral de propiedad regulatorio. El desafío es que la propiedad está estratificada: los accionistas inmediatos de la empresa que está incorporando suelen ser otras entidades legales, no personas. Para encontrar a los verdaderos beneficiarios finales, debe recorrer el árbol de propiedad, empresa por empresa, capa por capa, hasta llegar a los individuos.
La función kyb_key_people de Didit realiza ese recorrido automáticamente. Devuelve las personas y entidades conectadas a la empresa, las clasifica por rol, adjunta los porcentajes de propiedad cuando corresponden y marca a los propietarios corporativos para que las capas anidadas sean explícitas en lugar de ocultas detrás de un solo elemento. El resultado es un grafo de propiedad que puede leer, no una lista plana que tiene que interpretar.
Por qué es importante
La transparencia de la propiedad beneficiaria es una piedra angular de la regulación AML moderna. Las directivas AML de la UE exigen que las entidades obligadas identifiquen y verifiquen a los beneficiarios finales por encima del umbral de propiedad; la Ley de Transparencia Corporativa de EE. UU. creó un régimen federal de informes de propiedad beneficiaria; y la Recomendación 24 del GAFI impulsa el mismo estándar a nivel mundial. Incorporar una empresa sin saber quién está detrás de ella es precisamente la brecha que explotan las estructuras de empresas pantalla.
El problema operativo es la estratificación. Una lista plana de accionistas le dice que la empresa es propiedad de otra empresa, útil, pero no la respuesta que quiere el regulador. Resolver eso en las personas reales es donde la mayoría de los procesos KYB manuales fallan, y donde la resolución automatizada del grafo de propiedad se gana su lugar.
Detalles técnicos
La identificación de UBO se ejecuta dentro de una sesión KYB creada contra la API unificada /v3/.
curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workflow_id": "your_kyb_workflow_id",
"vendor_data": "corp_client_3310",
"callback": "https://yourapp.com/kyb/callback"
}'
El bloque kyb_key_people en el resultado devuelve el grafo de control, con los propietarios corporativos marcados para que las capas anidadas sean explícitas:
{
"kyb_key_people": {
"status": "APPROVED",
"ubos": [
{ "name": "Laura Méndez", "ownership_percentage": 60.0, "is_corporate": false },
{ "name": "Northwind Holding GmbH", "ownership_percentage": 40.0, "is_corporate": true,
"owners": [
{ "name": "Thomas Berger", "ownership_percentage": 100.0, "is_corporate": false }
]
}
],
"directors": [ { "name": "Laura Méndez", "role": "DIRECTOR" } ],
"officers": [ { "name": "Sven Albrecht", "role": "SECRETARY" } ],
"representatives": [ { "name": "Laura Méndez", "role": "LEGAL_REPRESENTATIVE" } ]
}
}
Roles devueltos. UBOs (con porcentaje de propiedad), accionistas, directores, funcionarios y representantes, además de las capas de propiedad corporativa, donde un propietario corporativo tiene sus propios propietarios hasta que la cadena se resuelve en individuos.
Estado de la función. kyb_key_people informa NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED o AWAITING_USER.
Webhooks. Suscríbase a data.updated (session_kind: business) para recibir el grafo de propiedad a medida que se enriquece, y a status.updated para reaccionar a los cambios de estado de la función.
Precio. La extracción de Personas Clave es gratuita como parte de una sesión KYB. La verificación completa de la empresa cuesta $2.00. La ejecución de KYC vinculado en un UBO se factura a las tarifas estándar de Verificación de Usuario.
Lectura del grafo de propiedad
El grafo está construido para ser recorrido. Cada entrada lleva un rol y, cuando es relevante, un porcentaje de propiedad. Los individuos son las hojas; los propietarios corporativos son ramas que tienen sus propios owners. Una lista de accionistas de dos líneas —una persona, una empresa— se expande en la estructura real: la persona, más todos los que están detrás de la empresa, hasta los individuos que, en última instancia, se benefician.
Esto es lo que separa la identificación de UBO de un volcado de accionistas. Una lista de accionistas se detiene en la primera capa. Un grafo de propiedad sigue resolviendo hasta que cada rama termina en una persona física, por lo que los UBOs que usted informa son las personas reales, no las sociedades holding que los preceden.
Casos de uso
- Los mercados que incorporan vendedores empresariales identifican a los propietarios detrás de cada entidad vendedora antes de habilitar los pagos.
- Las plataformas de fintech y banca que abren cuentas corporativas resuelven la cadena de propiedad completa para cumplir con las obligaciones de propiedad beneficiaria.
- Los proveedores de préstamos que evalúan a los prestatarios empresariales ven quién controla, en última instancia, al prestatario, y, por lo tanto, quién es el responsable.
- Las plataformas Crypto B2B que incorporan entidades contraparte mapean la propiedad para asegurar que ninguna persona sancionada se oculte tras un velo corporativo.
Cómo integrar con Didit
- Construya el flujo de trabajo. En la Consola de Negocios, cree un flujo de trabajo KYB con
kyb_key_peoplehabilitado, y active el KYC vinculado para UBOs si desea verificar a los propietarios identificados. - Cree la sesión.
POST /v3/session/con suworkflow_idde KYB y una referenciavendor_datapara su registro interno de negocios. - Maneje los webhooks. Escuche
data.updatedystatus.updated(session_kind: business) para recibir y reaccionar al grafo de propiedad. - Verifique a los propietarios. Para cada UBO, genere una sesión KYC vinculada en la misma API
/v3/para confirmar que la persona nombrada es quien dice ser.
Debido a que todo está en la API unificada /v3/, identificar un UBO y verificar ese UBO es un flujo continuo, no dos herramientas desconectadas y una transferencia manual.
Preguntas frecuentes
¿Cómo se identifican los beneficiarios finales?
Automáticamente, mediante la función kyb_key_people de una sesión KYB. Devuelve UBOs con porcentajes de propiedad y resuelve las capas anidadas de propiedad corporativa para encontrar a los individuos al final de la cadena.
¿Maneja empresas que son propiedad de otras empresas?
Sí. Los propietarios corporativos se marcan y tienen sus propios propietarios, por lo que Didit resuelve las capas anidadas hasta que la propiedad llega a personas físicas.
¿Cuánto cuesta la identificación de UBO?
La extracción de Personas Clave es gratuita como parte de una sesión KYB. La verificación completa de la empresa —registro, UBO, funcionarios y AML de entidad— cuesta $2.00. El KYC vinculado en un UBO se factura a las tarifas estándar de Verificación de Usuario.
¿Qué roles incluye el resultado?
UBOs (con porcentaje de propiedad), accionistas, directores, funcionarios y representantes, además de las capas de propiedad corporativa que los conectan.
¿Puedo verificar los UBOs, no solo nombrarlos?
Sí. Cada UBO identificado puede generar una sesión KYC vinculada en la misma API unificada /v3/, una verificación de circuito cerrado exclusiva de Didit.
¿Listo para empezar?
Lea la descripción general de Verificación de Empresas en la documentación, vea cómo encaja con el resto de la plataforma en la página de producto de Verificación de Empresas, y consulte los precios transparentes por llamada en la página de precios. Cuando esté listo, comience gratis — 500 verificaciones KYC gratuitas cada mes y verificación de empresas a $2.00 por empresa.