Introducción

Auvral verifica que la persona que se registra en tu producto es quien dice ser.

Integras tres cosas:

1. Una llamada a la API desde tu backend, POST /v1/sessions, que devuelve una URL para un usuario, una vez.
2. El flujo alojado, abierto en esa URL. Ya sea integrado con el SDK web o abierto como un enlace normal. Tú no construyes la experiencia de captura.
3. Un endpoint de webhook, que es como te enteras de lo que pasó. Ver Webhooks.

El proceso de verificación de identidad

Tu usuario fotografía su documento de identidad y se toma una selfie. Auvral corre su proceso de verificación de identidad sobre esas entradas y devuelve un veredicto: verificado o rechazado.

Ese es todo el contrato. Tu backend nunca maneja una imagen, un número de documento ni un rostro. Crea una sesión y, más adelante, recibe un webhook firmado.

La URL es para una sola persona y expira rápido. Crea la sesión en el momento en que estás a punto de mostrarla, no en lote y por adelantado. No la reenvíes, no la compartas y no la reutilices con un segundo usuario.

Identificar a tu usuario

Dos valores vuelven en cada webhook:

• sessionId, devuelto cuando creas la sesión. Guárdalo junto a tu usuario.
• referenceId, tu propio identificador de la persona (normalmente el id de usuario que manejas tú). Auvral lo guarda y te lo devuelve intacto, y si no envías ninguno te asigna uno.

Cualquiera de los dos te dice a cuál de tus usuarios pertenece un evento.

Ambientes

Cada organización tiene dos llaves de API, y la llave es lo único que selecciona un ambiente:

No hay ningún parámetro environment en ninguna parte. Ver Autenticación.

Leer desde tu backend

Dos lecturas completan la superficie, las dos con tu llave de API:

• GET /v1/sessions/{sessionId}: hasta dónde llegó una sesión, en cinco valores. Sigue respondiendo después de que la sesión expira, reconstruida a partir de la verificación.
• GET /v1/verifications/{id}: el estado, los tiempos, tu referenceId y tu metadata de una verificación.

Son para reconciliar, no para esperar. Los webhooks siguen siendo la forma en que tu backend se entera de un resultado: haz que tu manejador de webhooks sea el lugar donde cambia el estado de tu negocio, y hazlo idempotente. Después usa estas lecturas cuando falte una entrega, cuando un barrido nocturno encuentre una sesión de la que nunca supiste, o cuando soporte pregunte por un usuario. Nada llega antes porque preguntes en un bucle.

Siguiente

• Inicio rápido: un usuario de prueba verificado en unos diez minutos.
• Autenticación: de dónde salen las llaves y cómo rotarlas.
• SDK web: integrar el flujo en tu página.