Skip to main content

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:

  1. User's email address.
  2. User's country of residence and residence address.
  3. 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.
  4. User signs up for Swan.

Identification recommendations​

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

Account countryRecommended level
for individuals
Other supported levels
🇫🇷 France✓ PVIDExpert + first transfer
QES
🇩🇪 Germany✓ QES + first transfernone
🇮🇹 Italy✓ QESExpert + first transfer
🇳🇱 Netherlands✓ ExpertQES
PVID
🇪🇸 Spain✓ QESExpert + 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.