Saltar al contenido principal
PATCH
curl

Descripción general

Cambia una entidad empresarial entre ACTIVE, FLAGGED y BLOCKED. Consulta el ciclo de vida de las entidades para ver la máquina de estados completa.

Cuándo usarlo

  • Bloquear una empresa sancionada o con fraude confirmado.
  • Marcar una empresa pendiente de revisión manual.
  • Desbloquear después de la remediación.
  • Propagar señales externas desde tus propios sistemas de cumplimiento.

Notas

  • Valores válidos: ACTIVE, FLAGGED, BLOCKED.
  • Pasa un reason opcional (hasta 1000 caracteres) para registrar por qué cambió el estado. Didit lo guarda en la entrada del cambio de estado en la Activity de la empresa en Business Console. Solo se registra cuando el estado cambia realmente.
  • Las empresas en estado BLOCKED tienen todas las nuevas sesiones de Verificación de empresas (KYB) rechazadas automáticamente y todas las nuevas transacciones rechazadas automáticamente, incluso cuando aparecen como contraparte.
  • Emite business.status.updated con previous_status y status. El webhook no incluye reason.

Aplicación

Permisos

El secreto principal y las claves de API con acceso completo siempre pueden invocar este endpoint. Una clave con acceso personalizado necesita permiso de escritura en Empresas (businesses). Una clave limitada a algunos flujos o a sesiones aprobadas no puede acceder a este endpoint. Los roles y permisos de la Console deciden lo que un miembro del equipo puede hacer en la Console. No se evalúan en las solicitudes con clave de API.

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.

Parámetros de ruta

vendor_data
string
requerido

Tu identificador único de la empresa (cadena de texto libre, NO un UUID).

Cuerpo

application/json
status
enum<string>
requerido

Nuevo estado del ciclo de vida. BLOCKED también añade el vendor_data a la lista de bloqueo del sistema.

Opciones disponibles:
ACTIVE,
FLAGGED,
BLOCKED
reason
string | null

Por qué cambió el estado. Se registra en la entrada de cambio de estado de Activity de la empresa en Business Console, solo cuando el estado cambia realmente. Los webhooks no lo incluyen.

Maximum string length: 1000

Respuesta

Estado de la empresa actualizado. Se devuelve el registro completo de la empresa.

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