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.

Manual

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.

Introduction

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 https://testmerchant.multisafepay.com/signup
If you would like to set up a live account, please contact the MultiSafepay sales department:

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. Login in your backend and navigate to System -> Configuration -> Cache. Clear your invalid cache
  3. Logout from the backend of your webshop.

3. Configuration

  1. Login into 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 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.

  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

Changelog

FAQ

Available payment methods in Magento 1

Credit cards

Banks

Billing suite

Wallet

Prepaid cards

  • Paysafecard
  • Beauty and Welness gift card
  • Boekenbon
  • Fashion Cheque
  • Fashion gift card
  • Fietsenbon
  • Gezondheidsbon
  • Givacard
  • Goodcard
  • Nationale tuinbon
  • Parfumcadeaukaart
  • Podium
  • Sport en Fit
  • VVV gift card
  • Webshop gift card
  • Wellness gift card
  • Wijncadeau
  • Winkelcheque
  • Yourgift
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.

Steps:

  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, it is possible to set order to Shipped automatically through our API. This is needed to capture the money from AfterPay, E-Invoicing, Klarna, Pay After Delivery and Santander Betaalplan.

Login into the backend of your webshop and navigate to System -> Configuration -> MultiSafepay x.x.x -> Connect Settings. In the specific gateway settings, look for ‘Send shipped status after complete order’. This setting is located at the bottom.

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 How do I get 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 within the Magento 1 backend. See the steps below to perform a refund on a transaction through your Magento 1 backend:

  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, Betaalplan 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.

It is, however, possible to deduct an amount through an API request or from your MultiSafepay Control

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?

Currently we test our plugin at two Magento checkouts:
* Magento 1 core checkout
* OneStepCheckout.com (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.