MultiSafepay plugin for Shopware 6

This technical manual is for installing and configuring our free plugin for integrating MultiSafepay payment solutions into your Shopware 6 webshop.


Contact us:

For support for Shopware 6 Professional/Enterprise, email [email protected]


Installation and configuration

We recommend first installing the plugin in a test environment following, the recommended Shopware 6 installation procedure. Make sure you have made a backup.
  1. Navigate to our Shopware 6 GitHub repository.
  2. Under Assets, download the latest release, which starts with
  3. Sign in to your Shopware 6 backend.
  4. Go to Settings > System on the left hand side.
  5. Select Plugins.
  6. Click Upload plugin at the top of the page, and then select the file you downloaded in step 2.
  7. When the plugin appears, make sure the Activated button is toggled.
  8. Click the (more) button, and then select Config.
  9. In the drop-down menu, select Test.
  10. In the API key field, enter your API key.
  11. Fill out the other fields as required.

Marketplace installation

Get the free MultiSafepay plugin from the Shopware 6 marketplace and connect your webshop with your Shopware account.

Composer installation

Run the following command in the root of your Shopware root directory. Make sure the composer is installed on your hosting server.

composer require multisafepay/shopware6

User guide

Configuring generic gateways

The Shopware 6 plugin supports generic gateways.

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 MultiSafepay settings.
  3. Set the relevant payment method gateway IDs.
Enabling recurring payments

You need to enable recurring payments in your MultiSafepay dashboard and then in the gateway settings.

Processing refunds

Refund rules

To process refunds from your backend, follow these steps:

  1. In your Shopware 6 backend, go to the Order details page.
  2. In the Refund field, enter the refund amount.
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 Shopware 6 manual, download the plugin again.
  3. Follow the Installation and configuration instructions from step 3.


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.