Sesiones y estados

Una sesión es una verificación de un solicitante. La creas tú, la completa el solicitante, la decide un revisor y tú recibes el aviso.

Estados

Estado	Significado
`created`	El enlace existe y aún no se ha abierto
`in_progress`	El solicitante empezó el flujo
`submitted`	El solicitante envió todo; espera a un revisor
`in_review`	Un revisor la ha reclamado
`approved`	Decisión final: aprobada
`rejected`	Decisión final: rechazada, con motivos
`resubmission_requested`	El revisor pidió algunos elementos de nuevo; el mismo enlace vuelve a funcionar
`expired`	No se completó a tiempo (los enlaces duran 7 días)
`cancelled`	La cancelaste antes de que se enviara

approved y rejected son decisiones finales. Un revisor responsable aún puede cambiar una decisión durante 72 horas; recibes un webhook session.decision_changed cuando ocurre.

Reenvíos

Cuando algo falla pero se puede corregir (una foto borrosa, un justificante antiguo), el revisor pide los elementos concretos. El estado pasa a resubmission_requested, se indica al solicitante qué repetir y la sesión vuelve a submitted tras la nueva subida. El número de rondas está limitado por flujo.

Qué recibes

GET /api/v1/sessions/{id} devuelve el estado, decision, reason_codes, el resultado según el detalle del resultado del flujo, los nombres de las alertas automáticas, la cronología y media_purge_at, la fecha en que se borran fotos y vídeos. Los archivos nunca van en la API ni en los webhooks; propietarios, administradores y miembros los ven en el panel hasta la fecha de borrado, y cada visualización queda auditada.

Facturación

Una sesión real cuenta una vez, al llegar a su primera decisión final. No cuentan las sesiones de prueba, caducadas, canceladas ni abandonadas, ni las peticiones de reenvío ni los cambios de decisión.

Caducidad y limpieza

Los enlaces caducan a los 7 días; a quienes no han empezado se les recuerda a las 24 y 72 horas (solo invitaciones).
Los archivos de sesiones abandonadas se borran a las 72 horas.
Las sesiones de prueba se borran 24 horas después de su última actividad.
Para borrar una verificación ya (solicitud de un interesado) usa el panel o DELETE /api/v1/sessions/{id}; recibes un webhook session.erased sin datos personales.