Drupal

Technical manual for MultiSafepay's free plugin.

Drupal 8 & 9

Prerequisites

Installation

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

These instructions are for Composer. You can also install the plugin in your backend.

To install the latest stable version of the Drupal Commerce 2.x plugin, run the following command in your terminal:

composer require drupal/commerce_multisafepay_payments

Configuration

  1. Sign in to your Drupal backend.
  2. Go to Commerce > Configuration > Payments > MultiSafepay settings.
  3. Enter your account ID, site ID, and site API key.
  4. Go to Commerce > Configuration > Payments > Payment gateways.
  5. Configure the options for all supported payment methods activated in your MultiSafepay dashboard .


User guide

Generic gateways

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

Supported since release: 3.0.0, March 19th 2021.

How to configure generic gateways
  1. Sign in to your Drupal backend.
  2. Go to Commerce > Configuration > Payments > Payments gateways > Add payment gateway > Generic gateway.
  3. Set the relevant payment method gateway IDs and the gateway label.

Payment methods

Supported payment methods

Refunds

Full refunds are supported in your MultiSafepay dashboard and backend.
You can't refund more than the original amount in your backend.

Updates

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

How to update in your backend

✅   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 instructions and the Configuration instructions from step 2.

Upgrades

❗️ Note: Drupal no longer provides support for Drupal 8.9.x.

For how to upgrade Drupal 8 to Drupal 9, see Drupal - Upgrading from Drupal 8 to Drupal 9 or higher .

Top of page


Drupal 7

Prerequisites

Installation and configuration

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

  1. Unpack the content of the .ZIP file in the root of your Drupal 7 webshop.
  2. Sign in to your Drupal 7 backend.
  3. Go to Site settings > Modules.
  4. Enable the Commerce MultiSafepay JSON module, and your selected payment method modules.
  5. Click Save configuration.
  6. Go to Store settings > Advanced store settings > Payment methods.
  7. Enable the multisafepay core module.
  8. Enable the modules for each payment method.
  9. To configure each payment method, under Actions, click the Edit button.
  10. When the main module is installed, two rules are created but disabled by default:
    • MultiSafepay order paid in full: Order state to processing
      This rule sets the order to processing when the order is paid in full.
    • MultiSafepay order complete: Shipped at MultiSafepay
      This rule updates the transaction status to Shipped at MultiSafepay. For Pay After Delivery, Klarna, and E-Invoicing, this triggers the invoicing process.


User guide

Payment methods

Supported payment methods

Refunds

Full refunds are supported in your MultiSafepay dashboard and backed.
Refunding more than the original amount is not supported in your backend.

Updates

You can update the plugin in your backend or 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