Saltar al contenido principal
POST
curl

Descripción general

Crea explícitamente una entidad empresarial antes de que se ejecute cualquier sesión de Verificación de empresas (KYB).

Cuándo usarlo

  • Precargar metadatos (socio, nivel, identificadores internos) antes de la primera sesión de Verificación de empresas (KYB).
  • Migrar desde otro proveedor de KYB con una lista de empresas existente.
  • Registro solo para transacciones: enviar transacciones de una empresa que verificaste mediante un proceso fuera de línea.

Notas

  • vendor_data es obligatorio y único por aplicación. Los duplicados devuelven un error de conflicto: usa PATCH /v3/businesses/{vendor_data}/ para actualizar.
  • Los campos derivados del registro (legal_name, registration_number, country_code) se pueden precargar, pero los datos del registro de la primera sesión de Verificación de empresas (KYB) aprobada los sobrescribirán.
  • Si country_code coincide con la lista de países peligrosos de tu aplicación, la empresa se crea con el estado BLOCKED.
  • Emite business.data.updated.

Permisos

El rol debe otorgar create:businesses.

Relacionado

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Cuerpo

application/json
vendor_data
string | null

Tu identificador único de esta empresa (cadena de texto libre, NO un UUID). Es opcional, pero muy recomendable. Si lo indicas, debe ser único entre las empresas no eliminadas de la aplicación; se compara exactamente tal como se envía.

display_name
string | null

Nombre visible descriptivo que se muestra en la consola (tiene prioridad sobre legal_name en la interfaz).

Maximum string length: 255

Razón social oficial de la empresa.

Maximum string length: 255
registration_number
string | null

Número de registro o de constitución de la empresa.

Maximum string length: 100
country_code
string | null

País de constitución (ISO 3166-1 alfa-2, p. ej., GB, US).

Maximum string length: 10
status
enum<string>
predeterminado:ACTIVE

Estado inicial del ciclo de vida. El valor predeterminado es ACTIVE.

Opciones disponibles:
ACTIVE,
FLAGGED,
BLOCKED
metadata
object | null

Objeto JSON arbitrario que adjuntas a la empresa. Por defecto es {}.

Respuesta

Empresa creada. Se devuelve el registro completo de la empresa (con la misma estructura que Get Business).

Detalle completo de la empresa. Amplía BusinessListItem con los metadatos y updated_at.

didit_internal_id
string<uuid>

UUID interno estable de Didit para esta empresa.

vendor_data
string | null

Tu identificador único de esta empresa (el que se envía al crear sesiones). Puede ser null si no se proporcionó ningún identificador propio.

display_name
string | null

Nombre visible personalizado que has definido

Razón social oficial obtenida del registro o introducida manualmente

registration_number
string | null

Número de registro o de constitución de la empresa

country_code
string | null

País de constitución (ISO 3166-1 alfa-2, p. ej., GB, US).

effective_name
string | null

Mejor nombre disponible: display_name si está definido; si no, legal_name

status
enum<string>

Estado del ciclo de vida del registro de la empresa (NO es un estado de sesión). ACTIVE es el valor predeterminado, FLAGGED lo marca para atención manual y BLOCKED impide nuevas sesiones para este vendor_data.

Opciones disponibles:
ACTIVE,
FLAGGED,
BLOCKED
session_count
integer

Número total de sesiones de verificación de esta empresa

approved_count
integer

Número de sesiones aprobadas

declined_count
integer

Número de sesiones rechazadas

in_review_count
integer

Número de sesiones en revisión

features
object

Estado agregado por función de todas las sesiones KYB de esta empresa. Actualmente la única clave es KYB (el estado de la comprobación de la empresa en el registro). Valores posibles: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Los mismos datos que features, como un array ordenado de objetos {feature, status}.

last_session_at
string<date-time> | null

Marca de tiempo de la sesión más reciente

first_session_at
string<date-time> | null

Marca de tiempo de la primera sesión

last_activity_at
string<date-time> | null

Marca de tiempo de la actividad más reciente (cambio de estado, actualización de la sesión, etc.)

tags
object[]

Etiquetas asignadas a esta empresa

created_at
string<date-time>
metadata
object

JSON de metadatos personalizados que adjuntaste a esta empresa. Valor predeterminado: {}.

updated_at
string<date-time>
Última modificación el 1 de noviembre de 2026