MultiSafepay plugin for Magento 1

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


Magento 1 is end-of-life. If you are still running Magento 1, action is required. MultiSafepay has partnered with Mage One to continue supporting Magento 1 in the future. Please read our blog for more information and the actions to take.
Starting from 3.0.0 the plugin only needs your API key, Account ID, Site ID and Secure Code are not needed anymore and removed from the settings.


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

Installation of the plugin can be done in three ways:

  • SFTP upload
  • .ZIP file upload in Connect
  • Via the MarketPlace.

In this manual we describe the SFTP upload method.

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

We recommend you to install the plugin first on a test environment, and make sure you have made a backup.

We advise you to install the plugin through the recommended ways of the specific webshop system.

If you need any technical help, please contact us.

To use the plugin you need a MultiSafepay account. You can create a test account on
If you would like to set up a live account, please contact the MultiSafepay sales department:

MultiSafepay supports most functionalities of Magento. If you have any questions about the services we offer, do not hesitate to contact us at [email protected]

1. Requirements

  • Magento Open Source 1.7 - 1.9
  • Tested on PHP 7.0

2. Installation

  1. Unpack the content of the .ZIP file in the root of your webshop
  2. Log in to your backend and navigate to System > Configuration > Cache. Clear your invalid cache
  3. Move all files and folders from Plugin_Magento_x.x.x to the root. Contents in the folders app, lib and media should be added to the existing folders with the same name
  4. Logout from the backend of your webshop.

3. Configuration

  1. Log in to the backend of your webshop and navigate to System > Configuration > MultiSafepay x.x.x > Connect Settings. This page contains all main settings and is used for all gateways and gift card. Information on where to find your API key can be found on our API key page

  2. Navigate to System > Configuration > MultiSafepay x.x.x > Connect 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 Gift Cards
    This page contains the configuration options for all gift card supported by MultiSafepay. gift card 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 FastCheckout can be found on our official website.

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] or start a discussion in our Magento Slack channel #multisafepay-payments

Release Notes

See our changelog in GitHub for the Magento 1 plugin



Can I remove the Klarna fields "Gender" and "Date of birth" in my checkout?

Klarna needs the gender and date of birth of the customer. By default, the customer fills in this information in the Magento checkout in the Klarna payment method fields. The gender is automatically filled by the core Magento field.

You can disable both fields on the Klarna payment method and then the customer will fill in this information on the MultiSafepay payment pages.

This change is only for Magento developers. We strongly advise to test the change and place the change in the local folder.


  1. Open app\code\community\MultiSafepay\Msp\Model\Gateway\Klarna.php
  2. Comment this line protected $_formBlockType = 'msp/klarna';
  3. Save the file, clear the cache and test the change.
Can I set orders to 'Shipped' automatically in Magento 1?

Within our Magento 1 plugin, all complete orders are automatically set to the status Shipped . This is needed to collect the funds from AfterPay, E-Invoicing, Klarna, Pay After Delivery and Santander Betaal per Maand.

Generic gateways

The Magento 1 plugin offers 3 generic gateways and 3 generic gift cards under the gateway and gift card sections respectively. All of our payment methods are supported. It is possible to set the gateway code, gateway logo, gateway label, and whether the shopping cart should be included in the transaction. Refunding and backend orders are fully supported.

How can I update the plugin for Magento 1?

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. We will be describing the necessary steps to update a plugin via SFTP.

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 1 plugin?
  1. Read the page about tokenization
  2. Enable Tokenization via Stores > Configuration > MultiSafepay > MultiSafepay Settings

Note: The Tokenization feature is not available for the Credit Card gateway. You are required to enable the Visa, Mastercard and/or Maestro gateways separately in order to have this feature. This will make the “Save Card” option available during the checkout process.

Is the MultiSafepay Magento 1 plugin compatible with Picqer?

Yes, but you will have to follow two additional steps, because orders should not go to the Cancel state.

  1. Go the the MultiSafepay Connect settings in you Magento 1 backend and link the status expired to Waiting
  2. Open “app\code\community\MultiSafepay\Msp\Model\Base.php”, copy the file to the local folder in the Magento structure
  3. Find the line $order > cancel(); at the expired signal and remove it.

Now all the expired orders will keep the waiting status until you cancel them. You can do this by hand, schedule it with a custom cronjob or by using a plugin.

Issue a refund

Yes, it is possible to refund orders or process a credit memo from the backend. Follow these steps:

  1. Please ensure an API key has been provided under System > Connect Settings and that the option Credit Memo has been enabled
  2. Go to the order in the Magento backend for which you’d like to issue a refund
  3. Click the Invoices tab on the left of the Order Overview
  4. Open the invoice, and click on Credit memo located at the top right of the overview
  5. Once the desired refunds/adjustments have been provided and made, click on Refund Online so we can receive the request.

Further information on issuing a refund available in the Magento 1 user guide.

Issuing a refund for AfterPay, Klarna, Pay After Delivery, Betaal per Maand or E-Invoicing in the Magento 1 ecommerce platform is possible. However, this can only be processed by selecting an item. It is not possible to credit an amount from the Magento 1 backend.

Warning: If an amount is specified instead of an item selected, the entire order will be refunded.

Payment fee / Surcharges

Magento 1 allows you to add a payment fee. The payment fee can be a Surcharge by percentage or a fixed amount. Each payment method has the option to set a fee.

Other options available are settings like tax class for payment fee and show payment fee inclusive or exclusive during a checkout procedure.

The payment fee will always be shown to the customer during the checkout procedure.

Follow the steps below to set a surcharge per payment method in the backend of Magento 1:

  1. Select systems and configuration
  2. In the module from MultiSafepay choose the option connect gateway
  3. Select the desired payment method
  4. Add a surcharge percentage or fixed amount to set-up a fee within the section > payment fee amount
  5. It is optional to show the added fee with or without VAT in the checkout.

See how applying payment fees or surcharges for your customers may affect your webshop on our PSD2 documentation page.

Place a test order to verify whether the fee has been correctly processed.

Which Magento 1 Checkouts are supported?

We test our plugin at two Magento checkouts:
* Magento 1 core checkout
* (Idev)

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 the webshop currency converted into Euro?

MultiSafepay processes payments in Euros (EUR) as a standard currency Our Magento 1 plugin is developed based on this.

However, if your webshop uses a different currency, simply change the configuration in the plugin settings:

System > Configuration > MultiSafepay x.x.x > Connect Settings > Allow currency conversion to Euro > No.


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.