> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Didit verifica empresas con consulta a registros, identificación de UBO, análisis de directivos y AML. Desde $2.00 por comprobación, sin contratos.

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](https://docs.didit.me/business-verification/business-profiles.md) 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.

[Verifica una empresa (KYB) de principio a fin — Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?rel=0\&playsinline=1)

¿Eres nuevo en el KYB de Didit? Empieza con el [inicio rápido](https://docs.didit.me/es/business-verification/quickstart.md) para un recorrido completo de 10 minutos y luego lee la [guía de integración](https://docs.didit.me/business-verification/integration-guide.md) 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](https://docs.didit.me/entities/businesses/overview.md).

## Cómo funciona

**1. 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:

```bash theme={null}
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.

**2. 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](https://docs.didit.me/getting-started/kyb-registry-pricing.md). 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.

**3. 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](https://docs.didit.me/business-verification/key-people.md) y [Titularidad](https://docs.didit.me/business-verification/ownership.md).

**4. 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](https://docs.didit.me/es/core-technology/aml-screening/overview.md) (puntuación de coincidencia y puntuación de riesgo) que la verificación de usuarios

**5. 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.

**6. 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](https://docs.didit.me/business-verification/business-profiles.md) 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](https://docs.didit.me/entities/businesses/overview.md) 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](https://docs.didit.me/integration/webhooks.md) 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](https://docs.didit.me/getting-started/kyb-registry-pricing.md) |
| **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](https://docs.didit.me/integration/webhooks.md) |

## 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](https://docs.didit.me/business-verification/business-profiles.md)**
>
> Haz seguimiento de las empresas entre sesiones con perfiles, etiquetas y operaciones masivas.

> **[Datos de la empresa](https://docs.didit.me/business-verification/company-data.md)**
>
> Consultas al registro, estado de la empresa y contraste de datos.

> **[Estructura de titularidad](https://docs.didit.me/business-verification/ownership.md)**
>
> Identificación de UBO, accionistas corporativos y cadenas de titularidad.

> **[Directivos y directores](https://docs.didit.me/business-verification/officers.md)**
>
> Identificación de directores, roles y vinculación de KYC.

> **[Análisis AML](https://docs.didit.me/business-verification/aml.md)**
>
> Comprobaciones AML de la empresa y de las personas.

> **[Documentos](https://docs.didit.me/business-verification/documents.md)**
>
> Recogida de documentos, solicitudes y verificación por OCR.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.