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.
If the cell is empty, the field is optional.
| API field | 🇫🇷 France | 🇩🇪 Germany | 🇮🇹 Italy | 🇳🇱 Netherlands | 🇪🇸 Spain |
|---|---|---|---|---|---|
accountCountry | ✓ Required (FRA) | ✓ Required (DEU) | ✓ Required (ITA) | ✓ Required (NLD) | ✓ Required (ESP) |
accountName | |||||
email | ✓ Required | ✓ Required | ✓ Required | ✓ Required | ✓ Required |
employmentStatus | ✓ Required | ✓ Required | ✓ Required | ✓ Required | ✓ Required |
language | ✓ Required | ✓ Required | ✓ Required | ✓ Required | ✓ Required |
monthlyIncome | ✓ Required | ✓ Required | ✓ Required | ✓ Required | ✓ Required |
redirectUrl | |||||
residencyAddress.addressLine1 | ✓ Required | ✓ Required | ✓ Required | ✓ Required | ✓ Required |
residencyAddress.addressLine2 | |||||
residencyAddress.city | ✓ Required | ✓ Required | ✓ Required | ✓ Required | ✓ Required |
residencyAddress.country | ✓ Required | ✓ Required | ✓ Required | ✓ Required | ✓ Required |
residencyAddress.postalCode | ✓ Required | ✓ Required | ✓ Required | ✓ Required | ✓ Required |
residencyAddress.state | |||||
taxIdentificationNumber | ∗ 90 days | ✓ Required |
∗ 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​
Individual account onboarding​
End-user perspective of an individual account onboarding
Guides​
Use the following guides to start and complete the individual onboarding process.