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.

Collecting onboarding information​

Company onboarding information can be submitted with the API or through Swan's onboarding form.

MethodDetails
Onboarding formThe onboarding form collects:

  1. User's email address.
  2. Legal information about the organization, including the company name, registration number, VAT number (optional), and address, as well as details about the organization's activity and expected monthly volume.
  3. Information about the company's related individuals (ultimate beneficial owners (UBOs) and legal representatives).
  4. Information about the company's related companies (legal entity representatives, if applicable).
  5. Required documents to verify your organization. You might not see this step in your onboarding process.
  6. User signs up for Swan.
You can also customize this form to better meet your needs. Review Swan's open source documentation, then ask your PIM (Product Integration Manager) for more information.
APIThe API collects the same information as the onboarding form. Review the requirements explained on this page thoroughly, then follow the guide to create a company onboarding link.

Expected monthly volume​

Swan uses the expected monthly volume provided during onboarding to monitor the account. It's essential to select the range that corresponds to the company's actual volume, and to notify Swan if that expected monthly volume changes during the account's lifecycle.

If you use Swan's onboarding form, this information is collected by default. If you design your own form, offer the following ranges:

  • Less than €10,000 (LessThan10000).
  • Between €10,000 and €50,000 (Between10000And50000).
  • Between €50,000 and €100,000 (Between50000And100000).
  • More than €100,000 (MoreThan100000).

The new API uses the company.relatedIndividuals array to represent all individuals connected to the company. Each individual has a type that determines their role:

  • LegalRepresentative: the individual represents the company legally.
  • UltimateBeneficialOwner: the individual holds ownership or control over the company (25% or more of the company's value, directly or indirectly).
  • LegalRepresentativeAndUltimateBeneficialOwner: the individual serves both roles.
Finalization requirements

At least one legal representative and one UBO are required to finalize a company onboarding. The same individual can fulfill both roles by using the LegalRepresentativeAndUltimateBeneficialOwner type.

Use the company.relatedCompanies array when a legal entity (not an individual) serves as a representative for the account holder company. Each entry requires the company's entityName, registrationNumber, registrationCountry, and roles.

The legalFormCode field is required for all company onboardings. Use the legalForms query to retrieve all valid legal forms for a given country, translated based on the Accept-Language header. Each legal form includes a code you can use as the legalFormCode value.

Retrieving data automatically​

For companies located in France, use the companyInfoRegistryData query to retrieve data from the National Business Register (RNE) using the company's registration number. Pass the results to the create or update mutation to pre-fill company fields.

No auto-population

The new API does not auto-populate fields. You must call companyInfoRegistryData and pass the results to the createCompanyAccountHolderOnboarding or updateCompanyAccountHolderOnboarding mutation to pre-fill company fields.

Identification recommendations​

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

Account countryRecommended level
for legal representative		Other supported levels
🇫🇷 France✓ ExpertQES
PVID
🇧🇪 Belgium✓ ExpertQES
PVID
🇩🇪 Germany✓ QESnone
🇮🇹 Italy✓ ExpertQES
PVID
🇳🇱 Netherlands✓ ExpertQES
PVID
🇪🇸 Spain✓ ExpertQES
PVID

Self-employed account holders​

Account countryRecommended level
for self-employed		Other supported levels
🇫🇷 France✓ PVIDnone
🇧🇪 Belgium✓ QESExpert + first transfer
🇩🇪 Germany✓ QES + first transfernone

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 createCompanyAccountHolderOnboarding mutation.

Deprecated mutation

The previous onboardCompanyAccountHolder mutation is deprecated.

Deprecated mutations will be removed in December 2026.

Use createCompanyAccountHolderOnboarding for all new integrations.

At least one legal representative and one UBO are required to finalize a company onboarding. For a complete list of fields, country-specific requirements, and conditional rules, refer to the company onboarding field reference.

User flow diagrams​

End-user perspective of a company account onboarding

Guides​

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