Account Holder


Money can't be stored at Swan without belonging to "someone". This "someone" is the account holder.

Account holder is the term Swan uses to designate the owner of one or several accounts at Swan. Money stored in an account belongs to the account holder.

An account holder can be one of your customers, whether an actual human being ("natural person") or a legal entity such as a company or an association ("legal person"). Even you can be an account holder.

Account holders, created on-demand, are able to use their accounts immediately, with some restrictions. Until identity verification has been completed, the account holder is limited to €150 of outgoing payments over a 30 day period and will not be assigned an IBAN.

Verification process

To fight money laundering and terrorist financing, banking regulations require that financial establishments such as Swan keep track of and verify their clients. In banking jargon, we talk about KYC (Know Your Customer). To handle KYC, Swan has set up a fluid and pleasant white-label identity verification for account holders.

A person can open an account for themselves as a "natural person," or they can open an account on behalf of a "legal person," like their company. In either case, Swan makes sure that the person opening the account actually is who they say they are.

To do this, Swan provides a streamlined and ultra-strong verification process through web responsive onboarding interfaces that can easily be integrated into your product.

Verification steps

Here's how it works: the person opening the account takes a selfie, presents at least one identification document, and Swan compares the two. The combination of identity documentation and biometric face recognition makes for an ultra-strong KYC.

If the account is being opened for a legal person, they will likely be asked to provide additional documents related to the legal person's identity.

Swan is proud to make your job easier with this ultra-strong KYC, but if it's a blocking point for you and you feel it is absolutely vital to collect your account holders' data and identification yourself, don't hesitate to contact us: [email protected].

Once an account holder is verified, their account's paymentLevel goes from Limited to Unlimited. The €150 limit on outgoing payments over a period of 30 days is lifted, and they can obtain an IBAN.

To help you keep track of the verification process of an account holder at Swan, we provide the verificationStatus field with the following values:

  • NotStarted: when the verification process has not yet begun

  • WaitingForInformation : when Swan is waiting on information from the account holder

  • Pending : when Swan has begun reviewing the information provided by the account holder

  • Verified: when Swan has successfully completed the verification process

Check the statuses you may want to track throughout the verification process here.


Onboarding refers to the process of opening a new account for your client, who thus becomes the account holder.

To open an account, you must redirect your client to an onboarding URL provided by Swan.

To obtain an onboarding URL, there are two options:

  • #nocode: Select "Activate public links" in your dashboard. You'll see the URLs available below and can redirect your customers to them (see the white-label #nocode tab). There are separate URLs for onboarding a physical person vs a legal person. These public URLs are the same for all of your account holders.

  • by API: streamline your customer's onboarding by preloading the Swan form with data you already know about them. To do this, you can call the API and obtain a dedicated onboarding URL for each account holder.

Onboarding steps

Be careful: if you want to be sure no one other than your clients is able to open an account, you will want to restrict access to onboarding. You will have to "Deactivate public links" in the white-label #nocode tab on the dashboard.

To obtain an onboarding URL by API, use the following mutation:

  • onboardCompanyAccountHolder for a legal person

  • onboardIndividualAccountHolder for a physical person

An onboarding is thus returned, with the onboardingUrlfield containing the URL for onboarding your customer.

Once you have redirected your customer to the onboarding URL, here are the steps they will have to follow at Swan:

  1. Agree to Swan's terms of service, and agree to the conditions of partnership with your company.

  2. Enter identification data. All this information can be prefilled if you had it transmitted during onboarding creation by API.

    • For a physical person: email, birth date, first name, last name, nationality, residency address, employment status, monthly income

    • For a legal person:

      Legal representative's info: email, first name, last name

      Legal person's info: residency address, business activity description, legal form, name, registration number, yearly payment volume, ultimate beneficial owners

  3. Download Swan app

    • If onboarding via a mobile phone: a deeplink redirects to the smartphone's store (Google Play or Apple Store).

    • If onboarding via a desktop: the account holder must download the app from their smartphone's store. If they want, they can receive an SMS redirecting to it.

  4. Create a user account on Swan app using a phone number

  5. Bind with Swan app and the onboarding process

    • If onboarding via a mobile phone: the deep link contains all the necessary information. The user doesn't have to do anything.

    • If onboarding via a desktop: the account holder uses Swan app to scan the QR Code displayed on the onboarding page.

  6. Identity verification: a combination of identity documentation and biometric face recognition. This step can be performed later.

  7. Start using Swan.

    • #nocode: they are redirected to your white-labeled web banking, and can connect as the first member of the account.

    • by API: they are redirected to the redirectUrl that you specified when you created the account holder. If you didn't specify one, they'll just be sent to the web banking.

      This will have the codeaccessToken for your customer's first membership. Learn more. Careful, if a redirectUrl is specified, it must be declared in the list of possible Redirect URLs in the tab API Credentials on the dashboard.

You can test this sequence as many times as you'd like from your dashboard using the public URL in the Sandbox environment.

Create as many Sandbox users as you want, to simulate as many cases as possible. Learn more.

Once the onboarding process is completed:

  1. The account holder is created with the Enabled status

  2. The account holder's account is created. Learn more.

  3. The person having performed the onboarding becomes the legal representative, and has the first membership with access to full rights on this account. Learn more.

  4. The relationship you have with the account holder for a created account is stored in the partnershipStatusInfofield of the account object.

The onboarding list is available in the onboardings query. It allows you to keep track of your customer's onboarding process, and once the onboarding is done, to keep track of the account holder that was created.

Verification steps

Here are the different statuses you may want to track throughout the verification process.

1 - Onboarding

2 - Identity verification

3 - Document collection

4 - Compliance review

5 - Verified