Drupal
Technical manual for MultiSafepay's free plugin.
Drupal 8, 9 & 10
Prerequisites
- MultiSafepay account
- Drupal 8.9 and above, Drupal 9.x and 10.x
- Drupal Commerce 2.x
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
- Sign in to your Drupal backend.
- Go to Commerce > Configuration > Payments > MultiSafepay settings.
- Enter your account ID, site ID, and site API key.
- Go to Commerce > Configuration > Payments > Payment gateways.
- 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
- Sign in to your Drupal backend.
- Go to Commerce > Configuration > Payments > Payments gateways > Add payment gateway > Generic gateway.
- Set the relevant payment method gateway IDs and the gateway label.
Payment methods
Supported payment methods
- Cards: All
- Banking methods: All
- BNPL: All, except in3
- Wallets: Alipay, Apple Pay, PayPal
- 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
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.
- Download the plugin again above.
- 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 .
Drupal 7
Prerequisites
- MultiSafepay account
- Drupal 7.x
- Tested on PHP 7.0
Installation and configuration
Ā š” Tip! Make sure you have a backup of your production environment, and that you test the plugin in a staging environment.
- Unpack the content of the .ZIP file in the root of your Drupal 7 webshop.
- Sign in to your Drupal 7 backend.
- Go to Site settings > Modules.
- Enable the Commerce MultiSafepay JSON module, and your selected payment method modules.
- Click Save configuration.
- Go to Store settings > Advanced store settings > Payment methods.
- Enable the
multisafepay
core module. - Enable the modules for each payment method.
- To configure each payment method, under Actions, click the Edit button.
- 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 toprocessing
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.
- MultiSafepay order paid in full: Order state to
User guide
Payment methods
Supported payment methods
- Cards: All
- Banking methods: All, except iDEAL QR and Trustly
- BNPL: E-Invoicing, Klarna, Pay After Delivery
- Wallets: Alipay, Apple Pay, PayPal
- Prepaid cards:
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.
- Download the plugin again above.
- Follow the Installation and configuration instructions from step 2.
Support
Contact MultiSafepay:
- Telephone: +31 (0)20 8500 500
- Email: [email protected]
- GitHub: create a technical issue
Updated about 1 month ago