MultiSafepay plugin for OpenCart


The free plugin to easily integrate MultiSafepay payment solutions into your OpenCart webshop.

Manual

Introduction

This manual helps merchants to process MultiSafepay payments as quickly as possible from a OpenCart 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

  • OpenCart 2.X, 3.X
  • Tested on PHP 7.2, 7.3

2. Installation

  1. Download the Plugin_OpenCart_3.x.x.ocmod.zip.
  2. Login into your backend and navigate to Extensions -> Installer.
  3. Click on the upload button and select in your computer the downloaded file.
  4. Wait until the installation process finish.
  5. Click in the menu item Dashboard.
  6. On the upper right corner of the screen, click on the blue button with a cog wheel icon, and then click on the refresh icon to clean both caches.
  7. Go to Extensions -> Modifications and click on refresh button.
  8. Go to Extensions -> Payments -> MultiSafepay and click in the button with the install icon.
  9. You just installed the plugin. Now you need to configure the settings.

3. Configuration

  1. Login into your backend and navigate to Extensions -> Extensions -> Payments-> MultiSafepay.
  2. On the MultiSafepay configuration page, enter the required information presented on each tab.
  3. You can find your API Key on our API key page
  4. Enable and configure the desired payment methods you wish to offer in Payment Methods tab.
  5. Configure the Order Status tab, matching each possible MultiSafepay callback status with one of the order statuses previously setup on your OpenCart webshop.
  6. Configure the Options tab.

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]

5. Updates

Update the plugin from version 2.3.0 to 3.x.x

  1. Download the Plugin_OpenCart_3.x.x.ocmod.zip.
  2. Before you update the plugin, we strongly recommend have a backup of your production environment
  3. Login into your backend and navigate to Extensions -> Installer.
  4. Click on the upload button and select in your computer the downloaded file.
  5. Wait until the installation process finish.
  6. Click in the menu item Dashboard.
  7. On the upper right corner of the screen, click on the blue button with a cog wheel icon, and then click on the refresh icon to clean both caches.
  8. Go to Extensions -> Modifications and click on refresh button.
  9. Go to Extensions -> Payments -> MultiSafepay and click in the edit button to access the settings page.
  10. You will see a warning notification message, indicating is needed to make some maintenance tasks to delete old plugin files.
  11. Go to Maintenance tab and at the end of the list; click on the button to delete old plugin files.
  12. You just installed the plugin. Now you need to configure the settings.

Update the plugin from version lower or equals than 2.2.1 to 3.x.x

Please contact one of our integration specialist to receive help and guide on this process: [email protected]

Release Notes

See our changelog in GitHub for the plugin

Changelog

FAQ

Available payment methods in OpenCart

Credit cards

Banks

Billing suite

Wallet

Prepaid cards

  • Baby Cadeaubon
  • Beauty & Wellness
  • Boekenbon
  • Fashioncheque
  • Fashiongiftcard
  • Fietsenbon
  • Gezondheidsbon
  • Nationale Tuinbon
  • Parfum Cadeaukaart
  • Paysafecard
  • Podium
  • Sport & Fit
  • VVV Cadeaukaart
  • Webshop Giftcard
  • Wellness gift card
  • Wijncadeau
  • Winkelcheque
  • YourGift
Can I refund orders?

Yes, you can process full refunds from the backend.

In the OpenCart backend navigate to Orders -> Click on the Order View Button -> Order History Panel. In there you will found a button that allows process a full refund of the order.

You can also refund from your MultiSafepay Control

Note: If the order status is not Completed or Shipped, you won’t see the refund button.

Does the plugin supports third party plugins and premium themes?

Currently the plugin supports the OpenCart core checkout and it will be compatible with most of the premium themes, as long as this one has not introduced a custom checkout experience.

At this moment, you can request a patch for the following third party themes - plugins.

If you need support for a third party plugin or premium theme, please let us know. We will do our best.

How can I update the plugin?

Generally, there are three ways to update a plugin for OpenCart. 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 using the extension installer tool in the backend.

  1. Download the Plugin_OpenCart_3.x.x.ocmod.zip.
  2. Before you update the plugin, we strongly recommend have a backup of your production environment
  3. Login into your backend and navigate to Extensions -> Installer.
  4. Click on the upload button and select in your computer the downloaded file.
  5. Wait until the installation process finish.
  6. Click in the menu item Dashboard.
  7. On the upper right corner of the screen, click on the blue button with a cog wheel icon, and then click on the refresh icon to clean both caches.
  8. Go to Extensions -> Modifications and click on refresh button.
  9. Go to Extensions -> Payments -> MultiSafepay and click in the edit button to access the settings page.
  10. You might see a warning notification message, indicating is needed to make some maintenance tasks to delete old plugin files. If there is a notification warning go to Maintenance tab and follow the instructions.
  11. You just update the plugin. Check all the settings, and fill the required fields.
Payment fee / Surcharges

Adding a payment fee or Surcharge is no longer supported within the settings of the MultiSafepay plugin for OpenCart.

However, a patch can be requested. This will allow you to still add a payment fee or surcharge within the desired payment method.

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