Onboarding with Incode is a modular and fully configurable way to run an identity verification session in three well-defined moments:

1. Setup and integrate Incode. You can select from 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.
2. Create and execute Onboarding Sessions. Depending on the integration type, this is where you collect data from end users and validate that data in your application. The result is a calculated identity verification score.
3. Fetch data and validation results. Once a user finishes an Onboarding Session (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 Onboarding Session is the core entity of onboarding with Incode. It is linked to all user data, images, scores, and events by a unique identifier called the Session ID or interviewId.

Session ID or interviewId

The Session ID or interviewId is an alphanumeric string that uniquely identifies a specific Onboarding Session. This identifier links all collected data, images, documents, scores, events, and metadata from an Onboarding Session. The Session ID 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 conversation and in the context of the Incode Omni Dashboard. Both terms refer to the same identifier.

Create an Onboarding Session

Depending on the type of integration, Onboarding Sessions can be created:

• Using Incode Workflows (recommended) or Flows (legacy). These each provide a URL for an out-of-the-box web application. Compare their differences to determine which method is best for your use case.
• Using the Incode Omni API.

Onboarding Session metadata

Incode collects a set of metadata for each Onboarding Session. You can also add custom metadata to an Onboarding Session:

• External Customer Id: This identifier is a string value that links the Onboarding Session to an entity in an external system that is not part of the Incode Omni Platform. It could represent a prospect or customer Id from your database, providing a bridge between the Incode Onboarding Session and your internal user management systems.
• Custom Fields: These are key-value pairs that allow you to include additional metadata within an Onboarding Session. They offer flexibility in tagging and categorizing sessions with custom data points, which can be later retrieved via API. This facilitates advanced data analysis and session management.

Onboarding attempts

Each onboarding opportunity is called an onboarding attempt. An Incode Onboarding Session is created each time a user attempts the process of onboarding with Incode, regardless of whether the user completed or abandoned the onboarding. A new Session ID/interviewId must be created for each.

These are some considerations about attempts:

• Users can make multiple attempts using the same or different Incode Workflow / Flow.
• Each attempt has its own 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.

Workflows and Flows

Workflows (recommended) and Flows (legacy) show you a visual representation of the business logic for each verification step. Compare their differences to determine which method is best for your use case.

Here, you select and configure the modules used during the Onboarding Session.

Modules

An Incode Module is a specific step within the process of Onboarding with Incode. Each module may have different features, configurations, and verification checks. Modules may generate an individual score or influence the total Onboarding Session score.

OCR data

During an Onboarding Session, Incode extracts data from user-provided documents using optical character recognition (OCR). The extracted data depends on the provided document; for example, a two-sided ID card such as a driver's license or residence ID, as opposed to a one-sided passport.

Images

Three main types of images may be uploaded and linked to an Onboarding Session:

• Images from the front and back (if applicable) of an ID document.
• Selfie images.
• Images of other documents, 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 overall 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.