Onboarding your affiliates

By default, you can start onboarding affiliates from your account under Affiliates > Overview. As a partner, you can onboard affiliates that are connected to your main partner account:

• Via your affiliate sign-up link found in your MultiSafepay dashboard
• Via our onboarding API:
  • By sending a standard API request
  • By building a custom integration into your system

Via your MultiSafepay dashboard

You can send your affiliates a sign-up link that will automatically create an account for them. Each affiliated merchant account will be linked to your partner account.

To do this:

1. Sign in to your MultiSafepay partner account
2. Go to Affiliates > Overview or Partner summary
3. Click on the affiliate sign-up link to copy it and send it to your affiliate.
4. Your affiliate will be required to sign up for a MultiSafepay account.

Once signed up, your affiliate must complete the relevant tasks to finish their onboarding:

1. Business Verification

1. Registration (CoC): Search for your business in the official trade register (Chamber of Commerce) to link your legal entity.
2. Terms & Conditions: Review your status; these are typically pre-approved during the initial signup phase.
3. Bank Account: Verify your business bank account by either:
   • Sending a 1.00 EUR verification transfer (fastest).
   • Uploading a recent bank statement showing the IBAN and Account Holder.

2. Operational Details

1. Task Unlock: Once primary info is verified, the dashboard will unlock secondary requirements.
2. Contact Configuration: Set dedicated email addresses for:
   • Monthly Invoices
   • Chargebacks / Disputes
   • Transaction Notifications
3. Categorization: Define your industry and select your payment methods (Payment links, QR codes, or Website integration).
4. Site Compliance: Confirm your website displays required legal info (VAT, CoC, Contact Data, and Terms).
5. Business Address: Confirm the physical registered address of your company.

3. Compliance & Risk

1. VAT Number: Enter your VAT ID or confirm your tax-exempt status.
2. UBO Declaration: Identify all Ultimate Beneficial Owners (>25% ownership) and legal representatives.
3. Identity Verification: Upload high-quality copies of IDs or Passports for all listed UBOs.
4. Financial Info: If offering Credit Cards, provide your average and highest expected transaction amounts.

4. Final Review

1. Screening: Submit your application. MultiSafepay’s compliance team will review your data.
2. Live Activation: You will receive a confirmation message once your account is fully screened and ready to process live payments.

Via API

You can manage and onboard affiliated merchant accounts via our API.

Authentication

To authenticate requests, you must include a partner account API key. For more information, email your partner manager.

Onboarding API

The table below lists our API references for onboarding an affiliate's account.

Onboarding process

1. Create an affiliate

You can use our onboarding API endpoint to create new affiliates. This will create a new affiliate linked to your partner account.

To do this, use the Create affiliate endpoint with the required parameters:

• account.company_name, account.country, account.email
• user.email, user.name, user.password
• currencies

curl --request POST \
     --url https://api.multisafepay.com/v1/json/signup-account \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "account": {
    "company_name": "My company name",
    "country": "NL",
    "email": "[email protected]",
    "id": 99808226
  },
  "user": {
    "email": "[email protected]",
    "name": "Simon Smit",
    "password": "Mypassword123"
  },
  "currencies": [
    "EUR",
    "USD"
  ]
}

{
  "success": true,
  "data": [
    {
      "account": {
        "company_name": "My company name",
        "country": "NL",
        "email": "[email protected]"
      },
      "user": {
        "email": "[email protected]",
        "name": "Simon Smit",
        "password": "Mypassword123"
      },
      "currencies": [
        "EUR",
        "USD"
      ]
    }
  ]
}

2. Create login URL

Once you've created a new merchant, you can give them access to their account by creating a login URL.

To do this, make a create login URL request with the following required parameters:

• account_id, which you can retrieve by making a get affiliate request.
• expires_in to add an expiration time.

curl --request POST \
     --url https://testapi.multisafepay.com/v1/json/accounts/1234556/login-urls \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
			--data '{
          "expires_in":"5m"
      }'

{
  "success": true,
  "data": "https://example.com/"
  }

3. Add bank account

Add a bank account to your affiliate's account. This is a necessary step and will be used for future payouts.

To do this, make an add bank account request with the following parameters:

• account_id of your affiliate's account
• currency in which the transfers will be made
• holder_name of the account holder
• iban of the account

curl --request POST \
   --url https://testapi.multisafepay.com/v1/json/accounts/1234568/bank-accounts \
   --header 'accept: application/json' \
   --header 'content-type: application/json' \
   --data '
{
  "currency": "EUR",
        "holder_name": "My company name",
        "iban": "NL02ABNA0123456789"
}
'

{
"success": true,
"data": {
    "currency": "EUR",
    "holder_name": "My company name",
    "iban": "NL02ABNA0123456789"
  }
}

After adding the bank account, it must be verified to validate the ownership of the account. This can be done through two different methods:

• Make a validate bank account request, creating a 1 EUR payment
• Make a add bank statement request, uploading a bank statement

4. Add UBO

Add the Ultimate Beneficial Owners associated to the affiliated merchant's account. This information is required in order to correctly onboard the affiliate.

To do this, make an add UBO request and include the following required parameters:

• The account_id of the affiliated merchant account where the UBO is being added

UBO personal information:

• name
• birthday
• title (Mr., Mrs., Miss)
• email
• country_of_birth
• country of residence

UBO professional information:

• job_title of the UBO's position
• percentage of the company the UBO controls
• type of control the UBO has over the company

Additional information:

• mobile_phone, office_phone
• address, address_apartment
• zipcode, city, state

curl --request POST \
   --url https://testapi.multisafepay.com/v1/json/accounts/account_id/ubos \
   --header 'accept: application/json' \
   --header 'content-type: application/json' \
   --data '
{
  "type": "shareholder",
  "name": "Simon Smit",
  "birthday": "1980-12-31",
  "title": "Mr",
  "email": "[email protected]",
  "job_title": "CEO",
  "percentage": 25,
  "country_of_birth": "NL",
  "country": "NL",
  "mobile_phone": "+31612345678",
  "address": "Kraanspoor 39",
  "address_apartment": "B",
  "zipcode": "1033 SC",
  "city": "Amsterdam",
  "state": "Noord-Holland",
  "office_phone": "+31654987321"
}
'

{
"success": true,
"data": {
    "currency": "EUR",
    "holder_name": "My company name",
    "iban": "NL02ABNA0123456789"
  }
}

Next step