MultiSafepay plugin for PrestaShop 1.7


This technical manual is for installing and configuring our free plugin for integrating MultiSafepay payment solutions with your Prestashop 1.7 webshop.

Test environment


We recommend first installing the plugin in a test environment following the recommended PrestaShop 1.7 installation procedure. Make sure you have made a backup.

Support

Contact us:

  • Telephone: +31 (0)20 8500 500
  • Email: [email protected]
  • GitHub: Create a technical issue

Requirements

  • MultiSafepay account – See Getting started.
  • PrestaShop 1.7.6 or higher
  • Tested on PHP 7.2

If you’re on PrestaShop 1.7.5 or lower, consider updating PrestaShop or use an older version (4.x) of our plugin which can be found in our PrestaShop GitHub repository.

Supported versions

  • 1.7.6
  • 1.7.7
  • 1.7.8

To use an older version of the plugin, see MultiSafepay GitHub – PrestaShop releases.

Upgrading to version 5.x from an older version

When you update from an older version of the plugin to 5.x, keep the older version installed until you are sure that orders created with the new plugin are successfully processed.

Switching to the new plugin

  1. Go to Modules > Module Manager > MultiSafepay > Configure.
  2. Open the Payment Methods tab.
  3. Set all Payment Methods to off.
  4. Open the Giftcards tab.
  5. Set all gift cards to off.
  6. Install and configure the new plugin following the instructions below.
  7. Don’t uninstall the older plugin until you are sure that orders created with the new plugin are successfully processed

Installation

  1. Sign in to your PrestaShop 1.7 backend.
  2. Go to Modules > Module Manager.
  3. Click Upload a module.
  4. Select the Plugin_PrestaShop.zip file, and then click Configure.

Configuration

  1. Sign in to your PrestaShop 1.7 backend.
  2. Go to IMPROVE > MultiSafepay.
  3. Enter your API key.

    Information on where to find your Account ID, Site ID, Site code or API key can be found on our API key page.

  4. On the Payment methods tab, enable the relevant payment methods.
  5. Click Save.

User guide

Applying surcharges

Applying surcharges or payment fees is not automatically supported in our PrestaShop 1.7 plugin.

Support
The Integration Team will do their best to support you, but bear in mind that it is a third-party package. We can’t guarantee perfect compatibility.

PSD2 implications
For more information about how the Payment Services Directive 2 may affect surcharges or payment fees, see Payment Services Directive 2.

Configuring generic gateways

The PrestaShop 1.7 plugin supports a generic gateway for all payment methods.

To configure the generic gateway, follow these steps:

  1. Sign in to your PrestaShop backend.
  2. Go to IMPROVE > MultiSafepay -> Payment methods. All payment methods are listed here.
  3. Select Generic gateway and set:
    • Gateway code
    • Gateway icon
  • You can filter the generic gateway by:
    • Country
    • Currency
    • Customer group
    • Minimum amount
    • Maximum amount
Enabling recurring payments

To enable recurring payments, follow these steps:

  1. Sign in to your PrestaShop 1.7 backend.
  2. Go to IMPROVE > MultiSafepay.
  3. Select the payment method for which you want to enable recurring payments
  4. Set the Enable tokenization field to ENABLED.
  5. Click Save.
Processing refunds

Refund rules

  • From your MultiSafepay account: Full refunds
  • From your Prestashop 1.7 backend:
    • Full refunds
    • Refunding more than the original transaction is not supported
Updating the plugin

There are 3 ways to update the plugin:

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

To update the plugin in your backend, 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 PrestaShop 1.7 manual and download the plugin again.
  3. Follow the Installation and configuration instructions from step 2.

Feedback

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.