MultiSafepay plugin for Magento 2

Easily integrate MultiSafepay payment solutions into your Magento 2 webshop with the free and completely new MultiSafepay Magento 2 plugin. Our Magento 2 plugin is professionally supported by a certified Magento 2 Solution Specialist and receives regular updates to support the latest features provided by Magento and MultiSafepay.
Magento 2 Solution Specialist



We are proud to announce that we have been working on a brand new Magento 2 plugin. The new plugin is completely built from the ground up, leaving a lot of the older methods used in the current Magento 2 plugin behind. It brings code improvements, unit/integration testing and it is built on top of the Magento payment provider gateway structure.

Please uninstall the old plugin first, before installing the new one.

The FAQ items regarding the old Magento 2 plugin have been moved to the old plugin page

1. Features

There are a lot of new features, but there are also some features that are not available as of yet. The following features are not available in the new Magento 2 plugin:

  • Tokenization
  • Fastcheckout
  • PWA (REST) endpoints

Some of the new features include:

  • Improved Magento backend configuration with less bugs
  • Improved translations
  • Improved error handling and event & error logs
  • Support information available in the Magento backend
  • Clear explanation of each payment method with links to docs
  • Modular setup, providing more flexibility during the installation process
  • For some payment methods the hosted payment page is now skipped, resulting in a higher conversion rate

2. Requirements

3. Modules

The new MultiSafepay Magento 2 plugin consists of several Magento modules:

4. Installation

For merchants, we recommend installing the meta-package via composer:

composer require multisafepay/magento2
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

This will automatically install all the modules that are necessary to get started.

After installing, the following command can be used in the Magento 2 root directory to enable all the modules:

./bin/magento module:enable `./bin/magento module:status | grep MultiSafepay_`

4.1 Stock handling

If you have disabled MSI inside Magento 2, then you can use the following command to disable the MultiSafepay MSI module:

php bin/magento module:disable MultiSafepay_ConnectMSI

If you have a Magento 2 installation with MSI enabled, you can use the following command to disable the MultiSafepay CatalogInventory module instead:

php bin/magento module:disable MultiSafepay_ConnectCatalogInventory

5. Configuration

  1. Login on the backend of your webshop and navigate to Stores -> Configuration -> Payment Methods -> MultiSafepay -> General Information.
    This page contains all main support information and it is advised to read this.

  2. Navigate to Stores -> Configuration -> Payment Methods -> MultiSafepay -> General Settings.
    This page contains all main settings and is used for all gateways and gift cards. Information on where to find your Account ID, Site ID, Site code or API key can be found on our API key page. Your Account ID is shown in the dashboard of your MultiSafepay Control in the top right corner.

  3. Navigate to Stores -> Configuration -> Payment Methods -> MultiSafepay -> Payment Methods.
    This page contains the configuration options for all payment methods supported by MultiSafepay.
    Be sure that you have the selected payment methods active in your MultiSafepay Control

  4. Navigate to Stores -> Configuration -> Payment Methods -> MultiSafepay -> Gift Cards.
    This page contains the configuration options for all gift cards supported by MultiSafepay.
    Gift cards need to be activated, more information can be found on our gift card page

6. Congratulations

You have installed and configured the plugin successfully. If you have any questions regarding the plugin, feel free to contact our Integration team at [email protected] or start a discussion in our Magento Slack channel #multisafepay-payments

7. Updates

Run the following commands via the CLI:

composer update multisafepay/magento2 --with-dependencies
php bin/magento setup:upgrade
php bin/magento setup:di:compile

Depending on your webserver/webshop configuration, you also need to check: - check the ‘rights’ on files correctly. Our files can be found at vendor/multisafepay - Empty static files when running in production mode - Flush cache.

Release Notes

See our changelog in GitHub for the Magento 2 plugin



Available payment methods in Magento 2

Credit cards


Billing suite


Prepaid cards

  • Paysafecard
  • Baby gift card
  • Beauty and Welness gift card
  • Boekenbon
  • Fashion Cheque
  • Fashion gift card
  • Fietsenbon
  • Gezondheidsbon
  • Givacard
  • Good4fun
  • Goodcard
  • Nationale tuinbon
  • Parfumcadeaukaart
  • Podium
  • Sport en Fit
  • VVV gift card
  • Webshop gift card
  • Wellness gift card
  • Wijncadeau
  • Winkelcheque
  • Yourgift
Can I refund orders?

Yes, it is possible to refund orders or credit memos from within the Magento 2 backend.

In the Magento backoffice, go to the Invoices tab, click on the invoice that was created by MultiSafepay, and then click Credit Memo. Now you see 2 refund buttons: * Offline refund: refund request will not be sent to MultiSafepay * Refund: a refund request will be sent to MultiSafepay.

You can also refund from your MultiSafepay Control

If you have more questions about refunds, please check out our FAQ on refunds.

Note: Refunding from the Magento 2 backend is disabled when the order has a Fooman Surcharge. It is still possible to refund those orders through MultiSafepay Control

Does the plugin support Magento 2 Commerce?

If you encounter issues or require assistance please contact [email protected]

How can I update the plugin for Magento 2?

The plugin can be updated via Composer

Before you update the plugin, we strongly recommend the following:

  • Make sure you have a backup of your production environment
  • Test the plugin in a staging environment.

Go to our Manual page and follow the instructions from step 7.

Payment fee / Surcharges

Adding a payment fee or Surcharge is no longer supported within the plugin in Magento 2.

However, an external package of Fooman is available. This allows you to still add a payment fee or surcharge within the desired payment method.

Refunding from the Magento 2 backend is disabled when the order has a Fooman Surcharge. It is still possible to refund those orders through MultiSafepay Control

Do mind that because an external module has to be installed, our Integration Team’s help will be limited.

Of course, we do our best to support and assist as best as possible, but we investigate or reproduce on the core of a plugin. Therefore, we do not guarantee perfect compatibility when installing an external package.

Please keep in mind that the Payment Services Directive 2, also called PSD2, is now in place and may have implications on your webshop. PSD2 was first released in 2015 by the European Commission. This directive compelled the Member State to effectively intervene and regulate the payment service industry. See how applying payment fees or surcharges for your customers may affect your webshop on our PSD2 documentation page

Which Magento 2 Checkouts are supported?

Currently we test our plugin at two Magento 2 checkouts:

Most Magento checkout plugins are compatible with our plugin. However, we can not guarantee the proper functioning of all features within the checkout plugin.


You're missing something out and would like us to fix it? Suggest an improvement to this page!


Other languages

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

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

Falls Sie eine deutschsprachige Erklärung bevorzugen, kontaktieren Sie bitte Ihren Kundenbetreuer.

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.