Skip to main content

Company account onboarding

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

Self-employed users hold company accounts. Refer to the country requirements section for more information about identification for self-employed users.

Process overview​

Company onboarding supports different types of organizations, including:

  • Several types of companies
  • Self-employed workers
  • Associations or not-for-profit organizations

Your main action is to create a company 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.

Company onboarding form​

The company onboarding form begins by gathering preliminary details about the company. Then, Swan collects the following information:

  1. User's email address.
  2. Legal information about the organization, including the company name, registration number (optional), VAT number (optional), and address, as well as details about the organization's activity and expected monthly volume.
  3. Information about the company's ultimate beneficial owners (UBO). This step only applies if the user selected company, home owner association, or other when submitting their preliminary details.
  4. Required documents to verify your organization. You might not see this step in your onboarding process.
  5. User signs up for Swan.
Country-specific info

Requested information can change based on your account country. Refer to the tables later on this page for country-specific requirements.

Identification recommendations​

Swan must verify the identity of the legal representative for each company. Swan supports multiple identification processes. For company onboarding, the following levels are recommended based on the account country.

Account countryRecommended level for legal repOther supported levels
đŸ‡Ģ🇷 France✓ ExpertQES
PVID
🇩đŸ‡Ē Germany✓ ExpertQES
🇮🇹 Italy✓ QESExpert + first transfer
đŸ‡ŗ🇱 Netherlands✓ ExpertQES
PVID
đŸ‡Ē🇸 Spain✓ ExpertQES
PVID
Self-employed account holders
  • France unregistered self-employed: PVID, or Expert and a first transfer to your Swan account (QES is technically accepted but not preferred)
  • France registered self-employed: Expert
  • Germany self-employed: QES and a first transfer to your Swan account

Country requirements for company accounts​

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

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

Note that this section is broken up into company and account holder information, information about the UBO, and information about the legal representative.

All have required fields. If the cell is empty, the field is optional.

Company and account holder information​

API fieldđŸ‡Ģ🇷
France
🇩đŸ‡Ē
Germany
🇮🇹
Italy
đŸ‡ŗ🇱
Netherlands
đŸ‡Ē🇸
Spain
accountCountry✓ Required (FRA)✓ Required (DEU)✓ Required (ITA)✓ Required (NLD)✓ Required (ESP)
accountName
businessActivity✓ Required✓ Required✓ Required✓ Required✓ Required
businessActivityDescription✓ Required✓ Required✓ Required✓ Required✓ Required
companyType✓ Required✓ Required✓ Required✓ Required✓ Required
email✓ Required✓ Required✓ Required✓ Required✓ Required
isRegistered✓ Required✓ Required✓ Required✓ Required✓ Required
language✓ Required✓ Required✓ Required✓ Required✓ Required
monthlyPaymentVolume✓ Required✓ Required✓ Required✓ Required✓ Required
name (company name)✓ Required✓ Required✓ Required✓ Required✓ Required
redirectUrl
registrationNumber
(if registered)
✓ Required✓ Required✓ Required✓ Required✓ Required
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īš– Conditional
typeOfRepresentation✓ Required✓ Required✓ Required✓ Required✓ Required
vatNumber

īš– Required if both the accountCountry and residencyAddress.country are Spain.

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

Ultimate beneficial owner (UBO) information​

If your company doesn't have a UBO, these fields can be left empty.

Abbreviation

UBO stands for a portion of the API field: individualUltimateBeneficialOwners.

API fieldđŸ‡Ģ🇷
France
🇩đŸ‡Ē
Germany
🇮🇹
Italy
đŸ‡ŗ🇱
Netherlands
đŸ‡Ē🇸
Spain
UBO.birthCity✓ Required✓ Required✓ Required✓ Required
UBO.birthCityPostalCode✓ Required✓ Required✓ Required
UBO.birthCountryCode✓ Required✓ Required✓ Required✓ Required✓ Required
UBO.birthDate✓ Required✓ Required✓ Required✓ Required
UBO.direct✓ Required✓ Required✓ Required✓ Required✓ Required
UBO.indirect✓ Required✓ Required✓ Required✓ Required✓ Required
UBO.firstName✓ Required✓ Required✓ Required✓ Required✓ Required
UBO.lastName✓ Required✓ Required✓ Required✓ Required✓ Required
UBO.residencyAddress.addressLine1✓ Required✓ Required✓ Required
UBO.residencyAddress.addressLine2
UBO.residencyAddress.city✓ Required✓ Required✓ Required
UBO.residencyAddress.country✓ Required✓ Required✓ Required✓ Required✓ Required
UBO.residencyAddress.postalCode✓ Required✓ Required✓ Required
UBO.residencyAddress.state
UBO.taxIdentificationNumberīš– Conditional✓ Required
UBO.totalCapitalPercentage✓ Required✓ Required✓ Required✓ Required✓ Required
UBO.type✓ Required✓ Required✓ Required✓ Required✓ Required

īš– Required if both the accountCountry and the UBO's residencyAddress.country are Germany.

Abbreviation

lr stands for a portion of the API field: legalRepresentative.

API fieldđŸ‡Ģ🇷
France
🇩đŸ‡Ē
Germany
🇮🇹
Italy
đŸ‡ŗ🇱
Netherlands
đŸ‡Ē🇸
Spain
lrPersonalAddress.addressLine1✓ Required✓ Required✓ Required
lrPersonalAddress.addressLine2
lrPersonalAddress.city✓ Required✓ Required✓ Required
lrPersonalAddress.country✓ Required✓ Required✓ Required
lrPersonalAddress.postalCode✓ Required✓ Required✓ Required
lrPersonalAddress.state

User flow diagrams​

End-user perspective of a company account onboarding

Guides​

Use the following guides to start and complete the company onboarding process.