API de Verificación de Empresas: Registro, UBO, Funcionarios y AML por $2 (ES)

Conocer a sus clientes individuales es solo la mitad del panorama. En el momento en que incorpora un negocio —un comerciante, un vendedor de mercado, una cuenta corporativa, un VASP contraparte— tiene que responder a un conjunto de preguntas más difíciles. ¿Es esta una empresa real y registrada? ¿Quién es su verdadero propietario? ¿Quién puede actuar en su nombre? ¿Y alguien detrás de ella está en una lista de sanciones o vigilancia? Know Your Business (KYB) es la disciplina que responde a estas cuatro preguntas, y históricamente ha significado extraer registros a mano, solicitar documentos de accionistas por correo electrónico y revisar nombres con una herramienta de detección separada.

La API de Verificación de Empresas de Didit lo condensa en una sola sesión. Usted crea una sesión KYB, y esta devuelve datos de registro verificados, identifica a los propietarios beneficiarios finales (UBO) y funcionarios, y examina la entidad contra listas de vigilancia globales — todo en la API unificada /v3/, por $2.00 por verificación de empresa sin mínimos.

Esta guía explica qué contiene una sesión KYB, cómo se tarifica y cómo integrarla.

Puntos clave

• Una sesión, cuatro verificaciones. Una sola sesión KYB agrupa kyb_registry, kyb_company_aml, kyb_documents y kyb_key_people — consulta de registro, AML de entidad, verificación de documentos e identificación de propietarios beneficiarios.
• $2.00 por empresa. La verificación completa — registro + identificación de UBO + selección de funcionarios + AML de entidad — tiene un precio fijo, facturado por empresa, sin mínimos.
• SKUs desagregados. ¿Necesita solo una parte? La selección de AML de empresa cuesta $0.20 por verificación, los documentos KYB cuestan $0.20 por documento, y la extracción de Personas Clave (UBOs + funcionarios) es gratuita — solo paga tarifas de Verificación de Usuario cuando ejecuta KYC vinculado en un UBO.
• Datos de registro reales. Nombre de la empresa, número de registro, país, estado, tipo, fecha de constitución, dirección registrada y número de identificación fiscal, extraídos de registros oficiales.
• Bucle cerrado, exclusivo de Didit. Una sesión KYB puede generar una sesión KYC vinculada para cada UBO en la misma API /v3/ — incorpore la empresa y verifique a las personas detrás de ella en un solo flujo.
• Gestionable. Una API de gestión completa y los webhooks business.status.updated / business.data.updated mantienen sus registros sincronizados.

Qué hace la verificación de empresas

Una verificación KYB confirma que una empresa existe, está en buen estado y está controlada por las personas que usted cree que la controlan. El modelo de sesión de Didit lo divide en cuatro características, cada una con su propio estado para que siempre sepa exactamente dónde se encuentra una verificación:

• kyb_registry — busca la empresa en el registro oficial y devuelve su registro principal: nombre legal, número de registro, país, estado, tipo de entidad, fecha de constitución, dirección registrada y número de identificación fiscal.
• kyb_company_aml — examina la propia empresa contra sanciones, listas de vigilancia y fuentes de medios adversos a nivel de entidad.
• kyb_documents — recopila y lee documentos de respaldo (certificado de constitución, estatutos, prueba de domicilio, estados financieros) con OCR y una verificación de manipulación.
• kyb_key_people — extrae a las personas importantes: UBOs con porcentajes de propiedad, accionistas, directores, funcionarios y representantes — incluyendo capas de propiedad corporativa anidadas.

Cada característica tiene uno de estos estados: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED o AWAITING_USER.

Por qué es importante

Las empresas reguladas están obligadas a verificar las empresas a las que sirven, identificar a los propietarios beneficiarios por encima del umbral de propiedad y examinar a las entidades y sus controladores contra las listas de sanciones. Las directivas AML de la UE, la Ley de Transparencia Corporativa de EE. UU. y regímenes equivalentes en todo el mundo convierten el KYB de un elemento deseable en un requisito legal, y las sanciones por incorporar una empresa fantasma o una entidad sancionada son severas.

El problema operativo es igual de real. La mayoría de los equipos ensamblan KYB a partir de un proveedor de datos de registro, un proceso manual de recopilación de documentos y una herramienta de detección separada, luego unen el gráfico de UBO en una hoja de cálculo. Didit colapsa esa pila en una sola sesión y una sola consola — registro, propiedad, documentos y detección en el mismo lugar, con un precio por empresa para que el costo se ajuste al volumen de incorporación en lugar de las licencias de asiento.

Detalles técnicos

Una verificación KYB se crea de la misma manera que cualquier otra sesión de Didit: se realiza un POST a /v3/session/ con un flujo de trabajo que tiene las características KYB habilitadas.

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": "merchant_8842",
    "callback": "https://yourapp.com/kyb/callback"
  }'

La sesión se resuelve en un resultado estructurado con el registro, las personas clave y los estados de las características:

