eKYB is a crucial process for verifying the identity and legitimacy of businesses in the digital realm. It involves the electronic verification of business details, such as business registration documents, ownership information, and operational history, by comparing them to official sources of truth.

The global eKYB module facilitates faster and more efficient due diligence processes. It enables businesses to onboard partners, suppliers, and customers securely and compliantly. In an era marked by digital transformation and increasing regulatory scrutiny, eKYB serves as a cornerstone for trust, transparency, and integrity in business transactions.

This comprehensive user guides shows how customers can leverage the Incode eKYB module to:

Enhance security
Reduce paperwork
Expedite onboarding for businesses and customers alike

The eKYB module enables validation of the business information and offers an optional source for this information which includes business name, addresses, city, state, postal code and bank account number.

Integration

The Incode eKYB module provides configuration options to specify different criteria you want to check (such as business name, business address, business tax ID, and so on).

Module Configuration

Conditions

You can use eKYB results in conditions to further impact the user journey or the session result. This table explains the available results, while the image shows the conditions where they can be useful.

eKYB Result	Description	Possible Values
Business Name Match Status	Status of business name match to source of truth	`VERIFIED`, `SIMILAR MATCH`, `UNVERIFIED`, `ALTERNATE NAME`
Tax ID Verification	Status of tax ID match to source of truth	`MATCH`, `NO MATCH`
Address Verification	Status of business address match to source of truth	`VERIFIED`, `APPROXIMATE MATCH`, `UNVERIFIED`
UBO Name Match	Status of UBO match to source of truth	`VERIFIED`, `APPROXIMATE MATCH`, `UNVERIFIED`

Single Session Dashboard Results

To see the eKYB verification results in the Omni Dashboard, go to Sessions, open the session, and click the eKYB tab. This image shows example results.

Direct API Approach

Using the Omni API, module configurations and user data can be forwarded directly when an eKYB search is requested. This overrides any pre-existing configuration and data collected about the user.

📘
API Authentication
All endpoints require authentication headers. For specifications, see the Incode API Documentation

KYB request

POST /omni/externalVerification/ekyb

This endpoint performs an eKYB check for the business specified. The endpoint can have empty body {} so that information is pulled from module configuration and session details.

This table provides a reference to the fields for this endpoint. Some fields are mandatory, and are noted as such. Others are optional depending on the data source and the country.

Field	Data Type	Description
plugins	ekyb	This value is static and mandatory.
businessName	String	First name of the business.
street	String	Street name for the business's address.
houseNo	String	Building or house number for the business's address.
addressLine2	String	Second address line for the business address (for example, in the US this could be an apartment or unit number).
city	String	City for the business's address.
state	String	State for the end user's address.
postalCode	String	Zip code or postal code formatted correctly for the business's country.
country	String	Two-letter alpha-2 country code (such as US, BR, CN, and so on). This field is mandatory.
taxID	String	Tax identifier for the business. Naming depends on the country. For example, in the US, this is the tax identification number (TIN). In Brazil, it is the CNP. In China, it is the Unified Social Credit Code. This field is mandatory.
uboNames	String	Full legal names of Unique Beneficial Owners (UBOs) to check against legal business associations.
directors	String	Full legal names of Officers or Directors to check against legal business associations.

Response

{/*The information prior to the image appears to be duplicated */}

All module configurations and user data can be forwarded directly in the request for performing an eKYB search. This will override existing configuration and data collected about the user.

📘
API Authentication
All endpoints require authentication headers to be specified as stated in Incode API Documentation

Note: Endpoint can have empty body {} and in that case information will be pulled from module configuration and session details.

The following image shows a sample response to the API request for an eKYB search.

RESPONSE EXAMPLE
{
    "kyb": [
        {
            "key": "name",
            "sub_label": "Verified"
        },
        {
            "key": "tin",
            "sub_label": "Verified",
            "reasonCodes": [
                "REGNO"
            ]
        },
        {
            "key": "address_verification",
            "sub_label": "Verified"
        },
        {
            "key": "cityMatch",
            "sub_label": "Verified"
        },
        {
            "key": "postalCodeMatch",
            "sub_label": "Verified"
        },
        {
            "key": "registrationStatus",
            "sub_label": "Active"
        },
        {
            "key": "ubo_name_match",
            "sub_label": "Verified",
            "uboName_input": "XXXXX"
        },
        {
            "key": "ubo_name_match",
            "sub_label": "Unverified",
            "uboName_input": "YYYYY"
        },
        {
            "key": "directors_name_match",
            "sub_label": "Verified",
            "directorsName_input": "ZZZZZ"
        },
        {
            "key": "directors_name_match",
            "sub_label": "Unverified",
            "directorsName_input": "AAAAAA"
        }
    ]
}

KYB error responses

For information about conventional HTTP response codes for API request success or failure, refer to the API Responses page.

There are custom 400 error messages if businessName, taxId, or country fields are “ “ or null:

message: businessName, taxId, and country are minimum required fields

eKYB analytics

With the eKYB module, the Omni Dashboard Analytics page includes an eKYB tab. This enables you to identify trends within your business verification strategy, over time and at a higher level, than analyzing the verifications for each individual business. This image shows the type of analytics data available.

Provisioning

The eKYB module can be added to the Incode Omni platform at additional cost. To obtain more information, contact our dedicated customer support team. Our personalized, comprehensive approach can:

Assist you in tailoring a workflow that precisely meets your unique requirements
Guide you through the most effective configuration options for your specific use case
Optimize your workflows for security and compliance
Ensure that you leverage the full potential of the eKYC module

Our team will provide you with the support and insights you need to make informed decisions, ensuring a seamless integration process.