MultiSafepay plugin for Craft Commerce

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

You can also install the plugin via the Craft Plugin Store.



  • Support for separate payment methods, pay later methods, and gift cards
  • Partial and full refunds for all payment methods, except pay later
  • Customizable order statuses
  • Shipment notifications for pay later methods



  • Craft CMS version 3.2 or higher
  • PHP 7.0 and higher
  • Tested with PHP 7.0


Contact MultiSafepay:

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


Run the following commands in the CLI:

composer require multisafepay/craft-commerce
./craft plugin/install multisafepay

The latest stable release is downloaded and installed in your Craft Commerce webshop.


  1. Sign in to the backend of your Craft Commerce webshop.
  2. To configure the plugin settings, go to MultiSafepay > Settings.
  3. To add payment methods activated in your MultiSafepay account and configure gateways, go to Commerce > System settings > Gateways.

User guide

Configuring generic gateways

The Craft Commerce 3 plugin offers generic gateways and generic gift cards, which support all payment methods.

To configure a generic gateway:

  1. Sign in to your backend.
  2. Go to Commerce > System settings > Gateways > + New gateway.
  3. From the Gateway list, select Generic gateway.
  4. Set the relevant payment method gateway IDs and the gateway label.
Processing refunds

Refund rules

  • From your MultiSafepay dashboard: Full and partial refunds
  • From the Craft CMS admin panel (see below):
    • Full and partial refunds
    • Refunding more than the original transaction is not supported
  • Via our API: Refund order > Pay later refund
  • No refunds for pay later methods
  • Discounts not supported

To process refunds from the Craft Commerce admin panel:

  1. Go to Commerce > Orders.
  2. Select the order.
  3. To see the refund options, go to the Transactions tab.

For generic gateway transactions, you can only process refunds via your MultiSafepay dashboard.

Support for Craft Commerce 2

For support for Craft Commerce 2, email [email protected]


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.