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:

KYCKYB
Aceptación de TyCAceptación de TyC
Prueba de vidaFormulario completo
Coincidencia selfie / documentoValidación de empresa
OCRValidación de socios
Formulario de datosValidación de documentación
Validación de datosValidació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:

PENDINGIndica que hay steps o información pendiente en el proceso de validación.
SUCCESSIndica que el cliente completó con éxito el step.
PROCESSINGIndica que estamos esperando respuesta de nuestro proveedor.
FAILEDIndica que el cliente no completó correctamente el step.
NOT AVAILABLEIndica 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:

CREATEDEstado inicial que indica que se creó una nueva sesión de validación.
IN PROGRESSIndica 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.
PROCESSINGSe 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 REVIEWIndica 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.
REJECTEDIndica 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 VALIDATEDIndica 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.
VERIFIEDIndica que validamos todos los steps de la sesión.
EXPIREDIndica que no se puede realizar la sesión porque se cumplió el tiempo establecido para acceder al flujo.
CANCELLEDIndica 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.
Luego de crear una sesión, recibirás notificaciones sobre las transiciones y cambios de estado, a través de webhooks en un endpoint que puedes configurar en el proceso de integración. También puedes obtener información de la sesión a través de la API.

¿Te resultó útil el contenido de esta documentación?