Primeros pasos
Flujo de verificación de domicilio
Flujo combinado: si este paso forma parte de un recorrido con múltiples verificaciones, los pasos
GET /flow-runs/verifyyPOST /flow-runs/startse ejecutan una sola vez al inicio. Consulta Flujos con múltiples verificaciones.
El flujo de verificación de domicilio cruza la dirección declarada por el usuario contra la geolocalización de su dispositivo. Según la configuración del flujo (askForEvidence), puede requerir o no un comprobante de domicilio.
Variante con comprobante (askForEvidence: true)
El usuario sube un comprobante (factura de servicios, extracto bancario, etc.). El sistema extrae la dirección del documento via OCR y la compara con la ubicación del dispositivo.
Variante sin comprobante (askForEvidence: false)
Solo se recogen los datos de dirección y la geolocalización del dispositivo.
Pasos del flujo
Con comprobante
| Paso | Servicio | Endpoint | Descripción |
|---|---|---|---|
| 1 | Adamo ID API | GET /flow-runs/verify/{invitationToken} | Verifica el token de invitación y obtiene la configuración del flujo |
| 2 | Adamo ID API | POST /flow-runs/start | Inicia la ejecución del flujo y obtiene el authToken y runUuid |
| 3 | Adamo ID API | POST /flow/progress/upload-file | Sube el comprobante (JPEG, PNG o PDF, máx. 5 MB) y obtiene fileId y fileUrl |
| 4 | Queue Service | POST /address/validate-document | Verifica que el documento tiene datos de dirección extraíbles via OCR |
| 5 | Queue Service | POST /address/address-verification | Envía los datos de dirección con referencia al comprobante; el procesamiento continúa en background |
Sin comprobante
| Paso | Servicio | Endpoint | Descripción |
|---|---|---|---|
| 1 | Adamo ID API | GET /flow-runs/verify/{invitationToken} | Verifica el token de invitación y obtiene la configuración del flujo |
| 2 | Adamo ID API | POST /flow-runs/start | Inicia la ejecución del flujo y obtiene el authToken y runUuid |
| 3 | Queue Service | POST /address/address-verification | Envía los datos de dirección sin comprobante; el procesamiento continúa en background |
Notas
- Los pasos 1 y 2 son comunes a todos los flujos de verificación.
- Si
POST /address/validate-documentdevuelveisValid: false, se debe pedir al usuario un documento diferente antes de continuar. POST /address/address-verificationresponde de forma inmediata. El análisis (geocodificación, cálculo de distancias y OCR) ocurre en background.- La variante activa se determina por el campo
config.askForEvidencedel pasoaddressen la respuesta deGET /flow-runs/verify/{invitationToken}.
Last modified on