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.

Test environment

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


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


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

User guide

Configuring generic gateways

The MultiSafepay plugin for Drupal 8 & 9 supports generic gateways.

Configuring generic gateways

Go to Commerce > Configuration > Payments > Payments gateways > Add payment gateway > Generic gateway.

All MultiSafepay payment methods are supported. You can specify the gateway code and the gateway label.

Processing refunds

Refund rules

  • From your MultiSafepay account: 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.