Shopware 6

On this page, you will learn how to install the official plugin for Shopware 6 and connect Payrexx with your webshop.

Available for versions 6.6.5 - 6.7.x

General Information

Shopware 6 is an e-commerce platform developed in Germany that enables merchants to create and manage their own online store.

Links

• Login to Shopware

• Registration with Shopware

• Shopware Website

• Shopware Documentation

• Plugin Download

Features

• ✅ Multi-currency support

• ✅ Payment method logos in checkout

• ✅ Cart transfer functionality

• ✅ Webhook support

• ✅ Look & feel customization

• ✅ Custom payment method configuration

• ❌ Subscription support

Please note that integration with Shopware 6 is only available in the Standard and Premium plans. For more information

Payment methods

The following payment methods are supported by the Shopware 6 plugin:

Payrexx Pay	Payrexx Pay Plus	External Payment Providers
Mastercard	Mastercard	Masterpass
Visa	Visa	PayPal
PostFinance Pay	American Express	Maestro
TWINT	Diners Club International	HeyLight
Google Pay	Discover Card	Swissbilling
Pay by Bank	Apple Pay	WIRpay
Purchase on Invoice	Google Pay	Barzahlen/viacash
Reka	Klarna	giropay
Centi	eps	Paysafecash
Crypto	Bancontact	JCB
	iDEAL	Bitcoin
	SEPA Debit Direct	Advance Payment
		Bill
		POWERPAY
		CembraPay
		VERD

Setup

Follow the instructions below to integrate Payrexx into Shopware 6. If you are still using Shopware 5, please refer to the corresponding guide.

Plugin installation

Download the latest plugin from GitHub by clicking on "PayrexxPaymentGatewaySW6.zip":

Download the plugin for integrating Payrexx into Shopware

Configuration of Payrexx

Make sure you're logged in to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can register now.

• Navigate to the API & Plugins section in the merchant administration of your Payrexx account.

• Click on "Show All" below "Add E-Commerce Integration".

• Click on "Add" next to Shopware 6:

Generating an API Key for Shopware 6

• In the window below, apply the following settings:

Configuring the connection between Shopware 6 and Payrexx

1. API Key: Copy the displayed API key to your clipboard, as you will need it later.

2. Instance Name: Copy the displayed instance name to your clipboard, as you will also need it later.

3. Enter shop address: In this field, enter the URL of your shop. If your shop is not located in the root directory (e.g., https://my-shop.com) but in a subdirectory, please enter the full path to your shop. Example: https://my-shop.com/shop

Please ensure that the shop URL is entered correctly. Any discrepancies (e.g. using http:// instead of https://) may cause errors when processing webhooks.

1. Webhooks: Define whether a failed webhook should be retried. If the checkbox is activated, the system will attempt to resend the webhook up to 10 times. The retry intervals are as follows: 5 minutes, 15 minutes, 1 hour, 2 hours, 4 hours, and then every 24 hours.

2. Finalize: Click the green "Activate" button to complete the configuration.

Configuration of Shopware 6

Connect to Payrexx

• In Shopware, navigate to Settings.

• Under "Extensions", click on "Payrexx Payments":

Opening the Payrexx Settings in Shopware 6

The connection with Payrexx can be established either automatically or manually.

Establish connection automatically

1. Make sure that the option "All Sales Channels" is selected.

If you use multiple sales channels in Shopware 6, you can configure each channel individually. To do this, select a channel from the dropdown, adjust the settings, save them, and then configure the next sales channel.

1. Make sure the correct platform is selected.

2. Click the blue "Connect with payrexx.com button":

Automatic connection between Shopware 6 and Payrexx

• Log in to your Payrexx account using your credentials:

Login to Payrexx

• Select the Payrexx account you want to connect with Shopware 6:

Selecting the Payrexx instance to connect

Payrexx and Shopware 6 have been successfully connected.

Establish connection manually

Configure the following settings:

1. Ensure that the option All Sales Channels is selected.

If you use multiple sales channels in Shopware 6, you can configure each channel individually. To do this, select a channel from the dropdown, adjust the settings, save them, and then configure the next sales channel.

1. Make sure the correct platform is selected.

2. Enter the instance name of your Payrexx account. The instance name corresponds to the first part of your Payrexx URL. For example, if the URL is example.payrexx.com, the instance name is example.

3. Enter the API key that was displayed during the configuration of Payrexx.

Manual connection between Shopware 6 and Payrexx

• Click the "Save" button at the top of the window:

Save settings and establish connection

Payrexx and Shopware 6 have been successfully connected.

Look & Feel ID: Enter the ID of the Payrexx Look & Feel profile you want to use. This is optional.

Select payment methods

To specify which payment methods you want to offer your shop customers, follow these steps:

• In the main menu of Shopware 6, under "Sales Channels", click on Payrexx.

• In the "General" tab, scroll down to the "Payment and shipping" section.

• Click in the empty area below "Payment methods" and select any number of payment methods from the list:

Selecting payment methods in Shopware 6

• Click "Save" at the top of the screen to complete the payment method configuration:

Saving payment methods in Shopware 6

Plugin Update

To update the Shopware 6 plugin to the latest version, please follow these steps:

• Download the ZIP file of the latest plugin version:

Download the latest plugin version

• Log in to the administration area of your Shopware 6 account.

• Navigate to Extensions > My Extensions in the main menu.

• Deactivate the current Payrexx integration:

Deactivation of the current Payrexx integration

• Click on "Upload extension" and upload the ZIP file of the latest plugin version:

Upload of the latest plugin version in Shopware 6

• Activate the plugin after the update.