{
  "session_id": "kyb_5f2a90c1",
  "status": "APPROVED",
  "vendor_data": "merchant_8842",
  "kyb_registry": {
    "status": "APPROVED",
    "company_name": "Acme Logistics S.L.",
    "registration_number": "B12345678",
    "country": "ES",
    "company_status": "ACTIVE",
    "company_type": "LIMITED_LIABILITY",
    "incorporation_date": "2019-03-14",
    "registered_address": "Calle Mayor 1, 28013 Madrid, ES",
    "tax_number": "ESB12345678"
  },
  "kyb_company_aml": { "status": "APPROVED" },
  "kyb_documents": { "status": "APPROVED" },
  "kyb_key_people": {
    "status": "APPROVED",
    "ubos": [
      { "name": "María García", "ownership_percentage": 55.0 },
      { "name": "Holdco Ventures B.V.", "ownership_percentage": 45.0, "is_corporate": true }
    ]
  }
}

Estados de la sesión. La sesión general pasa por NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED y EXPIRED.

Webhooks. Suscríbase a status.updated y data.updated (con session_kind de "business") para mantener su registro sincronizado a medida que avanza la verificación y se enriquecen los datos.

Precio. $2.00 por verificación de empresa para el paquete completo. Desagregado: AML de empresa $0.20 por verificación, documentos KYB $0.20 por documento, extracción de Personas Clave gratuita, y KYC vinculado en un UBO facturado a tarifas estándar de Verificación de Usuario.

Qué incluye la verificación

Consulta de registro (kyb_registry). El registro autorizado — nombre legal, número de registro, país, estado actual, tipo de entidad, fecha de constitución, dirección registrada y número de identificación fiscal — extraído de la fuente oficial en lugar de autodeclarado por el solicitante.

Personas clave (kyb_key_people). El panorama completo de control: UBOs con sus porcentajes de propiedad, accionistas, directores, funcionarios y representantes. Cuando la propiedad se extiende a través de otras empresas, Didit resuelve las capas corporativas anidadas para que vea quién controla finalmente la entidad.

AML de empresa (kyb_company_aml). Detección a nivel de entidad contra sanciones, listas de vigilancia y fuentes de medios adversos — para que una empresa que esté sancionada o reportada negativamente nunca pase desapercibida porque solo se verificaron sus funcionarios.

Documentos (kyb_documents). Los documentos de respaldo se recopilan, se leen con OCR y se someten a una verificación de manipulación, de modo que un certificado de constitución o una prueba de domicilio se verifican, no solo se archivan.

Casos de uso

• Los mercados que incorporan vendedores comerciales verifican que el vendedor sea una empresa real y en buen estado e identifican a las personas detrás de ella antes de que comiencen los pagos.
• Las plataformas de fintech y banca que abren cuentas corporativas ejecutan registro, UBO y AML de entidad en una sola sesión para cumplir con las obligaciones de KYB.
• Los proveedores de préstamos que suscriben prestatarios comerciales confirman la constitución, propiedad y estado antes de otorgar crédito.
• Las plataformas Crypto B2B que incorporan VASPs contraparte y clientes corporativos verifican la entidad y la examinan contra sanciones en una sola llamada.

Cómo integrar con Didit

1. Construya el flujo de trabajo. En la Consola de Empresas, cree un flujo de trabajo con las características KYB que necesite — registro, AML de empresa, documentos, personas clave — y active el KYC vinculado para UBOs si también desea verificar a las personas.
2. Cree la sesión. POST /v3/session/ con su workflow_id KYB y una referencia vendor_data que vincule la verificación a su registro comercial interno.
3. Maneje los webhooks. Escuche status.updated y data.updated (session_kind: business) para reaccionar a medida que la verificación se completa y los datos se enriquecen.
4. Gestione la entidad. Utilice la API de gestión — POST /v3/businesses/create/, GET /v3/businesses/, GET /v3/businesses/{vendor_data}/ y PATCH .../update-status/ — para rastrear y actualizar cada negocio como ACTIVE, FLAGGED o BLOCKED.

Debido a que todo está en la API unificada /v3/, una sesión KYB puede generar sesiones KYC para sus UBOs, esas personas fluyen hacia el monitoreo continuo y una transacción marcada puede generar una verificación de remediación — una plataforma de identidad y fraude, de principio a fin.

Preguntas frecuentes

¿Cuánto cuesta la verificación de empresas?

$2.00 por empresa para la verificación completa — consulta de registro, identificación de UBO, selección de funcionarios y AML de entidad. También puede comprar las partes: AML de empresa a $0.20 por verificación, documentos KYB a $0.20 por documento, y extracción de Personas Clave gratuita, con KYC de UBO vinculado facturado a tarifas estándar de Verificación de Usuario.

¿Qué datos de registro obtengo?

Nombre de la empresa, número de registro, país, estado de la empresa, tipo de entidad, fecha de constitución, dirección registrada y número de identificación fiscal — extraídos del registro oficial.

¿Puede identificar a los propietarios beneficiarios finales?

Sí. La característica kyb_key_people extrae los UBOs con porcentajes de propiedad, además de accionistas, directores, funcionarios y representantes, resolviendo las capas de propiedad corporativa anidadas en el camino.

¿Examina a la empresa contra sanciones?

Sí. kyb_company_aml examina la propia entidad contra sanciones, listas de vigilancia y fuentes de medios adversos a nivel de empresa.

¿También puedo verificar a las personas propietarias de la empresa?

Sí. En la API unificada /v3/, una sesión KYB puede generar una sesión KYC vinculada para cada UBO — verificación de circuito cerrado de la entidad y las personas detrás de ella en un solo flujo.

¿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.