MultiSafepay plugin for Shopware 5

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.

The plugin supports generic gateways, e.g. for branded gateways. They work much like other redirect payment methods. All features are supported, except for recurring payments.

1. Sign in to your Shopware 5 backend.
2. Go to the MultiSafepay settings page.
3. Enter the gateway code provided by MultiSafepay.
4. Upload a custom gateway image, if relevant.
5. Specify if the gateway requires a shopping cart or not.

For any questions about integrating generic gateways, email the Integration Team at [email protected]

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 the Integration Team at [email protected]

It can happen that Shopware 5 will remove sessions before the order is created within the Shopware backend. To prevent this from happening we recommend making the following changes to the config.php.

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

This is also explained on the following page: https://developers.shopware.com/sysadmins-guide/sessions/#blocking-transactions

You can process refunds for all Shopware 5 payment methods except pay later methods from your:

Refund rules

• From your MultiSafepay account: Full refunds
• From your Shopware 5 backend:
  • Full refunds
  • Refunding more than the original transaction is not supported
• No refunds for pay later methods

For pay later payment methods, after you ship the order to the customer, you need to change the order status from Completed to Shipped. This prevents the order expiring, and lets the payment method initiate the billing process with the customer and pay the transaction out to your MultiSafepay balance.

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

There are 3 ways to update the Shopware 5 plugin:

• In your Shopware 6 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 2.