This module verifies the identity and legitimacy of a business by matching business details submitted by the end user against records in recognized government and commercial data sources. The fields collected depend on the country the end user selects.
Supported with:
:white_check_mark: Workflows | :white_check_mark: Flows
Prefill is currently supported only in Flows. See Configuration Options.
Add eKYB to Workflows
- In the left menu, click Flow Builder > Workflows.
- Click New or select an existing Workflow.
- From the Modules list, drag and drop the eKYB module into the builder.
- You can click the three dots > Edit on the module node to open the Configuration Options panel and adjust settings as needed.
Add eKYB to Flows
- In the left menu, click Flow Builder > Flows.
- Click New or select an existing Flow.
- On the Select Modules tab, find the eKYB module and click Add.
- You can click Details & Configurations to open the Configuration Options panel and adjust settings as needed.
Configuration Options
This section details all the configuration options available for this module. After changing anything, click Save configurations before closing the configuration panel.
The options you see in your configuration may differ from those documented below. Contact your Incode representative for more information.
The eKYB module supports two configuration options: Verification and Prefill. Switch between the two using the tabs at the top of the configuration panel.
Verification
Verification is the core business identity check. The end user submits business details (business name, tax ID, address, and optionally UBOs and directors), and the system verifies the submitted values against a source of truth. The response includes match results for each submitted field, along with enrichment details (registration status and entity type) where available.
For request and response schemas, supported countries, and per-country details, see the eKYB Verification Coverage and eKYB Verification API Reference pages.
The field checkboxes control which fields are collected from the end user and submitted for verification. The end user selects the country in the flow itself; there is no country selector in the module configuration.
Flows configuration
Workflows configuration
| Setting | Description |
|---|---|
| Business name | When enabled, the end user is asked to provide the business name. |
| Address | When enabled, the end user is asked to provide the business address. |
| Tax ID | When enabled, the end user is asked to provide the business tax ID. |
| Unique Beneficial Owner (UBO) | When enabled, the end user is asked to provide the full legal names of the business's Unique Beneficial Owners. |
| Directors | When enabled, the end user is asked to provide the full legal names of the business's directors. |
Not all fields are supported by every country. See the country page for each country's supported fields. Country pages are listed on the eKYB Verification Coverage page.
Prefill
Prefill is an enrichment option that reduces end user friction. The end user submits only the tax ID and business name, and the system looks up the business in official registries and returns additional details (registered address, entity type, and other authoritative data) for pre-fill. Prefill does not verify submitted values against a source of truth; it retrieves and returns data.
Prefill is currently available only in Flows, and only for Mexico.
For request and response schemas, supported countries, and per-country details, see the eKYB Prefill Coverage and eKYB Prefill API Reference pages.
| Setting | Description |
|---|---|
| Prefill source | The prefill source to use. Currently the only available option is MX_KYB_PREFILL for Mexico. |
| Tax ID | When enabled, the end user is asked to provide the business tax ID. |
Add Conditions
Conditions let you branch the Workflow based on the eKYB verification result. When adding a Condition after the eKYB module, search, filter, or browse for the eKYB section in the first drop-down and select from the following options:
| Condition | Description |
|---|---|
| Address deliverability | The USPS deliverability status for the submitted business address. Possible values: DELIVERABLE, UNDELIVERABLE. |
| Unique beneficial owners count | The number of Unique Beneficial Owners associated with the business. Supports comparison operators. Possible values: any numeric value. |
| TaxID verification | The match status for the submitted tax ID. Possible values: VERIFIED, APPROXIMATE MATCH, UNVERIFIED. |
| Ubo name match | The match status for the submitted UBO names. Possible values: VERIFIED, APPROXIMATE MATCH, UNVERIFIED. |
| Address verification | The match status for the submitted business address. Possible values: VERIFIED, APPROXIMATE MATCH, UNVERIFIED. |
| Business name | The match status for the submitted business name. Possible values: VERIFIED, APPROXIMATE MATCH, UNVERIFIED. |
| Address property type | The property type of the submitted business address. Possible values: RESIDENTIAL, COMMERCIAL. |
{/* TODO: Confirm with PM — the eKYB Conditions drop-down does not appear to include a Director name match Condition, even though director name match is a supported response field for several countries. Confirm whether this is intended or a gap. */}
{/* TODO: The Dashboard drop-downs currently show status values including SIMILAR MATCH and ALTERNATE NAME on some Conditions; PM confirmed these are incorrect and are being fixed. This table documents the correct Verified/Approximate Match/Unverified values. Verify against Dashboard once the fix ships. */}