Incode Onboarding
The Onboarding process is in the Incode Platform Context and its main components
About the process
The Incode Onboarding is a modular and fully configurable way to run an identity verification session in three well-defined moments:
- Setup and integrate Incode. You can select one of three integration types: no-code, low-code, or full SDK/API integration. For each integration type, you configure your identity verification flow step by step, including the behavior of each verification module and how data will be processed.
- Create and execute Onboarding Sessions. Depending on the integration type, this is where end users collect and validate data in your application to calculate an identity verification score.
- Fetch data and validation results. Once a user finishes an identity verification, you can fetch all the collected data, images, and scores to make decisions or continue your onboarding process.
Core concepts
Onboarding Session
An Incode Onboarding Session is the core entity of the Onboarding Process. It is linked to all user data, images, scores, and events by a unique identifier called Session ID or interviewId
.
Session ID or interviewId
interviewId
The interviewId
or Session ID is an alphanumeric string to uniquely identify the Onboarding Session.
This identifier will link all collected data, images, documents, scores, events, and metadata from the Onboarding Session and represents one person's identity verification process.
The term "interviewId
" is used primarily as a programming term, for example, as a parameter for an endpoint request of the Incode Omni API. "Session ID" is more often used in the context of the Incode Omni Dashboard. Both terms refer to the same identifier.
Onboarding Attempt
An Incode Onboarding Session is created each time a user goes through a new process, regardless of whether the user completed or abandoned the onboarding. This means a new interviewId
must be created for each process.
Each onboarding opportunity is called an Onboarding Attempt. These are some considerations about attempts:
- Users can make multiple attempts using the same or different Incode Flow / Workflow.
- Each attempt has its score. This means the same person may have a different result for each attempt.
- Different Onboarding attempts may be "linked" to one person by an
externalCustomerId
.
Onboarding Session Metadata
You can add metadata to an onboarding session using one of two methods:
- External Customer Id: A string value to store a unique identifier from an external system. For example, a user ID from your system.
- Custom Fields: A set of key-value pairs to associate metadata (strings, numbers, and boolean values) to an onboarding session.
How to create an Onboarding session
Depending on the type of integration, onboarding sessions can be created:
- Using Incode Flows and Workflows by providing the user a URL for an out-of-the-box web application.
- Using the Incode Omni API.
Verification Modules
An Incode Verification Module ↗ is a specific step within the onboarding process. Each module may have different features and verifications, and depending on the module, this may generate a Score or Influence the total Onboarding Score.
Flows and Workflows
The visual representation of the business logic for each verification step. Here, you select and configure the modules executed during the Onboarding. Learn more about Incode Workflows.
OCR Data
All the data extracted by OCR from the documents provided by the user during the onboarding process. The resulting data depends on the provided document, for example, a two-sided ID card such as a driver's license, a residence ID, or a one-side passport.
Images
Document and face images ("selfies") are uploaded and linked to the Onboarding Session. There are three main types of images:
- Images from the front and back (if applicable) of an ID document.
- Selfie images.
- Other document images, such as Proof of Address documents.
An Onboarding session may have more than one image of the same type.
Scores
These are the resulting values and status calculated for each verification module and for the Onboarding Session. The scoring system determines whether the user's data is approved, rejected, or subject to manual review.
Onboarding Session Lifecycle
The Incode Onboarding Session Lifecycle describes how the Session changes from creation to completion and all the statuses involved. Learn more about the Onboarding Session Lifecycle and how to use it in your integrations.

Updated 5 days ago