Your users' legal entity type and operating country determine the required verification information you need to collect from your users. You can use Adyen's Hosted onboarding or build your own UI to collect information from your users. After Adyen receives the information, the verification process starts automatically.
Types of onboarding
Hosted onboarding Postman flows
You can try out Postman flows in your private workspace to test all the required API calls with your own credentials. Select your business model: marketplace or platform.
Hosted onboarding is our recommended solution to collect the required information you need to onboard your users as it requires less implementation effort on your
side. Your users provide their information directly in an Adyen-hosted page.
You can customize a theme for your hosted onboarding page. You then need to create legal entities and account holders for your users and redirect them to your page where they provide their verification information directly to Adyen.
If needed, you can change the language of the page and control user settings.
If your users need to sign PCI security questionnaires or accept Adyen's Terms of Service, these steps are included on the hosted onboarding page. You can configure the page settings to select the relevant PCI questionnaires for users to sign.
Hosted onboarding availability
You can onboard the following legal entity types:
- Organization
- Individual
- Sole proprietorship
- Trusts (Only in Australia)
You can use hosted onboarding in the following countries where your users are operating.
Australia
Austria
Belgium
Bulgaria
Canada
Croatia
Cyprus
Czech Republic
Denmark
Estonia
Finland
France
Germany
Gibraltar
Greece
Guernsey
Hong Kong (beta)
Hungary
Ireland
Isle of Man
Italy
Jersey
Latvia
Liechtenstein
Lithuania
Luxembourg
Malta
Monaco
Netherlands
Norway
Poland
Portugal
Romania
Slovakia
Slovenia
Spain
Sweden
Switzerland
United Kingdom (including Isle of Man & Jersey)
United States (including Puerto Rico)
The default language for the hosted onboarding page is English. You can change the language when creating a hosted onboarding link.
Instant bank account verification
For some countries and legal entity types, your users can choose to instantly verify their bank account details in your hosted onboarding page. They are prompted to log into their online banking environment and confirm their account details. Their bank account is then verified within seconds without them needing to provide a bank statement.
This feature is currently only available for the following countries and legal entity types.
Country | Individuals | Organizations |
---|---|---|
Austria | ||
Belgium | ||
Canada | ||
Denmark | ||
Estonia | ||
Finland | ||
France | ||
Germany | ||
Ireland | ||
Italy | ||
Latvia | ||
Lithuania | ||
Netherlands | ||
Norway | ||
Portugal | ||
Poland | ||
Spain | ||
Sweden | ||
United Kingdom | ||
United States |
To test the instant bank verification flow, in your test environment select the test account for your specified country. Enter the corresponding user name and password.
Instant bank verification testing
Country | Test account | User name | Password |
---|---|---|---|
Canada | Demo Bank | asd | asd |
Belgium | Tink Demo Bank | u51613239 | cty440 |
Denmark | Tink Demo Bank | u51613239 | cty440 |
Estonia | Tink Demo Bank | u91902655 | jtx720 |
Finland | Tink Demo Bank | u80628915 | puv375 |
France | Tink Demo Bank | u98563939 | ene512 |
Germany | Tink Demo Bank | u98235448 | cdz248 |
Italy | Tink Demo Bank | u51613239 | cty440 |
Latvia | Tink Demo Bank | u91902655 | jtx720 |
Lithuania | Tink Demo Bank | u91902655 | jtx720 |
Netherlands | Tink Demo Bank | u48874162 | idz429 |
Norway | Tink Demo Bank | u26049657 | mip544 |
Poland | Tink Demo Bank | u51613239 | cty440 |
Portugal | Tink Demo Bank | u51613239 | cty440 |
Spain | Tink Demo Bank | u82144157 | ymm529 |
Sweden | Tink Demo Bank | u27678322 | vrh343 |
United Kingdom | Tink Demo Bank | u30315772 | ndg370 |
United States | Demo Bank | asd | asd |
To see an example of the entire hosted onboarding flow, you can watch a video here:
Types of verification
Your account holders are verified upfront by default because the capability to receive payments is automatically requested for them. If you are a payment facilitator, you can request a staggered verification process.
In an upfront verification process, you collect all of the required verification information when you onboard your user. The information is verified after you create an account holder. You will not need to ask them for additional information if they reach a higher verification tier.
Onboarding versioning
We regularly make non-breaking changes to the Legal Entity Management API in order to provide you benefits from the updates, but at the same time not require you to reintegrate with Adyen. Any changes to the LEM API are described in our release notes. Forward compatibility is not currently supported. For example, a legal entity created in LEM API v3 cannot be updated using LEM API v2.
We sometimes need to introduce breaking changes due to regulatory changes or provide new features to our merchants. When we introduce a breaking change, we will do this in a new version of the LEM API. If there are critical required security or compliance changes, these will implemented in the latest API version and released in test environments four weeks before they are available in live. You will also receive updates about these changes in your Balance Platform Customer Area.
Breaking changes are introduced in order to:
- Provide new onboarding features
- Improve your onboarding performance and stability
- Ensure compliance with new regulatory requirements
API release schedule
We aim to release new stable versions of the Legal Entity Management API and Hosted onboarding on a consistent basis. We recommend you upgrade to the latest API version as soon as possible. Although older versions can still be used, they will not receive any additional updates.
Before we release a new stable version of the LEM API, we will offer a preview API-only release candidate version. Note that this version will not offer hosted onboarding support.
The release candidate version will be subject to change based on feedback received from our merchants who are willing to pilot. The new release candidate API versions provide early access to new features and improvements planned for the latest stable version.
To get access to the release candidate version, please contact your Adyen account manager.
Sunsetting API versions and upgrading to new versions
We aim to provide you with the ability to stay compliant with changing regulations. As part of our API lifecycle management, we may sometimes sunset older versions of the Legal Entity Management API. This means that after the specified sunset date, you can no longer use that version of the API. We understand that integrating with new API versions takes time, and hence, we aim to provide adequate sunset time from the launch of the new API version.
If you use hosted onboarding, remaining compliant requires no additional effort on your part.
If you use API-only onboarding, you will need to upgrade to the latest API version before the sunset date of the version that you are using.
How to onboard your users
Your users' legal entity type and operating country determine the minimum required verification information you need to collect.