# Shopware 6 {% hint style="info" %} Available for versions 6.6.5 - 6.7.x {% endhint %} ## 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](https://auth.shopware.com/login) to Shopware * [Registration](https://auth.shopware.com/registration) with Shopware * Shopware [Website](https://www.shopware.com/en/) * Shopware [Documentation](https://docs.shopware.com/en/shopware-6-en) * [Plugin](https://github.com/payrexx/shopware6-payrexx-gateway/releases) Download ### Features * ✅ Multi-currency support * ✅ Payment method logos in checkout * ✅ Cart transfer functionality * ✅ Webhook support * ✅ Look & feel customization * ✅ Custom payment method configuration * ❌ Subscription support {% hint style="info" %} Please note that integration with Shopware 6 is only available in the Standard and Premium plans. [For more information](https://payrexx.com/en/prices) {% endhint %} ### Payment methods The following payment methods are supported by the Shopware 6 plugin:
Payrexx PayPayrexx Pay PlusExternal 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](https://docs.payrexx.com/merchant/english/integration/e-commerce/shopware-5). ### Plugin installation Download the latest [plugin](https://github.com/payrexx/shopware6-payrexx-gateway/releases/tag/v1.0.42) from GitHub by clicking on "PayrexxPaymentGatewaySW6.zip":

Download the plugin for integrating Payrexx into Shopware

### Configuration of Payrexx {% hint style="info" %} Make sure you're [logged in](https://login.payrexx.com/) to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can [register](https://signup.payrexx.com/) now. {% endhint %} * 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., ) but in a subdirectory, please enter the full path to your shop. Example: {% hint style="warning" %} Please ensure that the shop URL is entered correctly. Any discrepancies (e.g. using http\:// instead of https\://) may cause errors when processing webhooks. {% endhint %} 4. **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. 5. **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. {% hint style="info" %} 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. {% endhint %} 2. Make sure the correct platform is selected. 3. 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

{% hint style="success" %} Payrexx and Shopware 6 have been successfully connected. {% endhint %} **Establish connection manually** Configure the following settings: 1. Ensure that the option All Sales Channels is selected. {% hint style="info" %} 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. {% endhint %} 2. Make sure the correct platform is selected. 3. 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*. 4. Enter the API key that was displayed during the [configuration of Payrexx](#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

{% hint style="success" %} Payrexx and Shopware 6 have been successfully connected. {% endhint %} {% hint style="info" %} **Look & Feel ID:** Enter the [ID](https://docs.payrexx.com/merchant/english/account/settings/look-and-feel#look-and-feel-id) of the Payrexx[ Look & Feel profile](https://docs.payrexx.com/merchant/english/account/settings/look-and-feel) you want to use. This is optional. {% endhint %} #### 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](https://github.com/payrexx/shopware6-payrexx-gateway/releases), 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.