Autentícate con tu X-API-Key de tenant. FinPay resuelve el espacio de trabajo desde esa clave y luego crea una sesión de verificación para ese espacio de trabajo. Si se omite workflow_id (o está vacío) en el cuerpo JSON, el servidor usa el flujo predeterminado del tenant configurado en ese espacio de trabajo (no un valor global). Los campos opcionales del cuerpo incluyen callback, metadata y opciones relacionadas de sesión.
Devuelve un verification_url alojado cuando se crea la sesión.
Al crear una sesión con un flujo de Autenticación biométrica, incluye portrait_image como una imagen facial de referencia codificada en base64 para el usuario enrolado. Sin este campo, la verificación solo puede ejecutar prueba de vida, por lo que FinPay rechaza creaciones de autenticación biométrica cuando puede identificar que el flujo seleccionado requiere entrada para comparación facial.
Cada llamada crea una sesión nueva. Envía un valor vendor_data distinto cuando quieras correlacionar sesiones con tu propio usuario o id de orden (reutilizar el mismo vendor_data puede vincular sesiones para ese identificador). Omite vendor_data para verificaciones independientes de una sola vez.
El encabezado opcional Idempotency-Key evita sesiones duplicadas causadas por reintentos de red (no reutilices la misma clave en creaciones diferentes).