Shopware 6 plugin


This technical manual is for installing and configuring MultiSafepay’s free plugin for integrating with Shopware 6.

Requirements

Support

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 Shopware 6 installation procedure. Always make a backup.
  1. Navigate to our Shopware 6 GitHub repository.
  2. Under Assets, download the latest release, which starts with Plugin_Shopware6_x.x.x.zip.
  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

Generic gateways

The plugin supports generic gateways, which redirect customers from your checkout to a MultiSafepay payment page. You can use them to integrate custom gift cards, or co-branded credit cards.

Configuring generic gateways

  1. Sign in to your Shopware 6 backend.
  2. Go to MultiSafepay settings.
  3. Set the relevant payment method gateway IDs.

Generic gateways support:

Gift cards

Generic gateways are particularly useful for integrating gift cards, including custom gift cards. This is because we don’t support all open-loop gift cards in our ready-made integrations and no closed-loop gift cards.

Co-branded credit cards

You can integrate Visa co-branded credit cards (Cartes Bancaires, Dankort, and V Pay), using the generic VISA gateway.

For the logo, see MultiSafepay GitHub – MultiSafepay icons.

Payment methods

Payment methods

Recurring payments

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

Refunds

Full and partial refunds except for pay later methods are supported in your MultiSafepay dashboard and backend.
You cannot refund more than the original amount in your backend.

Processing backend refunds

  1. In your Shopware 6 backend, go to the Order details page.
  2. In the Refund field, enter the refund amount.

Updates

You can update the plugin in your backend and the CMS marketplace, or via using SFTP.

Updating in your backend

Note: Make sure you have a backup of your production environment, and that you test the plugin in a staging environment.

  1. Download the plugin again above.
  2. Follow the Installation and configuration instructions from step 3.

Feedback

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.