Sessions and states
Discover what an identity validation session is, the stages of the process, and their different states.
What is an identity validation session?
To verify someone's identity, it is necessary to complete the KYC process, and for validating a company, we use the KYB verification.
When starting either of these two processes, a new identity validation session is created, where all the information from that verification will be stored. In other words, sessions are the main entity in Identity.
The main objectives of this solution are:
- Collect all necessary data and documents.
- Verify the authenticity of all that information.
- Compare the data to prevent illegal activities, such as money laundering, terrorist financing, and fraud.
How is an identity validation session composed?
Each session is composed of several steps, which are different stages in the verification process. Each step indicates one of the various checks we perform to carry out a verification.
The steps vary between validating a user or a company:
KYC | KYB |
---|---|
T&C acceptance | T&C acceptance |
Proof of life | Form completed |
Selfie / document match | Company validation |
OCR | Partner validation |
Form completed | Document validation |
Data validation | Risk validation |
Photo validation | - |
Risk validation | - |
What states can steps have?
The state of the session is determined by the state of the steps. The steps have their own state and, all these states together define the overall state of the session. The states of the steps are as follows:
PENDING | Indicates that there are pending steps or information in the validation process. |
SUCCESS | Indicates that the client successfully completed the step. |
PROCESSING | Indicates that we are waiting for a response from our provider. |
FAILED | Indicates that the client did not complete the step correctly. |
NOT AVAILABLE | Indicates that we cannot access one of the services we use. |
SUCCESS
state.
What is the state of a session?
There are two types of session states:
- Temporary states: these show the progress of the session.
- Terminal states: these are the states where a session is finished, with no possibility of going back.
In this graph, you can see the states that a session goes through and its possible final states.
What state can a session have?
As the steps progress, the session will go through different states:
CREATED | Initial state indicating that a new validation session was created. |
IN PROGRESS | Indicates that the user started the identity validation process. The change from CREATED to IN PROGRESS occurs when your client takes the first action in the flow. |
PROCESSING | This is a transitory state that is activated when we are waiting for information to perform verifications asynchronously or when a provider is experiencing delays. This state allows you to provide your users with a more contextualized and timely message. |
MANUAL REVIEW | Indicates that at least one step in the flow requires manual review, as it cannot be resolved automatically. KYB sessions will always undergo manual review so that we can validate the documentation of the legal entity. |
REJECTED | Indicates that after a thorough analysis, it was determined that the session does not meet the validation criteria. Once this state is confirmed, a new session cannot be created for the same user or company. |
NOT VALIDATED | Indicates that we could not validate one or more steps in the flow, preventing the confirmation of the user's identity. In this case, you can recreate another session for the same user or company. Learn about the failure reasons that can cause this state. |
VERIFIED | Indicates that all steps of the session have been validated. |
EXPIRED | Indicates that the session cannot be carried out because the established time to access the flow has expired. |
CANCELLED | Indicates that the session cannot be carried out for one of the following reasons: - Se creó una nueva sesión para el mismo usuario. A new session was created for the same user. In that case, the previous session is set to the CANCELLED state, and your client continues the flow in the new session.- You decide to cancel the session for security or fraud prevention reasons. |