EU Onboarding

This page provides an overview of Know Your Business (KYB) flows for the European Union and includes links to related resources for quick reference.

Page	Description
EU Required Parameters	Lists the required API fields for each entity type.
EU Required Documents	Lists the required documents to verify businesses, stakeholders, and applicants.
EU Position Mapping	Describes the required roles for each entity type.
EU Request Examples	Provides sample requests for EU entities.

• Nium supports both electronic KYB (eKYB) and manual KYB flows for businesses in the European Union.
• eKYB pre-fills applications and helps reduce the number of documents required to submit. It improves your customers experience by reducing drop-offs and speeding up approvals. Contact Contact Nium for information on how to enable eKYB for your account.

eKYB flow

Follow these steps to complete the eKYB application process.

Step 1: Fetch public corporate details

Collect the basic details about the applying corporate customer through an onboarding form (eKYB onboarding). This includes the businessRegistrationNumber and countryCode. See currency and country codes for valid values.

Call the Fetch Public Corporate Details Using Business ID request. This request returns publicly available corporate details. Return them to your customer to confirm.

Store the returned searchReferenceId. You’ll need it in the next step.

If no results are returned, submit a full request using the Onboard Corporate Customer request to proceed with manual KYB onboarding.

Step 2: Get exhaustive corporate details

Call the Fetch Exhaustive Corporate Details Using Business ID request with the searchReferenceId.

Save the returned searchId; this will be required in later steps.

caution

This is a chargeable API. Use it only once per customer. Contact your Nium account manager or Nium Support for more details.

Step 3: Display details to the applicant

Display the returned details to the applicant for review. Collect any missing required information.

Step 4: Submit corporate details

Call the Onboard Corporate Customer request with the complete details, including searchId.

If searchId is not included, the application is processed as a MANUAL_KYB onboarding attempt and goes through manual review.

Applicant KYC

After receiving a response from the Onboard Corporate Customer, save the redirect URL and send the applicant to this redirectURL. The applicant then completes eKYC on Nium's verification partner's side (Onfido) by uploading a proof of identity, address, and a live selfie.

• You must include E_DOC_VERIFY for businessDetails.applicantDetails.kycMode for every application. To must pass E_DOC_VERIFY as businessDetails.applicantDetails.kycMode.

Redirection outcomes:

Scenario	Action	Query Parameters
Steps completed	Wait for webhook	isSuccess = true
URL expired	Call Regenerate KYC URL	errorCode = R408, isSuccess = false
Document already submitted	Wait for webhook	errorCode = R403
Incorrect data	Ask applicant to correct it	errorCode = I400
Vendor verification failed	Wait for manual review	errorCode = R401
Internal server error	Retry or contact support	errorCode = R500
Unexpected error	Retry or contact support	errorCode= I500
Already verified	Wait for webhook	errorCode = R606

Example success redirect:

https://www.clientRedirectURL.com/?clientId=...&isSuccess=true

Example failure redirect:

https://www.clientRedirectURL.com/?clientId=...&errorCode=R408&isSuccess=false

note

• For US addresses, use a valid two-letter state code.
• For GB addresses, use the SW4 6EH postcode format.

Use the Fetch Corporate Constants request for permitted values.

caution

The redirectURL expires quickly. Regenerate it if it expires.

Stakeholder KYC

For

• UBO
• TRUSTEE
• PARTNER

Use MANUAL_KYC and include required documents in businessDetails.stakeholders.stakeholderDetails.documentDetails.

Ignore businessDetails.stakeholders.stakeholderDetails.kycMode for other positions.

See Required documents for details.

Upload documents

Note, f searchId is not passed, document uploads are required. Additionally, even with searchId, additional documents may be needed.

Use one of these APIs:

• Upload Document – Recommended.
• Onboard Corporate Customer.

Add remarks in the remarks field to indicate missing documents.

caution

The API gateway limits requests to 10 MB. Use the Upload Document request for large files.

See EU Required Documents.

Terms and Conditions

Fetch and display terms using the Terms and Conditions API.

To accept:

1. Wait for customerHashId in onboarding response.
2. Call Accept Terms and Conditions API.
3. Show terms and record acceptance.

See Terms and Conditions.

Step 5: Wait for webhook

After submission, status is IN_PROGRESS. The applicant must complete KYC and upload documents. Nium then verifies the details and returns a response via webhook.

See Webhooks for next steps.

Manual KYB flow

Call the Onboard Corporate Customer request with a full request body.

• Submit all required documents first.
• Use E_DOC_VERIFY for applicant KYC.
• Use MANUAL_KYC for stakeholder KYC and include documents.
• Follow the same Terms and Conditions flow.

Status is IN_PROGRESS after submission. When complete, Nium sends the verification result via webhook.

See Webhooks for more information.