MultiSafepay plugin for Magento 1

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. For more information and instructions, see the MultiSafepay blog.

This technical manual is for installing and configuring our free plugin for integrating MultiSafepay payment solutions into your Magento 1 webshop via SFTP upload.

You can also install the plugin via .ZIP file upload in Connect.

MultiSafepay supports most Magento functionalities. For any questions, email [email protected]


  Contact us:

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.



  • MultiSafepay account – See Getting started.
  • Magento Open Source 1.7 - 1.9
  • Tested on PHP 7.0


We recommend first installing the plugin in a test environment following, the recommended Magento 1 installation procedure. Make sure you have made a backup.
  1. Unpack the content of the .ZIP file in the root of your webshop.
  2. Sign in to your Magento 1 backend.
  3. Go to System > Configuration > Cache.
  4. Clear your invalid cache.
  5. Move all files and folders from Plugin_Magento_x.x.x to the root. Add the content of the app, lib, and media folders to the existing folders with the same name.
  6. Log out from the backend of your webshop.


  1. Sign in to the backend of your Magento 1 webshop.

  2. Go to System > Configuration > MultiSafepay x.x.x > Connect settings.
    This page contains all main settings and is used for all gateways and gift cards.
    To find your API key, see API key.
    From version 3.0.0, the plugin only needs your API key. Your account ID, site ID, and site secure code are not needed and have been removed from the settings.

  3. Go to System > Configuration > MultiSafepay x.x.x > Connect MultiSafepay gateways.
    This page contains the configuration options for all MultiSafepay payment methods.
    Make sure your selected payment methods are actived in your MultiSafepay dashboard.

  4. To configure MultiSafepay gift cards, go to the MultiSafepay Gift Cards page.
    Make sure gift cards are activated in your MultiSafepay dashboard. For more information, see Gift cards.

User guide

Applying surcharges
Attention Dutch merchants
We strongly recommend that you do not apply surcharges to pay later methods. This is now considered providing credit under the Wet op het consumentenkrediet and article 7:57 of the Burgerlijk Wetboek, and requires a permit from the Authority for Financial Markets (AFM).

You can apply surcharges (payment fees) of a percentage or a fixed amount to transactions for every payment method.

For how applying surcharges may affect your webshop in relation to PSD2, see Payment Services Directive 2.

You can also:

  • Set the tax class for surcharges.
  • Show transaction amounts excluding the surcharge at checkout. Surcharges are always included at checkout.
  • Show surcharges with our without VAT at checkout.

To apply a surcharge to a payment method in your backend, follow these steps:

  1. Sign in to your Magento 1 backend.
  2. Select systems and configuration.
  3. In the MultiSafepay module, select the Option connect gateway.
  4. Select the relevant payment method.
  5. Under Payment fee amount, enter a surcharge percentage or fixed amount.
  6. Place a test order to verify whether the fee has been correctly processed.
Changing currency

MultiSafepay processes payments in Euros (EUR) as the default currency. Our Magento 1 plugin follows the same default.

To change to a different currency for your webshop, follow these steps:

  1. Sign in to your Magento 1 backend.
  2. Go to System > Configuration > MultiSafepay x.x.x > Connect settings.
  3. Under Allow currency conversion to Euro, change to No.
Compatibility with Picqer

To make the MultiSafepay Magento 1 plugin compatible with Picqer, follow two additional steps, because orders must not receive Cancelled status.

  1. In your Magento 1 backend, go to the MultiSafepay Connect settings.
  2. Link Expired status to Waiting status.
  3. Open app\code\community\MultiSafepay\Msp\Model\Base.php, and then copy the file to the local folder in the Magento structure.
  4. Find the line $order > cancel(); at the expired signal and remove it.

All expired orders retain Waiting status until you cancel them:

  • Manually
  • With a custom cronjob
  • Using a plugin
Configuring generic gateways

The Magento 1 plugin offers 3 generic gateways and 3 generic gift cards. Generic gateways support:

  • All payment methods
  • Refunds
  • Backend orders

You can filter generic gateways by country, and minimum and maximum amount.

To configure generic gateways:

  1. Sign in to your backend.
  2. Go to System > Configuration > MultiSafepay > Connect gateways > Generic 1/2/3.
  3. Set the relevant payment method gateway IDs and the gateway label.
  4. Set how to display the payment method logos.
  5. For pay later methods, set whether to include the shopping cart.
Enabling recurring payments

To enable recurring payments:

  1. Sign in to your Magento 1 backend.
  2. Go to Stores > Configuration > MultiSafepay > MultiSafepay settings.

For more information, see Recurring Payments.

Credit cards Recurring Payments are not available for the generic credit card gateway. You must enable the Visa, Mastercard, and/or Maestro gateways separately. This displays the Save card option at checkout.

Hiding checkout fields

Klarna requires the customer’s gender and date of birth. 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. The customer then enters this information on the MultiSafepay payment page.

This change is only for Magento developers. We recommend testing the change and placing it in your local folder.

To disable Klarna gender and date of birth fields, follow these steps:

  1. Open app\code\community\MultiSafepay\Msp\Model\Gateway\Klarna.php.
  2. Comment this line protected $_formBlockType = 'msp/klarna';
  3. Save the file.
  4. Clear your cache.
  5. Test the change.
Processing refunds

Refund rules

  • From your MultiSafepay dashboard: Full refunds
  • From your Magento 1 backend (see below):
    • Full refunds and credit memos
    • Refunding more than the original transaction is not supported
  • Refunds processed in your MultiSafepay dashboard may not appear in your backend.
  • For pay later methods, you can only refund a selected item from the order, not a set amount. If you enter an amount instead of selecting an item, the entire order is refunded.

To process refunds from your backend, follow these steps:

  1. Sign in to your Magento 1 backend.
  2. Go to System > Configuration > MultiSafepay > Connect settings.
  3. Check that you have:
    • Entered an API key
    • Enabled the Credit Memo option
  4. Search for and open the order you want to refund.
  5. Click the Invoices tab on the left of the Order overview.
  6. Open the invoice, and click Credit memo at the top right of the overview.
  7. Enter the refund amount, and then click Refund online to send the request to MultiSafepay.
Shipping orders

The status of all complete orders automatically changes to Shipped in order to collect funds from pay later payment methods.

Supported checkouts

Our plugin is compatible with most Magento 1 checkouts. However, we cannot guarantee that all checkout features will function properly.

We test our plugin with:

  • Magento 1 core checkout
  • (Idev)
Note: Always test OneStepCheckout before use to make sure it is compatible with your specific configuration of the plugin.
Updating the plugin

There are 3 ways to update the plugin:

  • In your backend
  • In the CMS marketplace
  • Using SFTP

To update the plugin via SFTP, follow these steps:

  1. Make sure you have a backup of your production environment, and that you test the plugin in a staging environment.
  2. From the Magento 1 manual, download the plugin again.
  3. Follow the Installation and configuration instructions from step 2.


Propose a change on GitHubexternal-link-icon or
send an email to [email protected]

Other languages

For an explanation in another language, contact your account manager.