MultiSafepay plugin for PrestaShop 1.6


Note: We are phasing out support for our Prestashop 1.6 plugin. We recommend migrating to our Prestashop 1.7 plugin as soon as possible.

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

Test environment


We recommend first installing the plugin in a test environment following the recommended PrestaShop 1.6 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.6
  • Tested on PHP 7.0

Installation and configuration

  1. Unpack the contents of the .zip archive and upload the Modules folder via SFTP to the PrestaShop root directoy, merging the two folders.
  2. Sign in to your PrestaShop 1.6 backend.
  3. Go to Modules and services > Payments and gateways.
    Note: You must install and configure the MultiSafepay Core Module (MultiSafepay) because all payment methods require certain settings and/or the API key in the core module.
  4. In the next screen, proceed with the installation.
  5. Enter your API key, and then click Save.

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

  6. On the Payments tab, enable the relevant payment methods.

Note: Payment links generated manually in your MultiSafepay account don’t automatically create or update orders in your PrestaShop 1.6 backend.

User guide

Applying surcharges

Applying surcharges or payment fees is not automatically enabled in our PrestaShop 1.6 plugin.

Using BVK
To apply a surcharge or payment fee to a payment method, you can use the third-party BVK package.

Support
The Integration Team will do their best to support you with installing BVK, 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.

Enabling recurring payments

To enable recurring payments, follow these steps:

  1. Sign in to your PrestaShop 1.6 backend.
  2. Go to Modules and services > Modules and services > MultiSafepay.
  3. Click Configure.
  4. Set the Tokenization field to YES.
  5. Click Save.
Matching orders

In Prestashop 1.6, the order ID is generated after the payment, which causes a mismatch with the order ID in your MultiSafepay account.

You can match orders using the transaction ID.

To view a payment’s transaction ID:

  1. Sign in to your Prestashop 1.6 backend.
  2. Go to Payment > Order details.
Processing refunds

Refund rules

Skipping the extra confirmation page

PrestaShop 1.6 version 3.1.7 lets you skip the extra confirmation page so that the customer is redirected straight to the MultiSafepay payment page.

This is no longer supported from version 3.2.0. If you want to skip the extra confirmation page, you can download version 3.1.7. New features might be lost when downgrading.

Support for Thirty Bees

For support for the Prestashop thirty bees fork, email the Integration Team at [email protected]

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 PrestaShop 1.6 manual, 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.