Sesiones y estados

Descubre qué es una sesión de validación de identidad, cuáles son las etapas del proceso y sus diferentes estados.

¿Qué es una sesión de validación de la identidad?

Para verificar la identidad de una persona es necesario completar el proceso de KYC y para validar una empresa utilizamos la verificación KYB.

Al comenzar alguno de estos dos procesos, se crea una nueva sesión de validación de identidad, que es donde almacenaremos toda la información de esa verificación. En otras palabras, las sesiones son la entidad principal de Identity.

El objetivo principal de esta solución es:

Recopilar todos los datos y documentos necesarios.
Verificar la autenticidad de toda esa información.
Confrontar los datos para prevenir actividades ilegales, como lavado de dinero, financiación al terrorismo y fraude.

¿Cómo se compone una sesión?

Cada sesión esta compuesta por varios steps, es decir, distintas etapas en el proceso de comprobación. Cada uno indica alguno de los diferentes chequeos que se realizan para realizar una verificación.

Los steps varían entre el proceso de validación de un usuario o una compañía:

KYC	KYB
Aceptación de TyC	Aceptación de TyC
Prueba de vida	Formulario completo
Coincidencia selfie / documento	Validación de empresa
OCR	Validación de socios
Formulario de datos	Validación de documentación
Validación de datos	Validación de riesgo
Validación de foto	-
Validación de riesgo	-

¿Qué estado pueden tener los steps?

El estado de la sesión es determinado por el estado de los steps. Los steps tienen su propio estado y, todos esos estados en conjunto, definen el estado general de la sesión. Los estados de los steps son los siguientes:


PENDING	Indica que hay steps o información pendiente en el proceso de validación.
SUCCESS	Indica que el cliente completó con éxito el step.
PROCESSING	Indica que estamos esperando respuesta de nuestro proveedor.
FAILED	Indica que el cliente no completó correctamente el step.
NOT AVAILABLE	Indica que no podemos acceder a alguno de los servicios que usamos.

Para que la sesión sea válida, todos los steps deben estar en estado SUCCESS.

¿Qué es el estado de una sesión?

Existen dos tipos de estados de la sesión:

Estados temporales: son los que muestran el progreso de la sesión.
Estados terminales: son en los que una sesión se encuentra finalizada, sin posibilidad de vuelta atrás.

En este gráfico puedes ver los estados que atraviesa una sesión y sus posibles estados finales.

Modelo de estados

¿Qué estado puede tener una sesión?

A medida que los steps progresan, la sesión pasará por distintos estados:


CREATED	Estado inicial que indica que se creó una nueva sesión de validación.
IN PROGRESS	Indica que el usuario comenzó el proceso de validación de identidad. El cambio de `CREATED` a `IN PROGRESS` ocurre cuando tu cliente realiza la primera acción en el flujo.
PROCESSING	Se trata de un estado transitorio que se activa cuando aguardamos información para ejecutar verificaciones de forma asincrónica o cuando algún proveedor presenta demoras. Este estado les permite brindar a sus usuarios un mensaje más contextualizado y oportuno.
MANUAL REVIEW	Indica que al menos un step del flujo requiere revisión manual, ya que no se puede resolver automáticamente. Las sesiones de KYB siempre tendrán una revisión manual para que podamos validar la documentación de la persona jurídica.
REJECTED	Indica que después de un análisis exhaustivo se determinó que la sesión no cumple con los criterios de validación. Una vez confirmado este estado, no se permitirá la creación de una nueva sesión para el mismo usuario o compañía.
NOT VALIDATED	Indica que no pudimos validar uno o más steps del flujo, lo que impide confirmar la identidad del usuario. En este caso, puedes volver a crear otra sesión para el mismo usuario o compañía. Conoce las razones de fallo que pueden provocar este estado.
VERIFIED	Indica que validamos todos los steps de la sesión.
EXPIRED	Indica que no se puede realizar la sesión porque se cumplió el tiempo establecido para acceder al flujo.
CANCELLED	Indica que la sesión no se puede realizar por alguno de los siguientes motivos: - Se creó una nueva sesión para el mismo usuario. En ese caso la sesión anterior pasa a estado `CANCELLED` y tu cliente continúa el flujo en la nueva sesión. - Decides cancelar la sesión por motivos de seguridad o prevención de fraude.

Un usuario puede tener varias sesiones asociadas a lo largo del tiempo, pero solo puede tener una sesión en estado temporal a la vez. Cada sesión cuenta con un código único de referencia, puedes encontrar un ejemplo en nuestro API Reference.