--- title: "Onboard and verify users" description: "Learn to move your users through the onboarding and verification process." url: "https://docs.adyen.com/marketplaces/onboard-users" source_url: "https://docs.adyen.com/marketplaces/onboard-users.md" canonical: "https://docs.adyen.com/marketplaces/onboard-users" last_modified: "2024-03-04T17:27:00+01:00" language: "en" --- # Onboard and verify users Learn to move your users through the onboarding and verification process. Your users' legal entity type and operating country determine the [required verification information](/marketplaces/onboard-users/onboarding-steps) 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. * **Hosted onboarding**: Direct your users to a page hosted by Adyen, where Adyen manages the onboarding flow and user interface (UI). You need to implement a few API calls to create the resources. * **API-only onboarding**: Build your own UI and collect required user data. You make API requests to create resources and submit the user data to Adyen. This onboarding type gives you complete control over the user journey within your platform's environment. The timing of when you need to collect this information depends on the [verification type](/marketplaces/verification-overview/verification-types) that applies to your case. After Adyen receives the information, the [verification process](/marketplaces/verification-overview) starts automatically. ## Requirements If you have an [Adyen for Platforms](/adyen-for-platforms-model/) integration, there are no additional requirements, limitations, or preparations. ## Hosted onboarding ##### Hosted onboarding Postman flows ![](/user/pages/reuse/pfs-general/link-to-postman-flows/postman-icon.svg?decoding=auto\&fetchpriority=auto) [Try out Postman flows](https://www.postman.com/adyendev/workspace/adyen-flows/flow/6555ce17ba8c23003c46e885) in your private workspace to test all the required API calls with your own credentials. Hosted onboarding is our recommended solution for collecting the information needed to onboard your users. This option requires less integration effort, because your users provide their information directly on a page hosted by Adyen. You can onboard the following [legal entity types](/marketplaces/verification-requirements/#legal-entity-type): * [Organization](/marketplaces/verification-requirements/?tab=organization_1) * [Individual](/marketplaces/verification-requirements/?tab=individual_2) * [Sole proprietorship](/marketplaces/verification-requirements/?tab=sole_proprietorship_3) * [Trusts](/marketplaces/verification-requirements/?tab=trust_4) (Only in Australia and New Zealand) You need to make a few API calls to the [Legal Entity Management API](https://docs.adyen.com/api-explorer/legalentity/latest/overview) and [Configuration API](https://docs.adyen.com/api-explorer/balanceplatform/latest/overview) to create and customize the resources required to generate the Adyen-hosted onboarding page. You can also [customize](/marketplaces/onboard-users/customize-hosted-onboarding) the theme, the language, and the user permissions of the hosted onboarding page. Because your users need to accept Adyen's [Terms of Service](/marketplaces/onboard-users/terms-of-service), we included this step on the hosted onboarding page. ### Supported countries and regions You can use hosted onboarding in the following locations where your users are operating. Australia\ Austria\ Belgium\ Bulgaria\ Canada\ Croatia\ Cyprus\ Czech Republic\ Denmark\ Estonia\ Finland\ France\ Germany\ Gibraltar\ Greece\ Guernsey\ Hong Kong\ Hungary\ Ireland\ Italy\ Latvia\ Liechtenstein\ Lithuania\ Luxembourg\ Malta\ Netherlands\ New Zealand\ Norway\ Poland\ Portugal\ Romania\ Singapore\ Slovakia\ Slovenia\ Spain\ Sweden\ Switzerland\ United Kingdom (including Isle of Man & Jersey)\ United States (including Puerto Rico) ### Instant bank account verification in hosted onboarding For some locations 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 in to 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. ** #### See supported countries/regions This feature is currently only available for the following locations and legal entity types. | Country/region | Individuals | Organizations | | -------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | Austria | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | | Belgium | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | | Canada | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | Denmark | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | | Estonia | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | | Finland | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | | France | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | Germany | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | Ireland | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | | Italy | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | | Latvia | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | | Lithuania | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | | Netherlands | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | Norway | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | | Portugal | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | Poland | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | Spain | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | Sweden | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | United Kingdom | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | United States | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | To see an example of the entire hosted onboarding flow, you can watch a video here: Embedded video (Vimeo): Embedded video (Vimeo): ### Autofill individual details using ID documents in hosted onboarding This feature is only available if you are using [onboarding v3 or v4](/marketplaces/onboard-users/onboarding-versions/) Users filling in their personal details can now scan or upload their ID document in the hosted onboarding page to add this information. This ensures that the information matches the document and improves verification pass rates. Only ID documents that contain [Latin characters](https://en.wikipedia.org/wiki/Latin_alphabet) are supported. After scanning or uploading their ID document, the user can confirm their information before submitting it to Adyen.\ ![ID document scan and upload screen in hosted onboarding](/user/pages/reuse/pfs-onboarding/landing-page/hosted/Id-capture.png) To test this feature, use the following [sample document](https://documentation.onfido.com/images/sample_driving_licence.png). ### Guided flow to add decision-makers for organizations in hosted onboarding This feature is only available if you are using [onboarding v3 or v4](/marketplaces/onboard-users/onboarding-versions/) Users can answer a series of questions to ensure that they select the correct role for the decision-makers for their organization. Decision-makers include [ultimate beneficial owners, controlling persons, and signatories](/marketplaces/verification-requirements/?tab=organization_0_1#identify-ubos). ![Guided flow for selecting decision-maker roles in hosted onboarding](/user/pages/reuse/pfs-onboarding/landing-page/hosted/decision-makers.png) ### Verify decision-makers by invite in hosted onboarding This feature is only available if you are using [onboarding v3 or v4.](/marketplaces/onboard-users/onboarding-versions/) After a user adds a [decision-maker](#decision-makers) and enters their basic details, the user can select **Invite decision-maker** to ask the decision-maker to complete their own verification. ![Hosted onboarding invite decision-maker screens](/user/pages/reuse/pfs-onboarding/landing-page/hosted/decision-maker-invite.png) The user can then fill in the invite details, add an optional message, and select **Continue** to send the invite. Adyen sends an email to the decision-maker with a link to provide their information. You can [customize the appearance](/marketplaces/onboard-users/customize-hosted-onboarding#create-themes) of these emails in your Customer Area. ## API-only onboarding With API-only onboarding, you need to build the UI for your marketplace where you collect data from your users. You then need to submit the collected data to Adyen by making requests to the [Legal Entity Management API](https://docs.adyen.com/api-explorer/legalentity/latest/overview) and the [Configuration API](https://docs.adyen.com/api-explorer/balanceplatform/latest/overview). You can onboard users operating in any of the [countries and regions where Adyen for Platforms is supported](/marketplaces#supported-countriesregions). To build your integration more quickly, you also can embed an [Onboarding component](/marketplaces/onboard-users/components) into your UI to let your users enter their data. These components use the entered data to create the relevant resource. This means you do not need to make an API request to create the resource yourself. ## Next steps [required](/marketplaces/onboard-users/onboarding-steps) [Onboarding steps](/marketplaces/onboard-users/onboarding-steps) [See the required verification information for your users and how to submit it to Adyen](/marketplaces/onboard-users/onboarding-steps) [Customize hosted onboarding](/marketplaces/onboard-users/customize-hosted-onboarding) [Learn how to customize your hosted onboarding page](/marketplaces/onboard-users/customize-hosted-onboarding)