MultiSafepay plugin for PrestaShop 1.7


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

If you are still using the deprecated plugin, we recommend migrating to this new version as soon as possible.
Support

Contact us:

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

Requirements

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

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.

Important change: In the previous version of the plugin, PrestaShop backend orders were only created for MultiSafepay orders with Completed status. Now, a backend order is created for every order attempt, that is for MultiSafepay orders with Initialized status.

Installation

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.
  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.
  5. Clear your cache.

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.

Upgrading from 4.x or lower

To upgrade to version 5.x from an older version, follow these steps:

  1. Go to Modules > Module manager > MultiSafepay > Configure.
  2. On the Payment methods tab, set all payment methods to Off.
  3. On the Gift cards tab, set all gift cards to Off.
  4. Install and configure the new plugin following the instructions below.
  5. Only uninstall the older plugin when you’re sure that orders created with the new plugin are being processed successfully.

If upgrading from 5.x to a newer version, see Updating the plugin.

User guide

Activating Payment Components

The MultiSafepay PrestaShop 1.7 plugin supports Payment Components, which:

  • Provide a seamless checkout experience to increase conversion.
  • Encrypt customer payment details for secure processing.
  • Shift responsibility for PCI DSS compliance to MultiSafepay.

If you’re new to accepting credit card payments, email a request to activate them to [email protected]

Activating Payment Components

To activate the payment component in your PrestaShop 1.7 backend, follow these steps:

  1. Sign in to your PrestaShop 1.7 backend.
  2. Go to MultiSafepay module > Payment methods > Credit card.
  3. Slide the Enable payment component radio button to Enabled.
  4. Click Save config.

For support, email [email protected]

Note: If you have a custom checkout and encounter a conflict with the payment component, the Integration Team will do their best to provide support, but we can’t guarantee compatibility in all cases.

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).

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

Support
There are several third-party addons available for surcharges. However, we can’t guarantee compatibility with our plugin. Make sure that you test these addons carefully before installing.

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 offers a generic gateway that supports all payment methods. You can filter the gateway by:

  • Country
  • Currency
  • Customer group
  • Minimum and maximum amount

To configure the generic gateway:

  1. Sign in to your backend.
  2. Go to Improve > MultiSafepay > Payment methods > Generic gateway.
  3. Set the relevant payment method gateway IDs and the gateway icon.
Disabling refunds

By default, refunds initiated in your PrestaShop backend are automatically processed via our API.

To disable this, follow these steps:

  1. Sign in to your PrestaShop 1.7 backend.
  2. Go to MultiSafepay module > Manage hooks.
  3. Select Display non-positionable hooks.
  4. For actionOrderSlipAdd, select the three dots, and then click Unhook.
Disabling the shopping cart

If you notice errors in shopping cart calculations, email [email protected]

As a temporary solution, you can disable sending the shopping cart with the payment request.

Note: Pay later methods do not work if the shopping cart is disabled.
  1. Sign in to your PrestaShop 1.7 backend.
  2. Go to Improve > Module manager > MultiSafepay.
  3. In the MultiSafepay module, go to the General settings tab.
  4. Set the Disable Shopping Cart toggle to Enabled.
  5. Click Save.
Enabling Recurring Payments

To enable Recurring Payments, follow these steps:

  1. Sign in to your PrestaShop 1.7 backend.
  2. Go to Improve > Module manager > MultiSafepay.
  3. In the MultiSafepay module, go to the Payment methods tab.
  4. Select either the bundled credit cards gateway, or select specific credit cards.
  5. Set the Enable tokenization toggle to Enabled.
  6. Click Save.
Processing refunds

Refunds

Refunds initiated in your PrestaShop backend are automatically processed via our API, except for voucher refunds.

Supported checkouts and themes

The plugin supports the PrestaShop core checkout and is compatible with most premium themes, unless you have a custom checkout.

The following third-party modules are supported:

* Payment options must be set on separate pages in the plugin settings page.

The Integration Team will do their best to provide support for third-party plugins and premium themes. Email us at [email protected]

Translating the MultiSafepay module

To translate elements of the MultiSafepay module in the PrestaShop 1.7 plugin, follow these steps:

  1. Sign in to your PrestaShop 1.7 backend.
  2. Go to Improve > International > Translations.
  3. On the Modify translations tab, from the Type of translation list, select Installed module translations.
  4. Select the MultiSafepay module.
  5. Select the Language.
  6. Click Modify.
  7. Enter the required translations.
  8. Click Save.

To translate the names of payment methods:

  1. Go to Improve > MultiSafepay > Payment methods.
  2. Select the payment method you want to translate.
  3. Make sure the Title field is empty.
Updating the plugin

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, download the plugin again.
  3. Follow the Installation instructions.

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.