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



This manual helps merchants to process MultiSafepay payments as quickly as possible from a Magento 2 webshop. For some steps in this manual, assistance from your technical partner may be required.

The installation can be carried out in three ways:

  • SFTP
  • Composer
  • Magento Marketplace.

In this manual we describe the installation via Composer. We recommend that you install the plugin first on a test environment, and make sure you have made a backup.

1. Requirements

  • Magento Open Source version 2.1.x, 2.2.x & 2.3.x
  • PHP 7.0 and higher
  • Tested with PHP 7.0 (Magento 2.3.x adds support for 7.2)

2. Installation

Run the following commands via the CLI:

composer require multisafepay/magento2msp
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy

After running these commands, the latest stable release is downloaded and installed within your Magento 2 webshop.

Depending on your webserver/webshop configuration you also need to check:

  • Set rights on files correctly. Our files can be found at vendor/multisafepay/magento2msp
  • Empty static files when running in production mode
  • Flush cache.

3. Configuration

  1. Login on the backend of your webshop and navigate to Stores -> Configuration -> MultiSafepay x.x.x -> MultiSafepay Settings.
    This page contains all main settings and is used for all gateways and gift cards.

    Information on where to find your Merchant 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

  2. Navigate to Stores -> Configuration -> MultiSafepay x.x.x-> MultiSafepay Gateways.
    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

  3. MultiSafepay Giftcards
    This page contains the configuration options for all gift cards supported by MultiSafepay.
    Giftcards need to be activated, more information can be found on our gift card page

  4. Fastcheckout
    This page contains the Fastcheckout specific settings.
    More information about the Fastcheckout can be found on

4. 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]


Click on the button below to see the release notes of our Magento 2 plugin



Available payment methods in Magento 2
  • Afterpay
  • Alipay
  • American Express
  • Bancontact
  • Bank transfer
  • Belfius
  • Betaalplan
  • Direct Debit
  • Dotpay
  • E-Invoicing
  • EPS
  • Giropay
  • iDEAL
  • iDEAL QR
  • ING Home’Pay
  • KBC
  • Klarna
  • Maestro
  • Mastercard
  • Pay After Delivery
  • PayPal
  • Paysafecard
  • SOFORT Banking
  • TrustPay
  • Trustly
  • Visa (including CartaSi, Cartes Bancaires & Dankort).

Gift cards

  • Babygiftcard
  • Beauty and Wellness
  • Boekenbon
  • Erotiekbon
  • Fashioncheque
  • Fashiongiftcard
  • Fietsenbon
  • Gezondheidsbon
  • Givacard
  • Goodcard
  • Nationale Verwencadeaubon
  • Nationale Tuinbon
  • Parfumcadeaukaart
  • Sport en Fit
  • Webshopgiftcard
  • Wellness gift card
  • Wijncadeau
  • Winkel Cheque
  • Yourgift
  • VVV cadeaukaart.
Can I refund orders?

Yes, it is possible to refund orders or credit memo from within the Magento 2 backend.
You can also refund from your 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?

Generally, there are three ways to update a plugin. This can be done through the backend and through the marketplace from a CMS or through SFTP. However, for Magento 2 we will be describing the necessary steps via Composer.

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

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

Go to our Manual page, download the plugin and follow the instructions from step 2.

How do I use tokenization in the Magento 2 plugin?
  1. Read the page How do I get tokenization?
  2. Enable Tokenization via Stores->Configuration->MultiSafepay->MultiSafepay Settings.
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.

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 a 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.

Pending payment order lifetime

The lifetime of orders marked as pending payments in Magento 2 is determined by the Order Cron Settings configuration. The default value is set to 480 minutes (8 hours)

When you offer payment methods whose validation period is more than 8 hours, the order in Magento 2 will automatically be marked as cancelled due to the default setting in Magento 2.

In use with an ERP system, for example, where an order is marked as declined, a successful payment will often not be processed to an order that is marked as cancelled.

The lifetime of a bank transfer is 86400 minutes (60 days).

The order will set to cancelled in Magento 2 before a payment can be linked.

To set pending payments order lifetime, see the Magento Documentation page

Which Magento 2 Checkouts are supported?

Currently we test our plugin at two Magento 2 checkouts:
1. Magento 2 core checkout
2. MagePlaza OneStepCheckout

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

Why is a specific payment method not visible in my checkout?

When you enabled a payment method, it should always be visible - even when your API key is incorrect -.

Be sure that when you use the Rico Neitzel Payment Filter that you set the payment method as active in that plugin.