MultiSafepay plugin for Drupal 8 and 9

This technical manual is for installing and configuring our free plugin for integrating MultiSafepay payment solutions into your Drupal 8 webshop via Composer.

You can also install the plugin via your Drupal 8 & 9 backend.


Drupal no longer provides security updates for Drupal 8.9.x, and will only provide bugfix support until early 2021 and security fixes until November 2021.

For more information about upgrading from Drupal 8 to Drupal 9, see Drupal - Upgrading from Drupal 8 to Drupal 9 or higher.


Contact us:

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



  • MultiSafepay account – See Getting started.
  • Drupal 8.9 and above or Drupal 9.x
  • Tested on PHP 7.2
  • Drupal Commerce 2.x


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

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

composer require drupal/commerce_multisafepay_payments

The latest stable release is downloaded and installed in your Drupal Commerce 2.x webshop.


  1. Sign in to the backend of your webshop.
  2. Go to Commerce > Configuration > Payments > MultiSafepay settings.
  3. Enter your account ID, site ID, site code or 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. Go to Commerce > Configuration > Payments > Payment gateways.
  5. Configure the options for all supported payment methods activated in your MultiSafepay dashboard.

User guide

Configuring generic gateways

The Drupal 8 & 9 plugin offers generic gateways that support all payment methods.

You can filter generic gateways by country, and minimum and maximum amount.

To configure a generic gateway:

  1. Sign in to your 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.
Processing refunds

Refund rules

  • From your MultiSafepay dashboard: Full refunds
  • From your Drupal 8 or 9 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 Drupal 8 manual, download the plugin again.
  3. Follow the Installation and configuration instructions from step 2.


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.