Split Payments

How to process a Split Payment?

Split Payments is a feature in our API. This is not incorporated within our plugins by default, but it can be added through customization from your side.

In order to split a payment you need the following:

  • two active MultiSafepay accounts
  • access to the code that creates the JSON request.

For split payments, add the object “affiliate” like:

"affiliate": {
   "split_payments": [
            "merchant": 987654321,
            "fixed": 123,
            "description": "Fixed fee"
            "merchant": 987654321,
            "percentage": 12.3,
            "description": "Relative fee"

See our API page for more detailed technical information.


  • Amount for fixed is in cents and follows the currency settings for the transaction
  • You can either choose “fixed” or “percentage” or a combination of both
  • Keep in mind that our platform uses var3 to store this data, so if you provide any value for var3, it will be overwritten.
How to refund a Split Payment transaction?

A split payment can only be refunded from the original transaction. Whether the refund is paid in full or in part, the amount will be deducted from the original transaction.

For example: Account A receives a payment of 80 EUR of which 10 EUR is going to account B. The customer receives a refund of 50 EUR which is supplied from account A. Whether it is a partial refund or a full, the amount will always be deducted from account A.

Please follow the following steps to refund a split payment transaction:

  1. Login into your MultiSafepay Control
  2. Select Transactions -> Transaction overview
  3. Find the transaction through search
  4. Open transaction
  5. Select Refund
  6. Fill in the amount that you want to refund to the customer
  7. Confirm the refund.

By default, MultiSafepay does not allow you to refund more than the stated amount of the original transaction. However, refunding more than originally received, for example by refunding the return costs incurred by the customer, is now possible in your MultiSafepay Control. More information available on our dedicated FAQ page about refunding more than original amount.

The transaction status is now initialized. As long as the transaction status is marked as initialized, the refund can be cancelled. When the transaction status is marked as completed, the refund is processed correctly. The customer will receive the refund to the bank account number in which the transaction was originally paid to, within the next business day.

Split Payment, What it is

Split Payments allow a merchant to spread a transaction amount over several MultiSafepay Control accounts. This way, you could for instance charge a fee for use of your platform to other parties. Goods from several online webshops can be charged in a single customer transaction.

Merchants can choose to split payments based on percentage or a fixed amount.

Other languages

Liever uitleg in het Nederlands? Neem contact op met uw accountmanager.

Vuoi ricevere informazioni in italiano? Contatta il tuo account manager.

Prefieres tener la explicación en Español? Contacta con tu gerente de cuentas.

Vous préférez une explication en français? Contactez votre gestionnaire de compte.