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.
Versions
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.
Support
Contact us:
- Telephone: +31 (0)20 8500 500
- Email: [email protected]
- GitHub: Create a technical issue
Requirements
- MultiSafepay account – See Getting started.
- Drupal 8.9 and above or Drupal 9.x
- Tested on PHP 7.2
- Drupal Commerce 2.x
Supported payment methods
Credit and debit cards
- American Express
- Mastercard
- Maestro
- Visa, including Cartes Bancaires, Dankort, and V Pay
Banking methods
- Bancontact
- Bank Transfer
- Belfius
- CBC/KBC
- Dotpay
- EPS
- Giropay
- iDEAL and iDEAL QR
- Request to Pay
- SEPA Direct Debit
- Sofort
- Trustly
- TrustPay
Pay later methods
Wallets
Prepaid cards
- Beauty and Wellness gift card
- Boekenbon
- Fashioncheque
- Fashion gift card
- Fietsenbon
- Gezondheidsbon
- Nationale tuinbon
- Parfumcadeaukaart
- Paysafecard
- Podium
- Sport en Fit
- VVV gift card
- Webshop gift card
- Wellness gift card
- Wijncadeau
- Winkelcheque
- Yourgift
See also MultiSafepay gateway.
Installation
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.
Configuration
- Sign in to the backend of your webshop.
- Go to Commerce > Configuration > Payments > MultiSafepay settings.
- 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.
- Go to Commerce > Configuration > Payments > Payment gateways.
- 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:
- Sign in to your backend.
- Go to Commerce > Configuration > Payments > Payments gateways > Add payment gateway > Generic gateway.
- 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:
- Make sure you have a backup of your production environment, and that you test the plugin in a staging environment.
- From the Drupal 8 manual, download the plugin again.
- Follow the Installation and configuration instructions from step 2.
Feedback
Propose a change on GitHub
or
send an email to [email protected]
Other languages
For an explanation in another language, contact your account manager.