Saltar al contenido principal
La Business Console permite a tu equipo gestionar entidades User de forma masiva sin escribir código. Se admiten dos flujos: importación CSV (crear o actualizar usuarios a escala) y exportación CSV (extraer la tabla de usuarios para herramientas externas).
La importación y exportación masivas descritas aquí solo crean o actualizan perfiles de User. No recrea sesiones KYC históricas, advertencias de documentos, evidencias de detección de vida ni decisiones de proveedores. Para una migración completa desde Sumsub, MetaMap, Veriff, Onfido, Persona u otro proveedor, consulta Importar datos desde otro proveedor.

​
Importar usuarios desde CSV

​
Cuándo usarla

  • Migración inicial desde otro proveedor de KYC: trae tu lista de usuarios existente.
  • Migración de rostros desde otro proveedor: adjunta imágenes faciales de confianza a los perfiles de User importados una vez creadas las filas.
  • Onboarding masivo de la lista de clientes de un socio.
  • Carga retroactiva de metadatos: actualiza etiquetas, nivel o identificadores internos de muchos usuarios a la vez.

​
Columnas de la plantilla

Descarga la plantilla desde Users → Import → Download template. Columnas:

​
Ejecutar la importación

1

Sube el CSV

Ve a Users → Import → Upload CSV y selecciona tu archivo.
2

Revisa la vista previa

La consola valida cada fila. Las filas no válidas se resaltan con el motivo del error (p. ej., vendor_data duplicado o código de país no válido).
3

Inicia la importación

Didit procesa las filas de forma asíncrona. Puedes cerrar la pestaña: el progreso se registra en Users → Import history.
4

Revisa los resultados

Cuando termina la importación, la vista del historial muestra el número de filas creadas, actualizadas y omitidas, además de un informe de errores descargable.

​
Actualizar o crear

  • Si un vendor_data no existe, se crea un nuevo User.
  • Si un vendor_data ya existe, la fila actualiza el User existente (campos del perfil y metadatos).
  • Los contadores agregados y los campos verificados (full_name, date_of_birth de sesiones aprobadas) nunca se sobrescriben con las importaciones.

​
Importar rostros después de crear el usuario

La importación CSV crea o actualiza la fila del User. No incluye imágenes faciales en el CSV. Para traer los datos biométricos faciales desde otro proveedor, sube cada rostro cuando el User de destino ya exista:
1

Crea o importa el User

Usa la importación CSV de la consola o invoca la API a través de POST /v3/users/create/ en un bucle.
2

Lee didit_internal_id

Obtén el User con GET /v3/users/{vendor_data}/. La respuesta incluye didit_internal_id.
3

Sube el rostro

Invoca la API a través de POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/ con una imagen facial en base64 sin procesar.
El rostro debe ser una imagen válida, de 2 MB como máximo una vez decodificada, y contener un rostro detectable. Didit lo guarda en el perfil y lo indexa para la detección de duplicados y la búsqueda facial. No se añade a una lista de bloqueo de rostros a menos que uses por separado el endpoint Subir rostro a una lista.

​
Exportar usuarios a CSV

​
Cuándo usarla

  • Auditorías de cumplimiento: entrega la tabla completa de usuarios a los auditores.
  • Sincronización con el almacén de datos: volcado periódico en tus herramientas de BI.
  • Solicitudes de SAR o de reguladores: extrae subconjuntos filtrados de usuarios.

​
Ejecutar una exportación

  1. Ve a Users → Export.
  2. Aplica filtros (estado, país, rango de fechas, búsqueda).
  3. Elige las columnas (de forma predeterminada se incluyen todos los campos; puedes quitar las que no necesites).
  4. Envía la solicitud. Didit genera la exportación de forma asíncrona y envía por correo electrónico un enlace de descarga firmado al operador que la solicitó.
Las exportaciones solo incluyen los datos que tu rol puede leer. COMPLIANCE_OFFICER y los roles superiores pueden exportar la tabla completa; los roles DEVELOPER y READER tienen exportaciones restringidas.

​
Características de rendimiento

​
Registro de actividad

Cada importación y exportación queda registrada en el registro de auditoría:
  • El operador que la inició.
  • Número de filas (importaciones) o instantánea de los filtros (exportaciones).
  • Marcas de tiempo y estado de éxito o fallo.

​
Próximos pasos

API para crear usuarios

Creación programática para importaciones mediante scripts.

Subir el rostro del usuario

Adjunta imágenes faciales importadas a los perfiles de usuario.

Retención de datos

Cuánto tiempo se conservan los datos importados.

Registros de auditoría

Revisa el historial de importaciones y exportaciones.
Última modificación el 1 de noviembre de 2026