Shopware 5

Prerequisites

• MultiSafepay account
• Shopware 5.6.x and 5.7.x.
• Tested on Shopware 5.7.11 and PHP 8.0

Installation and configuration

✅   Tip! We recommend first installing the plugin in a test environment, following the Shopware 5 installation procedure. Always make a backup.

1. Sign in to your Shopware 5 backend.
2. Go to Configuration > Plugin manager.
3. Search for the MultiSafepay plugin, and then click Download now.
4. Go to Configuration > Plugin manager > Installed.
5. Search for the installed MultiSafepay plugin, and then click the Edit pencil icon.
6. In the API key field, enter your API key.
7. Fill out the other fields as required.
8. Go to Configuration and select the required payment methods.
   
   

---

User guide

Enabling and disabling payment methods

Once the plugin is initially installed, reinstalling becomes necessary to manage the listing or delisting of enabled and disabled payment methods.

Please follow the first four steps described in the installation and configuration process, then proceed to the fifth one, where you will find the Reinstall icon for clicking.

Backend orders

To create backend orders in the MultiSafepay Shopware 5 plugin, Shopware uses a third-party plugin.

See shopwareLabs GitHub – SwagBackendOrder .

We support V2.x versions.

Order flows

The plugin supports two flows for creating orders: before or after the transaction is completed.

Before flow

By default, order confirmation emails are sent before the payment is finalized.
You can disable this feature.

The status of abandoned payments changes to Cancelled.

After flow

Orders are created via a MultiSafepay notification to Shopware 5 using the transaction ID. After completing payment, the customer is redirected to your order confirmation page.

How to switch order flows

To change the flow you are using, follow these steps:

1. Sign in to your Shopware 5 backend.
2. Go to Configuration > Plugin manager > Installed.
3. Search for the installed MultiSafepay plugin, and then click the Edit pencil icon.
4. Click the dropdown icon to select the relevant status in the Status fields.
5. Click Save.

Payment methods

By default, activated payment methods from your MultiSafepay account appear on the payment method list.

Supported payment methods

• Cards: All
• Banking methods: All
• BNPL: All
• Wallets: Alipay, Apple Pay, PayPal
• Prepaid cards:
  • Beauty and Wellness gift card
  • Boekenbon
  • Fashioncheque
  • Fashion gift card
  • Fietsenbon
  • Gezondheidsbon
  • Good4fun
  • Nationale tuinbon
  • Parfumcadeaukaart
  • Paysafecard
  • Podium
  • Sport en Fit
  • VVV gift card
  • Webshop gift card
  • Wellness gift card
  • Wijncadeau
  • Winkelcheque
  • Yourgift

Refunds

You can process full refunds for all Shopware 5 payment methods except BNPL from your MultiSafepay dashboard and backend.
You cannot refund more than the original amount in your backend.

Session data

Shopware 5 can remove sessions before the order is created in the backend.
To prevent this, we recommend making the following changes to the config.php .

'session' => [
    'save_handler' => 'db',
    'gc_probability' => 0,
    'gc_divisor' => 1000
],

For more information, see Shopware – Blocking transactions .

Shipping orders

For BNPL orders, after shipment, you must change the order status from Completed to Shipped. This prevents the order expiring and triggers invoicing.

If you change the order status to Delivered in your backend, the updated status is passed to your MultiSafepay dashboard automatically.

Transaction and order numbers

Shopware 5 generates an order number and a transaction number.

The order number is generated after the payment is completed (unlike most ecommerce integrations where it is generated at the beginning of the order).

The transaction number is generated when the transaction is initialized. MultiSafepay uses this number as the order ID in transactions.

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.

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

Upgrading to Shopware 6

How to upgrade to Shopware 6

About Shopware 6
Shopware 6 is the latest version of the Shopware ecommerce platform. It maintains simplicity, but features a great new interface and functionalities, including:

• Sales Channels function that links to social shopping platforms (e.g. Facebook, Instagram), and supports mobile apps and POS systems
• Rule Builder that lets you set price rules per country, and supports multi-currency options, VAT rules, and delivery options, e.g. free delivery for orders above a specified amount
• Content management function that uses stylized blocks on Experience and Storytelling pages
• Text editor that is easier and more user-friendly

Shopware 5 phase out

Support for Shopware 5 will be phased out as follows:

1. General support until mid-2024
2. Regular functional releases until mid-2021
3. Bug fixes and small releases until mid-2023
4. Security updates until mid-2024

MultiSafepay will continue to support Shopware 5 as long as it remains in the market.

Migrating to Shopware 6

For instructions, see the Shopware migration manual .

For questions, email [email protected]

---

Top of page