API de verificación de empresas (KYB): registro y UBO

La verificación de empresas (KYB) de Didit te permite verificar empresas y personas jurídicas antes de incorporarlas a tu plataforma. El sistema automatiza las consultas a registros mercantiles, identifica a los titulares reales y a los directivos, analiza a todas las partes en listas de vigilancia AML y recoge los documentos justificativos, todo en un único flujo. Cada empresa verificada se registra como un perfil de empresa que agrega los resultados de todas las sesiones. Esta lección de Didit Academy sigue una verificación de empresa de principio a fin: el panel de KYB, la comprobación en el registro, los accionistas y UBO, el análisis AML y lo que ve el representante de la empresa en su lado. ¿Eres nuevo en el KYB de Didit? Empieza con el inicio rápido para un recorrido completo de 10 minutos y luego lee la guía de integración para conocer los patrones de producción. Para el modelo de la entidad Empresa subyacente (vinculación con usuarios, listas de bloqueo, importación y exportación), consulta Empresas.

Cómo funciona

Crear una sesión de empresa

Inicia una verificación de empresa creando una sesión con un flujo de KYB. Cuando el tipo de flujo es KYB, Didit crea automáticamente una sesión de empresa:

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your-kyb-workflow-id",
    "vendor_data": "company-123"
  }'

El tipo de sesión lo determina el flujo: no hacen falta campos adicionales. Los flujos de KYB crean automáticamente sesiones de empresa con las funciones específicas de empresa habilitadas.

Consulta al registro mercantil

Didit consulta los registros mercantiles oficiales en el nivel Lite, Accionistas o UBO, cada uno con precio por país; consulta los precios de registros. Lite obtiene:

Dato	Descripción
Nombre de la empresa	Razón social tal como figura en el registro
Número de registro	Número oficial de registro de la empresa
País	País de constitución
Estado	Activa, disuelta, dada de baja, etc.
Tipo de empresa	Ltd, LLC, PLC, SA, GmbH, etc.
Fecha de constitución	Fecha en que se registró la empresa
Domicilio social	Dirección oficial del domicilio social
Número fiscal	Número de identificación fiscal (cuando está disponible)

Los datos del registro se contrastan con la información facilitada para detectar incoherencias.

Personas clave: UBO, accionistas, directores y representantes

El sistema identifica a todas las personas y entidades corporativas vinculadas a la empresa con el modelo unificado de personas clave:

UBO: personas físicas que poseen o controlan en última instancia la empresa, con sus porcentajes de propiedad y de voto
Accionistas (personas físicas y jurídicas): cada uno con su porcentaje de propiedad
Directores, representantes, secretarios, firmantes autorizados y otros cargos directivos: con su etiqueta de rol específica
Capas de propiedad corporativa: sociedades matrices de la cadena de propiedad, con KYB anidado opcional

Una misma persona puede tener varias etiquetas de rol (por ejemplo, director y accionista). Cada rol se configura individualmente en el flujo: qué roles requieren KYC, qué flujo de KYC usar y si el usuario final puede omitir la verificación. Más información en Personas clave y Titularidad.

Análisis AML

Todas las partes identificadas se analizan automáticamente en listas de vigilancia AML globales:

AML de la empresa: analiza la entidad empresarial en listas de sanciones, noticias negativas y listas de sanciones regulatorias
AML de personas: analiza individualmente a cada persona clave (UBO, accionista, director, representante, etc.)
Usa el mismo sistema de riesgo de dos puntuaciones (puntuación de coincidencia y puntuación de riesgo) que la verificación de usuarios

Recogida de documentos

Recoge y verifica los documentos justificativos:

Tipo de documento	Ejemplos
Certificado de constitución	Certificado de formación de la empresa
Estatutos sociales	Estatutos, acta fundacional
Prueba de domicilio	Facturas de servicios, extractos bancarios del domicilio social
Libro de accionistas	Registro oficial de accionistas
Estados financieros	Cuentas anuales, informes de auditoría
Certificados fiscales	Certificados de registro fiscal o de cumplimiento tributario
Documentos personalizados	Cualquier documento adicional que exija tu proceso de cumplimiento

Los analistas pueden solicitar documentos adicionales a la empresa durante el proceso de revisión.

Revisar y decidir

La sesión de empresa recibe un estado general basado en todas las comprobaciones:

Estado	Significado
Aprobado	Todas las comprobaciones se superaron: la empresa está verificada
En revisión	Una o más comprobaciones requieren revisión manual
Rechazado	Falló una comprobación crítica (por ejemplo, empresa disuelta, entidad sancionada)

Los analistas pueden revisar todos los datos recogidos en la Business Console, añadir comentarios, solicitar documentos adicionales y tomar una decisión final.

Ciclo de vida de una sesión de empresa

Cada verificación de empresa se ejecuta dentro de una sesión de empresa que registra el progreso a través de los siguientes estados:

