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.
¿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. |
| 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.
Sesiones inválidas
Existen varias razones para que una sesión termine en estado NOT VALIDATED. En cada uno de estos casos, desde Dashboard te mostraremos un mensaje de error con el detalle de qué sucedió y te informaremos el ID de la sesión para que puedas corroborar el step que falló. También podrás obtener información de la sesión vía API.
Motivos posibles
| ID del estado | Mensaje de error | Step | Descripción |
|---|---|---|---|
| ID_ALREADY_VALIDATED | User with specified identification type and value already exists in Users Api | - | El documento ya fue registrado por otro usuario. |
| MISSING_BIRTHDATE | User’s birthday is missing and we couldn’t determine if is an adult | - | No es posible corroborar la fecha de nacimiento y por lo tanto no podemos determinar que sea mayor de edad. |
| UNDERAGE_USER | User is underage | - | El usuario es menor de edad. |
| ID_MATCH_FAILED | Failed to validate ID | Coincidencia selfie / documento | La foto del documento y el mapa facial de la prueba de vida tienen un nivel de coincidencia bajo, la persona que lo realizó no era la misma o la foto del documento no es lo suficientemente clara. |
| ID_NOT_SUPPORTED | ID not supported | Coincidencia selfie / documento | El usuario usa un tipo de documento que no soportamos. |
| OCR_CHECK_FAILED | Failed to check OCR | OCR | El OCR tiene problemas para corroborar la información del documento de la persona. |
| SELFIE_FAILED | Failed to validate selfie | Prueba de vida | No fue posible detectar la presencia en tiempo real del usuario durante la prueba de vida. Este estado sucede sólo en el flujo web. |
| FACE_COULD_NOT_SATISFY_WIDTH | The face does not match the required width | Prueba de vida | El ancho del encuadre del rostro no fue correcto. Este estado sucede sólo en el flujo API. |
| FACE_COULD_NOT_SATISFY_HEIGHT | The face does not match the required height | Prueba de vida | El alto del encuadre del rostro no fue correcto. Este estado sucede sólo en el flujo API. |
| PHOTO_HAS_POOR_QUALITY | Photo was taken with low quality | Prueba de vida | La foto es de baja calidad. Este estado sucede sólo en el flujo API. |
| PERSON_IS_NOT_LOOKING_STRAIGHT | The person is leaning to one side | Prueba de vida | La persona no miró a la cámara al momento de la foto. Este estado sucede sólo en el flujo API. |
| NO_PERSON_WAS_DETECTED | No person was detected in the photo | Prueba de vida | No detectamos ninguna persona en la foto. Este estado sucede sólo en el flujo API. |
| PERSON_HAS_FORBIDDEN_ACCESORIES | The person has forbidden accessories | Prueba de vida | La persona tiene accesorios que no permiten validar su rostro. Este estado sucede sólo en el flujo API. |
| MULTIPLE_FACES_DETECTED | Multiple faces were detected | Prueba de vida | Detectamos más de un rostro en la foto. Este estado sucede sólo en el flujo API. |
| DATA_CHECK_FAILED | Failed to validate data in governmental provider | Validación de datos | No logramos validar los datos con la información que se obtuvo en el paso del OCR por un ente gubernamental. |
| DECEASED_USER | User is declared as deceased | Validación de datos | El ente gubernamental con el cual validamos la información del usuario nos devuelve que el usuario falleció. |
| EXCLUSION_CHECK_FAILED | Failed to validate user in exclusion check | Validación de riesgo | El chequeo a nivel AML (anti money laundering) obtiene algún resultado positivo para la persona que está realizando el flujo. |
| PERSON_NOT_FOUND | Person not found | Validación de datos | No encontramos información del usuario en las bases de datos gubernamentales. |
| CPF_IRREGULAR_SITUATION | CPF irregular situation | Validación de datos | El CPF existe, pero está suspendido, cancelado o nulo. |
| PARTIAL_NAME | Partial name | Validación de datos | El nombre está incompleto. |
| DIVERGENT_NAME | Divergent name | Validación de datos | El nombre no coincide con la información de las bases de datos gubernamentales. |
| BIRTHDATE_NOT_AVAILABLE | Birthdate not available | Validación de datos | No es posible validar la fecha de nacimiento en las bases de datos gubernamentales. |
| DIVERGENT_BIRTHDATE | Divergent birthdate | Validación de datos | La fecha de nacimiento no coincide con la información de las bases de datos gubernamentales. |
| SELFIE_DOESNT_MATCH | User selfie doesn’t match with governmental database | Validación de foto | No logramos validar la selfie que se obtuvo en el paso de Prueba de Vida por un ente gubernamental. |
| SELFIE_NOT_AVAILABLE | User selfie isn’t available in governmental database | Validación de foto | La selfie que se obtuvo en el paso de Prueba de Vida no se encuentra en la base de del ente gubernamental. |
| DOCUMENT_MISMATCH | Images are not from the same type to analyze | Document match | La foto del frente y del dorso del documento no son de la misma persona. |
| IS_PEP | The user declared to be PEP | Data enrichment | Tu cliente declara ser una persona expuesta políticamente. |
| IS_SO | The user declared to be SO | Data enrichment | Tu cliente declara ser sujeto obligado. |
| OCR_CHECK_MISSING | Failed to check OCR | OCR | No logramos identificar algún dato obligatorio en las imágenes de MATCH_ID, por ejemplo el número de documento. |
| EXPIRED_DOCUMENT | Expired document | Governmental Check | La fecha de nacimiento informada no coincide con la que obtuvimos en las bases gubernamentales. |
| DIVERGENT_NATIONALITY | Divergent nationality | Governmental Check | La nacionalidad informada no coincide con la que obtuvimos en las bases gubernamentales. |
| DIVERGENT_FISCAL_ID | Divergent fiscal id | Governmental Check | El ID fiscal informado no coincide con el que obtuvimos en las bases gubernamentales. |
| DIVERGENT_DOCUMENT_ID | Divergent document id | Governmental Check | El número de documento informado no coincide con el que obtuvimos en las bases gubernamentales. |
| ID del estado | Mensaje de error | Step | Descripción |
|---|---|---|---|
| CNPJ_INVALID_OR_NOT_COMPLETED | CNPJ is invalid or it is not completed', | Governmental Check Company | El CNPJ ingresado es inválido o está incompleto. |
| CNPJ_NOT_REGISTERED | CNPJ is not registered in governmental provider', | Governmental Check Company | No encontramos el número de CNPJ en los registros gubernamentales. |
| CNPJ_NOT_ACTIVE | CNPJ is not active', | Governmental Check Company | El CNPJ ingresado no está activo. |
| UNABLE_TO_VALIDATE_CPF | Unable to validate CPF', | Governmental Check Company | No pudimos validar el CNPJ ingresado. |
| COMPANY_TYPE_INVALID_OR_NOT_COMPLETED | Juridic person is invalid or it is not completed', | Governmental Check Company | El tipo de compañía es inválida o no está completa. |
| CPF_NOT_MATCH_WITH_CNPJ | CPF does not match with the registered for CNPJ', | Governmental Check Company | El CPF no coincide con el que está registrado para ese CNPJ. |
| CPF_NOT_LOCATED_IN_CNPJ | CPF is not located in CNPJ', | Governmental Check Company | El CPF no se encuentra en el CNPJ |
| CPF_NOT_RELATED_WITH_CNPJ | CPF does not related with the CNPJ', | Governmental Check Company | El CPF no está relacionado con el CNPJ. |
| DIFFERENT_JURIDIC_NATURE | Fiscal Id has a different juridic nature', | Governmental Check Company | El ID fiscal tiene una naturaleza jurídica diferente. |
| PARTNER_SESSION_NOT_VALIDATED | A partner session has not been validated', | Partner Check | Todavía no se validó la identidad de uno de los socios. |
| PARTNER_SESSION_REJECTED | A partner session has been rejected', | Partner Check | La verificación de identidad de uno de los socios fue rechazada. |
| CPF_VALID_PENDING_REGULAR | Valid CPF with status pending regularization', | Governmental Check | - |
| CPF_VALID_NOT_REGULAR_AND_NOT_PENDING_REGULAR | Valid CPF with status different to regular', | Governmental Check | El CPF es válido pero tiene un estado diferente al regular. |
| CPF_VALID_UNDERAGE | CPF owner is underage', | Governmental Check | El CPF corresponde a un menor. |
| CPF_VALID_DEAD_PERSON | CPF owner is declared as deceased', | Governmental Check | El CPF corresponde a una persona muerta. |
| CPF_VALID_NOT_REGISTERED_ON_FEDERAL_PARTNER | CPF not registered', | Governmental Check | El CPF no existe. |
| COMPANY_HAS_COMPANY_AS_PARTNER | A company is not able to have a company as a partner', | Governmental Check Company | No es posible que una compañía sea uno de los socios. |