EUR onboarding is synchronous and completes immediately. No document uploads are required.

📘

EUR accounts support both SEPA Credit Transfer and SEPA Instant for inbound and outbound payments.

Before You Start

EUR onboarding requires a complete address with all lines provided. with each line being 35 characters or fewer. Make sure the customer's address is fully populated and within the character limit before triggering onboarding.

Individual Customer

If the customer is approved in Lorum, call the onboarding endpoint directly via Onboard Customer:

POST /v1/customers/{customer_id}/onboarding/eur

Business Customer

At least one shareholder must be linked to the business before EUR onboarding can be triggered. The shareholder does not need to be EUR-onboarded themselves — they just need to exist as a linked shareholder on the business record.

Add a shareholder

If a customer is approved, a shareholder can be added via the Add Shareholder

POST /v1/customers/{customer_id}/shareholders.

📘

Already USD/GBP-onboarded? USD/GBP onboarding requires UBOs to be linked as shareholders, so you can skip this step and trigger EUR onboarding directly.

Trigger Onboarding

Initiate onboarding via Onboard Customer:

POST /v1/customers/{customer_id}/onboarding/eur

🛑 Error codes:

Confirming Status (Both Customer Types)

Onboarding completes immediately. Confirm the result via Get Customer Onboarding Status

GET /v1/customers/{customer_id}/onboarding/eur:

{  
  "customer_id": "...",  
  "currency": "EUR",  
  "status": "completed"  
}

Once onboarding is confirmed, a EUR account can be created via the API. Newly created accounts will initially show as Pending and transition to Open within 5–10 minutes.