# Shopware 6

{% hint style="info" %}
Verfügbar für 6.6.5 - 6.7.x
{% endhint %}

## Allgemein

Shopware 6 ist eine in Deutschland entwickelte E-Commerce-Plattform, die es Händlern ermöglicht, ihren eigenen Online-Shop erstellen und verwalten zu können.

### Links

* [Login](https://account.shopware.com/front) bei Shopware
* [Registrierung](https://account.shopware.com/register) bei Shopware
* [Webseite](https://www.shopware.com/de/) von Shopware
* [Dokumentation](https://docs.shopware.com/de/shopware-6-de) von Shopware 6
* [Download](https://github.com/payrexx/shopware6-payrexx-gateway/releases) des Plugins

### Funktionen

* ✅ Mehrwährungsfähigkeit
* ✅ Zahlungsmittel-Logos im Checkout
* ✅ Übertragung Warenkorb
* ✅ Webhook-Fähigkeit
* ✅ Einstellungen zu Look & Feel
* ✅ Individuelle Zahlungsmittel-Konfiguration
* ❌ Abonnement-Support

{% hint style="info" %}
Bitte beachte, dass die Integration in Shopware 6 nur in den Preisplänen "Standard" und "Premium" verfügbar ist. [Weitere Informationen](https://payrexx.com/de-ch/preise)
{% endhint %}

### Zahlungsarten

Die folgenden Zahlungsarten werden vom Shopware 6 Plugin unterstützt:

<table data-full-width="true"><thead><tr><th width="206.74072265625">Payrexx Pay</th><th width="244.1112060546875">Payrexx Pay Plus</th><th width="197.5555419921875">Externe Zahlungsanbieter</th><th data-hidden></th></tr></thead><tbody><tr><td><img src="/files/WJVwKt7DxusvjH585W5R" alt="" data-size="line"> <a href="/pages/CKn3b4eaRJy2uO24TSpA">Mastercard</a></td><td><img src="/files/WJVwKt7DxusvjH585W5R" alt="" data-size="line"> <a href="/pages/CKn3b4eaRJy2uO24TSpA">Mastercard</a></td><td><img src="/files/78nPVauXSM5j8W1hf2DW" alt="" data-size="line"> Masterpass</td><td></td></tr><tr><td><img src="/files/8rrzZlphAr7Za4U5vnxE" alt="" data-size="line"> <a href="/pages/jOfvr6ZV7dkHYrHdo7M7">Visa</a></td><td><img src="/files/8rrzZlphAr7Za4U5vnxE" alt="" data-size="line"> <a href="/pages/jOfvr6ZV7dkHYrHdo7M7">Visa</a></td><td><img src="/files/Px5ih1Yy9TMEgVNjJr6C" alt="" data-size="line"> <a href="/pages/-Mad3-fv8GUkyRLLTdXr">PayPal</a></td><td></td></tr><tr><td><img src="/files/O1IcwrLg6vHPIFMW71OG" alt="" data-size="line"> <a href="/pages/5QggD8K6uU69IO1qbnZQ">PostFinance Pay</a></td><td><img src="/files/x9QwkL0vhKacPC1FbAdX" alt="" data-size="line"> <a href="/pages/FQSJm3zCZK2v5Qr6uiRx">American Express</a></td><td><img src="/files/qZPAwCRYFyVy7PuTqLyb" alt="" data-size="line"> Maestro</td><td></td></tr><tr><td><img src="/files/F5MKlDmJfiQrjosXATyg" alt="" data-size="line"> <a href="/pages/CANB6YviRKn9Ghsr7rpp">TWINT</a></td><td><img src="/files/KyMObC4NB9XLN5w6nG3b" alt="" data-size="line"> <a href="/pages/Z7BFQVofdwhfnKPD7GKz">Diners Club International</a></td><td><img src="/files/187zwnGlPInPLD7hT3fM" alt="" data-size="line"> <a href="/pages/e8ZU2TkSLtgrun1Gc9cf">HeyLight</a></td><td></td></tr><tr><td><img src="/files/mHBaNNg7uf5Rkc7OSCOF" alt="" data-size="line"> <a href="/pages/eAZKWxFOksWPupUZWcXm">Google Pay</a></td><td><img src="/files/hWsNhEecDhAgfFSuqIwO" alt="" data-size="line"> <a href="/pages/2oWxoDMQbzHIVCws4ROd">Discover Card</a></td><td><img src="/files/2ZameCpQlezKSA4Qsd5a" alt="" data-size="line"> Swissbilling</td><td></td></tr><tr><td><img src="/files/9nOxIIDiwvvsQ0Eo5PoP" alt="" data-size="line"> <a href="/pages/3FU6mgXZmso1rz0AQAV4">Pay by Bank</a></td><td><img src="/files/4WbXC1jE7rF4vFzTWeRn" alt="" data-size="line"> <a href="/pages/uAo8PmPGb2NO0i5PAhYv">Apple Pay</a></td><td><img src="/files/5akObsEJqWhUzdE9kuI8" alt="" data-size="line"> <a href="/pages/-Mad30Eoy2Pbb2UmEcca">WIRpay</a></td><td></td></tr><tr><td><img src="/files/ZwwNMSVMl4Jh1fzAbmdA" alt="" data-size="line"> <a href="/pages/iM2anRm1uQ5M0Hj8HoVG">Kauf auf Rechnung</a></td><td><img src="/files/mHBaNNg7uf5Rkc7OSCOF" alt="" data-size="line"> <a href="/pages/eAZKWxFOksWPupUZWcXm">Google Pay</a></td><td> <img src="/files/86ZkIaXn72MK8od3KeRX" alt="" data-size="line"> <a href="/pages/-Mad432nUsmfccsz4Wyw">Barzahlen/viacash</a></td><td></td></tr><tr><td><img src="/files/6lp9YDEoeRS5tcEtB92a" alt="" data-size="line"> <a href="/pages/ZOSEisPhYo4fBMYm3ync">Reka</a></td><td><img src="/files/5tUKnraMZivl4tDWvGfp" alt="" data-size="line"> <a href="/pages/Lj07FlegH735swR9HeIr">Klarna</a></td><td><img src="/files/I2eINBnlQvxy9YMUhybE" alt="" data-size="line"><a href="/pages/-Mad45CsDGyAtvGZ2mKl">giropay</a></td><td></td></tr><tr><td><img src="/files/oaaSznByCekbaAIykjdx" alt="" data-size="line"> <a href="/pages/fliVkvByHyJFkW8Ji6fT">Centi</a></td><td><img src="/files/hFFsYqLAc6lOlTTWaTvr" alt="" data-size="line"> <a href="/pages/Ta4X74rK1UFRtGWxBz7N">eps</a></td><td><img src="/files/w2hYB6OtrE63bPCPJ6JY" alt="" data-size="line"> <a href="/pages/-Mad44Oc8QRG9BQRJ2pQ">Paysafecash</a></td><td></td></tr><tr><td><img src="/files/0qXmTTtejLWoCYW0xLH7" alt="" data-size="line"> <a href="/pages/wrjxDTCFEgOXup9AlK1r">Crypto</a></td><td><img src="/files/WlZTxTH2yBfKtfUpNp3r" alt="" data-size="line"> <a href="/pages/UEtOuMqCI7bsdUwghmPx">Bancontact</a></td><td><img src="/files/b98rHdQTVI0h3I1nAC79" alt="" data-size="line"> JCB</td><td></td></tr><tr><td></td><td><img src="/files/mE1yKqaoXsEWS3xH73eo" alt="" data-size="line"> <a href="/pages/UD1145eSo3qeqePc1fdY">iDEAL</a></td><td><img src="/files/bXm8uob0fSJl5ilCPJKx" alt="" data-size="line"> Bitcoin</td><td></td></tr><tr><td></td><td><img src="/files/m6WuTovbzXMwjMwTIwpN" alt="" data-size="line"> <a href="/pages/7NM6bXgdvaCYIwi9wnD6">SEPA Direct Debit</a></td><td><img src="/files/kB6MKHjXU6B5WQKpZZx0" alt="" data-size="line"> <a href="/pages/s6zaRMn26YsH1fUnXALk">Vorkasse</a></td><td></td></tr><tr><td></td><td></td><td><img src="/files/Y6Vg3EOODHSpYyKWW4Py" alt="" data-size="line"> <a href="/pages/FHGc9AT6aeuXZHXxbFMo">Rechnung</a></td><td></td></tr><tr><td></td><td></td><td><img src="/files/ur1Ki5bMiba6JtwhhPzx" alt="" data-size="line"> <a href="/pages/bL8gxc3pRsEUhGQuCc6R">POWERPAY</a></td><td></td></tr><tr><td></td><td></td><td><img src="/files/5HxCEkCzSYKmAjuumh81" alt="" data-size="line"> <a href="/pages/RYopGQn4Hpo3myV5kd8u">CembraPay</a></td><td></td></tr><tr><td></td><td></td><td> <img src="/files/ti7V8srnwwwBhZKsS1qp" alt="" data-size="line"> <a href="/pages/-Mad44Oc8QRG9BQRJ2pQ">VERD</a></td><td></td></tr></tbody></table>

## Setup

Folge der untenstehenden Anleitung, um Payrexx in Shopware 6 zu integrieren. Solltest Du noch Shopware 5 verwenden, wechsle bitte zur entsprechenden [Anleitung](/merchant/integration/e-commerce/shopware-5.md).

### Installation des Plugins

* Lade auf GitHub die aktuelle Version des [Plugins](https://github.com/payrexx/shopware6-payrexx-gateway/releases) herunter, indem Du auf "PayrexxPaymentGatewaySW6.zip" klickst:

<div align="left"><figure><img src="/files/76ufTbmctDyQqAeePOCA" alt=""><figcaption><p>Herunterladen des Plugins zur Integration von Payrexx in Shopware 6</p></figcaption></figure></div>

### Konfiguration von Payrexx

{% hint style="info" %}
Bitte beachte, dass Du bei Payrexx [eingeloggt](https://login.payrexx.com/de) sein musst, bevor Du beginnst. Falls Du noch kein Konto hast, [registriere](https://signup.payrexx.com/de/email-validation/) Dich bitte bei Payrexx.
{% endhint %}

* Navigiere in der Händler-Administration Deines Payrexx-Kontos zu **API und Integrationen**.
* Klicke unterhalb von "E-Commerce-Integration hinzufügen" auf "Alle anzeigen".
* Klicke neben Shopware 6 auf "Hinzufügen":

<div align="left"><figure><img src="/files/LlUrMh1Y7vaZDUcoZ1kb" alt=""><figcaption><p>Erstellen eines API-Schlüssels für Shopware 6</p></figcaption></figure></div>

* Nimm im untenstehenden Fenster die folgenden Einstellungen vor:

<div align="left"><figure><img src="/files/jFWpvqb8euuLmfhSTLtD" alt=""><figcaption><p>Konfiguration der Anbindung von Shopware 6 in Payrexx</p></figcaption></figure></div>

1. **API-Schlüssel:** Kopiere den angezeigten API-Schlüssel in die Zwischenablage, da Du ihn später benötigst.
2. **Instanzname:** Kopiere den angezeigten Instanznamen in die Zwischenablage, da Du ihn später benötigst.
3. **Shop-Adresse eingeben:** Erfasse in diesem Feld die URL Deines Shops. Falls sich Dein Shop nicht im Hauptverzeichnis (<https://mein-shop.com>) befindet, sondern in einem Unterverzeichnis, gibt bitte den kompletten Pfad zu Deinem Shop an. Beispiel: <https://mein-shop.com/shop>

{% hint style="warning" %}
Bitte beachte, dass Du die Shop-Adresse korrekt einträgst. Abweichungen (z. B. http\:// statt https\:// können zu Fehlern bei der Verarbeitung der Webhooks führen.
{% endhint %}

4. **Webhooks:** Definiere, ob ein fehlgeschlagener Webhook erneut ausgeführt werden soll oder nicht. Ist die Checkbox aktiviert, wird bis zu 10 Mal versucht, den Webhook erneut zu versenden. Die Abstände der Versuche betragen 5 Minuten, 15 Minuten, 1 Stunde, 2 Stunden, 4 Stunden und danach jeweils 24 Stunden.
5. **Abschliessen:** Klicke auf den grünen Button "Aktivieren", um die Konfiguration abzuschliessen.

### Konfiguration von Shopware 6

#### Verbindung zu Payrexx herstellen

* Navigiere in Shopware zu **Einstellungen**.
* Klicke unterhalb von "Erweiterungen" auf "Payrexx Payments":

<div align="left"><figure><img src="/files/2v0rhXIa0KF73mPd3cdN" alt=""><figcaption><p>Öffnen der Einstellungen zu Payrexx in Shopware 6</p></figcaption></figure></div>

Die Verbindung mit Payrexx kann sowohl automatisch als auch manuell hergestellt werden.

**Verbindung automatisch herstellen**

1. Stelle sicher, dass die Option "Alle Verkaufskanäle" ausgewählt ist.

{% hint style="info" %}
Falls Du in Shopware 6 mehrere Verkaufskanäle nutzt, kannst die Konfiguration für jeden Verkaufskanal einzeln vornehmen. Wähle hierfür im Dropdown einen Kanal aus, nimm die Einstellungen vor, speichere sie und konfiguriere dann den nächsten Verkaufskanal.
{% endhint %}

2. Stelle sicher, dass die richtige Plattform ausgewählt ist.
3. Klicke auf die Schaltfläche "Mit payrexx.com verbinden".

<div align="left"><figure><img src="/files/BRQq2oN06BbXXTMFKdoR" alt=""><figcaption><p>Automatisches Herstellen der Verbindung zwischen Shopware 6 und Payrexx</p></figcaption></figure></div>

* Melde Dich mit Deinen Benutzerdaten in Deinem Payrexx-Konto an:

<div align="left"><figure><img src="/files/iclVANDgveh5chHycXyx" alt=""><figcaption><p>Anmeldung bei Payrexx</p></figcaption></figure></div>

* Wähle das Payrexx-Konto aus, das Du mit Shopware 6 verbinden möchtest:

<div align="left"><figure><img src="/files/oNoxVRLLUsfvl5luhAd8" alt=""><figcaption><p>Auswahl der zu verbindenden Instanz bei Payrexx</p></figcaption></figure></div>

{% hint style="success" %}
Payrexx und Shopware 6 sind erfolgreich miteinander verbunden.
{% endhint %}

**Verbindung manuell herstellen**

Nimm die folgenden Einstellungen vor:

1. Stelle sicher, dass die Option "Alle Verkaufskanäle" ausgewählt ist.

{% hint style="info" %}
Falls Du in Shopware 6 mehrere Verkaufskanäle nutzt, kannst die Konfiguration für jeden Verkaufskanal einzeln vornehmen. Wähle hierfür im Dropdown einen Kanal aus, nimm die Einstellungen vor, speichere sie und konfiguriere dann den nächsten Verkaufskanal.
{% endhint %}

2. Stelle sicher, dass die richtige Plattform ausgewählt ist.
3. Erfasse den Instanznamen Deines Payrexx-Kontos. Der Instanzname entspricht dem ersten Teil Deiner Payrexx-URL. Wenn die URL *beispiel*.payrexx.com ist, so lautet der Instanzname *beispiel*.
4. Füge den API-Schlüssel ein, der während der [Konfiguration von Payrexx](#konfiguration-von-payrexx) angezeigt wurde.

<div align="left"><figure><img src="/files/u4mbCSDLQDz67jIGXvJE" alt=""><figcaption><p>Manuelles Herstellen der Verbindung zwischen Shopware 6 und Payrexx</p></figcaption></figure></div>

* Klicke im oberen Bereich des Fensters auf die Schaltfläche "Speichern":

<div align="left"><figure><img src="/files/B2aIqSbtJfRTKgIpyk8A" alt=""><figcaption><p>Speichern der Einstellungen und Herstellen der Verbindung</p></figcaption></figure></div>

{% hint style="success" %}
Payrexx und Shopware 6 sind erfolgreich miteinander verbunden.
{% endhint %}

{% hint style="info" %}
**Look & Feel ID:** Gib die [ID](https://docs.payrexx.com/merchant/payrexx-administration/einstellungen/look-and-feel#look-and-feel-id) des [Look & Feel Profils](https://docs.payrexx.com/merchant/payrexx-administration/einstellungen/look-and-feel) aus Payrexx an, das Du benutzen möchtest. Diese Angabe ist optional.
{% endhint %}

#### Zahlungsarten auswählen

Um festzulegen, welche Zahlungsarten Du den Kunden Deines Shops anbieten möchtest, gehe bitte wie folgt vor:

* Klicke im Hauptmenü von Shopware 6 unterhalb von "Verkaufskanäle" auf **Payrexx**.
* Scrolle im Reiter "Allgemein" hinunter bis zum Abschnitt "Zahlung und Versand".
* Klicke in den leeren Bereich des Fensters unterhalb "Zahlungsarten" und wähle beliebig viele Zahlungsarten aus der Liste aus:

<div align="left"><figure><img src="/files/hymVjTeyf2iG3rCIIrO4" alt=""><figcaption><p>Auswahl der Zahlungsarten in Shopware 6</p></figcaption></figure></div>

* Klicke am oberen Bildschirmrand auf "Speichern", um die Konfiguration der Zahlungsarten abzuschliessen:

<div align="left"><figure><img src="/files/IMktaZ34pprCWSl8IPxk" alt=""><figcaption><p>Speichern der Zahlungsarten in Shopware 6</p></figcaption></figure></div>

## Update des Plugins

Um das Plugin von Shopware 6 auf die neueste Version upzudaten, gehe bitte wie folgt vor:

* Lade die ZIP-Datei der [neusten Version](https://github.com/payrexx/shopware6-payrexx-gateway/releases) des Plugins herunter:

<div align="left"><figure><img src="/files/kyBFsCsBrt9Ua3U9BABP" alt=""><figcaption><p>Herunterladen der neusten Plugin-Version</p></figcaption></figure></div>

* Logge Dich in den Administrationsbereich Deines Kontos bei Shopware 6 ein.
* Navigiere im Hauptmenü zu **Extensions > My Extensions**.
* Deaktiviere die aktuelle Payrexx-Integration:

<div align="left"><figure><img src="/files/9waBNlX0mff7WIROlkwU" alt=""><figcaption><p>Deaktivieren der Payrexx-Integration in Shopware 6</p></figcaption></figure></div>

* Klicke auf "Upload extension" und lade die ZIP-Datei der aktuellsten Version des Plugins hoch:

<div align="left"><figure><img src="/files/PfI5GafVEkvoV0DgvEYn" alt=""><figcaption><p>Hochladen der neusten Plugin-Version in Shopware 6</p></figcaption></figure></div>

* Aktiviere das Plugin nach dem Update.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payrexx.com/merchant/integration/e-commerce/shopware-6.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.