Fill in business onboarding form

Table of Contents

1 Introduction
2 Workflow
3 Fill in business onboarding form steps
- 3.1 Actors
- 3.2 Steps

Introduction

This documentation will guide you through the process of filling in the business onboarding (KYB) form. This flow is a part of any of the possible integrations - manual, partial or full.

Workflow

Fill in business onboarding form steps

Actors

User - user of the client who fills in the business onboarding form.
Ondato - Ondato backend processes that happen when user interacts with the business onboarding form.

Steps

| Configuration
| Step was unsuccessful, flow stopped
| Step was successful, flow continues

	Step	Actor	Description

	Step	Actor	Description
1	Open the business onboarding form url	User	The user's url is provided by the client, and it can be either static or dynamic depending on the type of integration. For more details, please refer to the following documentation: Business onboarding with static URL Business onboarding full integration
2	Check if consent form must be displayed	Ondato	This step is configurable. A check is performed if a consent form must be displayed for the identifications of the client users. Default for every client is that the consent in displayed. → If consent form must be displayed then flow continues with step #3. → If consent form must NOT be displayed then flow continues with the step #6.
3	Display consent form	Ondato	If based on configuration in step #2 user has to see consent form that it’s displayed with options to either “Agree” or “Disagree”.
4	Disagree with the consent	User	If user disagrees with terms and conditions then the flow stops. User is redirected to a configured url.
5	Agree with the consent	User	If user agrees with terms and conditions then the process continues with step #6.
6	Check if company’s registries must be checked	Ondato	This step is configurable. A check is performed if registries must be checked for the identifications of the client users. → If registries check must be performed then flow continues with step #7. → if registries check must nor be performed then flow continues with step #9.
7	Display authentication form	Ondato	Authentication form is displayed with the following fields: Authentication method selection, e.g. Smart-ID, Mobile-ID, e-ID. Fields to enter the following information: Personal code. Company code. Phone number (optional, depends on the authentication method selected)
8	Fill in authentication details	User	Depending on the selected authentication method, the user performs the authentication process.
9	Start person authentication process	Ondato	Once user fills in required data then authentication is performed. → If authentication is successful then flow continues with step #11. → If authentication was NOT successful then flow continues with step #10.
10	Display error message	User	The process stops.
11	Check if person is company’s legal representative	Ondato	A check is performed in the registries if a person is companies representative. → If person does have a right to represent the company then the flow continues with step #13. → If person does NOT have a right to represent the company then flow continues with step #12.
12	Display error message	Ondato	The process stops.
13	Display the business onboarding form	Ondato	Business onboarding form is displayed.
14	Check if form must be displayed	Ondato	This step is configurable. The check is performed only if user has successfully authenticated in step #9 and is a legal company’s representative (step #11). → If pre-fill option is turned on then flow continues with step #15. → If pre-fill option is tuned off then flow continues with step #16.
15	Pre-fill business onboarding form	Ondato	The business onboarding form can be pre-filled with data retrieved from the registries. Following data can be pre-filled: Representative: Full name First name Last name Personal code Birth date State Position Address: Full address Country Flat number House number City Street Post code Company: Code Name Registered date Type Status Adress: Full address Country Flat number House number City Street Post code Additional rules: Only data that is available will be pre-filled. If there is no dedicated field for specific data - then it will not get filled. Pre-filled data can be edited.
16	Fill in the business onboarding form	User	Legal entity’s representative fills in company’s details. Legal entity’s representative fills in the details of all representatives of the company. If the automatic check for representatives is turned off, the following data is mandatory: Company name, Company code.
17	Review and submit the business onboarding form	User	Business onboarding form is completed.
18	Save filled in business onboarding form details	Ondato	Business onboarding form details are saved.
19	Check if the business onboarding form must be signed		This step is configurable. → If business onboarding form must be signed then flow continues to #20. → If business onboarding form must NOT be signed then flow continues with #22.
20	Sign business onboarding form	User	Legal entity’s representative signs the form using Dokobit.
21	Display error message	Ondato	The process stops.
22	Redirect company’s representative to a landing page	Ondato	User is redirected to the configured url.