Individual account onboarding

Process of creating a new individual account holder, and opening a new Swan account for that account holder.

Process overview

Your main action is to create an individual onboarding link. The link leads your user to a multi-step form through which Swan collects essential information to open the account.

When creating an onboarding link for your users, you can pre-fill most of the information for them. When your user goes through the form, they'll confirm that the information you entered is correct. Users can also fill in this information themselves.

Individual onboarding form

Through the individual onboarding form, Swan collects the following information:

User's email address.
User's country of residence and residence address.
Basic details about the user's employment and financial situation. This information allows Swan to perform two essential tasks:
- During onboarding, Swan completes an identity analysis (Know Your Customer, or KYC).
- For the lifetime of the account, Swan monitors for fraud.
User signs up for Swan.

Identification recommendations

Swan must verify the identity of every user. Swan supports multiple identification processes, and some require a first transfer. For individual onboarding, the following levels are recommended based on the account country.

Account country	Recommended level for individuals	Other supported levels
🇫🇷 France	✓ PVID	Expert + first transfer QES
🇩🇪 Germany	✓ QES + first transfer	none
🇮🇹 Italy	✓ QES	Expert + first transfer
🇳🇱 Netherlands	✓ Expert	QES PVID
🇪🇸 Spain	✓ QES	Expert + first transfer PVID + first transfer

Country requirements for individual accounts

Requirements vary country to country when opening any type of Swan account. Requirements for individual accounts are different than for company accounts, and there is also a different mutation.

For individual accounts, use the onboardIndividualAccountHolder mutation to collect the following information according to your desired account country.

Field Requirements Legend

● REQ Required: must be completed.

◐ CND Conditional: required only in specific situations.

○ OPT Optional: isn't required; may have a default value.

API field	🇫🇷 France	🇩🇪 Germany	🇮🇹 Italy	🇳🇱 Netherlands	🇪🇸 Spain
`accountCountry`	● REQ (`FRA`)	● REQ (`DEU`)	● REQ (`ITA`)	● REQ (`NLD`)	● REQ (`ESP`)
`accountName`	○ OPT	○ OPT	○ OPT	○ OPT	○ OPT
`email`	● REQ	● REQ	● REQ	● REQ	● REQ
`employmentStatus`	● REQ	● REQ	● REQ	● REQ	● REQ
`language`	● REQ	● REQ	● REQ	● REQ	● REQ
`monthlyIncome`	● REQ	● REQ	● REQ	● REQ	● REQ
`redirectUrl`	○ OPT	○ OPT	○ OPT	○ OPT	○ OPT
`residencyAddress.addressLine1`	● REQ	● REQ	● REQ	● REQ	● REQ
`residencyAddress.addressLine2`	○ OPT	○ OPT	○ OPT	○ OPT	○ OPT
`residencyAddress.city`	● REQ	● REQ	● REQ	● REQ	● REQ
`residencyAddress.country`	● REQ	● REQ	● REQ	● REQ	● REQ
`residencyAddress.postalCode`	● REQ	● REQ	● REQ	● REQ	● REQ
`residencyAddress.state`	○ OPT	○ OPT	○ OPT	○ OPT	○ OPT
`taxIdentificationNumber`	○ OPT	◐ CND ∗	● REQ	○ OPT	○ OPT

∗ If the accountCountry is Germany, the account holder has 90 days to provide their Tax ID Number when opening an account. Otherwise, the account will be suspended.

User flow diagrams