PrestaShop 1.6

Technical manual for MultiSafepay's free plugin.

⚠️

Action required

We are phasing out support for this plugin. We recommend migrating to our PrestaShop 1.7 plugin as soon as possible.

Prerequisites

Installation and configuration

✅   Tip! We recommend first installing the plugin in a test environment, following the PrestaShop 1.6 installation procedure. Always make a backup.

  1. Unpack the contents of the .zip archive and upload the Modules folder via SFTP to the PrestaShop root directory, 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.
  6. On the Payments tab, enable the relevant payment methods.


User guide

Generic gateways

The plugin supports generic gateways, which let you add payment methods manually. This is particularly useful for integrating gift cards specific to your business.

How to configure generic gateways
  1. Sign in to your PrestaShop 1.6 backend.
  2. Go to Modules and services.
  3. Search for "generic gateway", select gateway 1, 2, or 3, and then click Install.
  4. In the Gateway title field, enter the name of the payment method.
  5. In the Gateway ID field, enter the gateway ID.
  6. Optionally:
  7. Click Save.

✅   Success! The payment method is now active.

Payment methods

Supported payment methods

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 dashboard. You can match orders using the transaction ID.

How to view transaction IDs
  1. Sign in to your PrestaShop 1.6 backend.
  2. Go to Payment > Order details.

Payment components

The 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.
Supported payment methods
How to activate payment components
  1. Sign in to your PrestaShop 1.6 backend.
  2. Go to Modules and services
  3. Select the relevant payment methods.
  4. Set the Use Payment component toggle to Yes.
  5. Click Save.

💬 Support: If you're new to accepting card payments, email a request to activate them to [email protected]

Payment links

Payment links generated manually in your MultiSafepay dashboard don't automatically create or update orders in your PrestaShop 1.6 backend.

Recurring payments

Recurring payments are supported.

How to enable recurring payments
  1. Sign in to your PrestaShop 1.6 backend.
  2. Go to Modules and services > Modules and services
  3. Select either the bundled card payments gateway, or select specific card.
  4. Click Configure.
  5. Set the Tokenization field to Yes.
  6. Click Save.

Refunds

You can process full and partial refunds from your MultiSafepay dashboard.
Backend refunds are not supported.

Surcharges

Surcharges are not supported by default.

Applying surcharges with BVK

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

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.

⚠️

Attention Dutch merchants

We strongly recommend not applying surcharges to BNPL 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).

Thirty Bees

For support for the PrestaShop Thirty Bees fork, email [email protected]

Updates

You can update the plugin in your backend and the CMS marketplace, or via SFTP.

How to update via SFTP

✅   Tip! Make sure you have a backup of your production environment, and that you test the plugin in a staging environment.

  1. Download the plugin again above.
  2. Follow the Installation and configuration instructions from step 2.


💬

Support

Contact MultiSafepay:

Top of page