Onboarding affiliates via the API

This page is for MultiSafepay partner or primary account holders wanting to submit onboarding information for new affiliated merchants via our API.

The API also lets you create a customized onboarding process for new merchants depending on your business model, e.g. marketplaces, franchises, and crowdfunding platforms. This is particularly useful if you are onboarding multiple merchants.

Submitting merchant information

Step 1: Create merchant accounts

See API reference – Create a merchant account for how to submit the company details for each merchant, including:

  • Company name and address
  • Chamber of commerce number
  • VAT number
  • Contact details

The API returns a merchant account ID.

Step 2: Add a bank account

See API reference – Add bank accounts for how to submit information about each bank account added to the merchant account, including:

  • Name of account holder
  • IBAN
  • Currency

MultiSafepay verifies all bank accounts added to merchant accounts. This can be done in two ways:

  • We send the merchant a payment link for a test transaction of 1 EUR.
  • You send us a bank statement for the merchant’s bank account via our API.

Note: The trade name associated with the bank account must exactly match one of the trade names listed in the chamber of commerce extract.

Step 3: Add UBO details

See API reference – Add UBOs for how to submit details about the ultimate beneficial owner(s) (UBOs) of each merchant’s company, including:

  • Name and other identifying information
  • Contact details
  • Percentage and type of ownership

The API returns a unique UBO identifier, which you can use to submit the UBO identification documents.

Step 4: Add websites

See API reference – Add websitesfor how to submit the following information about merchants' website(s):

The API returns an API key for the website.

Screening and approval

After submitting this information, MultiSafepay screens the merchant accounts, bank accounts, UBO details, and websites. Once approved, the merchants can use their API key to start processing payments.

For more information about the screening process, see Getting started – Onboard and go live.


Propose a change on GitHubexternal-link-icon or
send an email to [email protected]

Other languages

For an explanation in another language, contact your account manager.