Flujos con múltiples verificaciones
Cuando un flujo incluye más de una verificación (por ejemplo: identidad + prueba de vida + domicilio), los pasos de inicialización del recorrido se ejecutan una sola vez, al comienzo. El authToken y el runUuid obtenidos en ese momento se reutilizan en todas las verificaciones posteriores.
Cada página de flujo documenta los pasos de verificación + token de forma independiente para facilitar su consulta. En una integración real con múltiples pasos,
GET /flow-runs/verifyyPOST /flow-runs/startsolo se llaman una vez.
Pasos de inicialización (se ejecutan una sola vez)
| Paso | Endpoint | Descripción |
|---|---|---|
| 1 | GET /flow-runs/verify/{invitationToken} | Valida el token de invitación y obtiene validationSequence con los pasos requeridos |
| 2 | POST /flow-runs/start | Inicia el recorrido y devuelve authToken, runUuid y currentStep |
El campo validationSequence de la respuesta del paso 1 indica el orden y el tipo de cada verificación que debe completarse.
Ejemplo: identidad + prueba de vida + domicilio
Consideraciones importantes
El req_id se comparte entre identidad y prueba de vida
El req_id creado en el paso de verificación de identidad (POST /req/new) es reutilizado automáticamente en el paso de prueba de vida cuando ambos se ejecutan en el mismo recorrido. No es necesario crear una nueva sesión GPU.
El authToken es válido durante todo el recorrido
El authToken obtenido en POST /flow-runs/start autoriza todas las llamadas al Queue Service y a la Adamo ID API durante el recorrido completo. No caduca entre pasos.
El orden de los pasos lo define validationSequence
La respuesta de GET /flow-runs/verify incluye el campo validationSequence, un arreglo que lista las verificaciones requeridas en el orden en que deben completarse. Úsalo para determinar dinámicamente qué pantallas o pasos mostrar al usuario.
Code