Estado	Descripción
`NOT_STARTED`	Sesión creada, pero la verificación no ha comenzado
`IN_PROGRESS`	La verificación está en curso: consultas al registro, análisis AML o recogida de documentos en marcha
`APPROVED`	Todas las comprobaciones se superaron: la empresa está verificada
`DECLINED`	Falló una comprobación crítica (por ejemplo, empresa disuelta, entidad sancionada)
`IN_REVIEW`	Una o más comprobaciones requieren revisión manual de un analista
`RESUBMITTED`	Sesión rechazada anteriormente que se reenvió con datos actualizados

Cada sesión tiene un session_id único, un session_number secuencial y un session_token para el enlace de verificación alojado. Cuando se crea una sesión con un identificador vendor_data, Didit la vincula automáticamente con el perfil de empresa correspondiente.

Estados de las funciones

La verificación de empresas registra el estado de cada componente de forma independiente:

Función	Descripción
Comprobación en el registro	Consulta al registro mercantil y extracción de datos
AML de la empresa	Análisis AML de la empresa en listas de sanciones y de vigilancia
Documentos	Recogida de documentos, OCR y contraste de datos
Personas clave	Identificación de titulares reales y directivos, AML y KYC

Cada función puede estar en: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW o RESUB_REQUESTED. El estado general de la sesión agrega los estados de cada función: la sesión solo es APPROVED cuando todas las funciones obligatorias se superan.

Eventos de webhook

Las sesiones de empresa generan los siguientes eventos de webhook:

Evento	Desencadenante
`status.updated`	Cambió el estado de la sesión. El payload incluye `session_kind: "business"` en las sesiones de KYB.
`data.updated`	Cambiaron los datos de la sesión (registro, personas clave, documentos, AML). El payload incluye `session_kind: "business"`.
`business.status.updated`	Cambió el estado de la entidad Empresa vinculada (`ACTIVE` / `FLAGGED` / `BLOCKED`).
`business.data.updated`	Cambiaron los campos del perfil o los contadores agregados de la entidad Empresa vinculada.

Los payloads de los webhooks incluyen session_kind: "business" y el business_session_id para distinguirlos de los eventos de verificación de usuarios. Consulta Webhooks para ver la verificación de firmas y los detalles de entrega.

Capacidades principales

Capacidad	Descripción
Consultas automáticas a registros	Consulta los registros mercantiles oficiales de los países compatibles en el nivel Lite, Accionistas o UBO, con precio por país
Identificación de UBO	Extrae automáticamente las estructuras de titularidad real con sus porcentajes
Análisis de directivos	Identifica y verifica a directores, secretarios y otros cargos directivos
AML de la empresa	Analiza la entidad empresarial en listas de sanciones y de vigilancia
AML de personas	Analiza individualmente a todos los UBO y directivos identificados
Vinculación de KYC	Vincula a cada persona identificada con una sesión de verificación de usuario (KYC) para verificar su identidad
Recogida de documentos	Solicitudes de documentos estructuradas con seguimiento de las cargas
Contraste por OCR	Extrae datos de los documentos subidos y los contrasta con los datos del registro
Perfiles de empresa	Creación automática de perfiles y agregación de sesiones para cada empresa verificada
Estados por función	Seguimiento independiente del estado del registro, el AML, los documentos y las personas clave
Evaluación de riesgo	Nivel de riesgo general basado en el estado de la empresa, los resultados AML y la complejidad de la titularidad
Webhooks	Recibe en tiempo real los eventos del ciclo de vida y de actualización de datos de las sesiones mediante webhooks

Sesiones de empresa frente a sesiones de usuario

Función	Sesión de usuario	Sesión de empresa
Objetivo	Persona física	Empresa o persona jurídica
Tipo de sesión	`user` (por defecto)	`business`
Comprobaciones básicas	Identidad, prueba de vida, coincidencia facial, AML	Consulta al registro, UBO, directivos, AML de la empresa
Comprobaciones adicionales	Teléfono, correo electrónico, prueba de domicilio, NFC	Recogida de documentos, AML de personas, vinculación de KYC
Payloads de webhook	Eventos de sesión estándar	Incluyen `session_kind: "business"` y `business_session_id`

Siguientes pasos

Perfiles de empresa

Haz seguimiento de las empresas entre sesiones con perfiles, etiquetas y operaciones masivas.

Datos de la empresa

Consultas al registro, estado de la empresa y contraste de datos.

Estructura de titularidad

Identificación de UBO, accionistas corporativos y cadenas de titularidad.

Directivos y directores

Identificación de directores, roles y vinculación de KYC.

Análisis AML

Comprobaciones AML de la empresa y de las personas.

Documentos

Recogida de documentos, solicitudes y verificación por OCR.

​Cómo funciona

​Ciclo de vida de una sesión de empresa

​Estados de las funciones

​Eventos de webhook

​Capacidades principales

​Sesiones de empresa frente a sesiones de usuario

​Siguientes pasos

Perfiles de empresa

Datos de la empresa

Estructura de titularidad

Directivos y directores

Análisis AML

Documentos

Cómo funciona

Ciclo de vida de una sesión de empresa

Estados de las funciones

Eventos de webhook

Capacidades principales

Sesiones de empresa frente a sesiones de usuario

Siguientes pasos