# 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:
Payrexx PayPayrexx Pay PlusExterne Zahlungsanbieter
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
Kauf auf Rechnung Google Pay Barzahlen/viacash
Reka Klarnagiropay
Centi eps Paysafecash
Crypto Bancontact JCB
iDEAL Bitcoin
SEPA Direct Debit Vorkasse
Rechnung
POWERPAY
CembraPay
VERD
## Setup Folge der untenstehenden Anleitung, um Payrexx in Shopware 6 zu integrieren. Solltest Du noch Shopware 5 verwenden, wechsle bitte zur entsprechenden [Anleitung](https://docs.payrexx.com/merchant/integration/e-commerce/shopware-5). ### 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:

Herunterladen des Plugins zur Integration von Payrexx in Shopware 6

### 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":

Erstellen eines API-Schlüssels für Shopware 6

* Nimm im untenstehenden Fenster die folgenden Einstellungen vor:

Konfiguration der Anbindung von Shopware 6 in Payrexx

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 () befindet, sondern in einem Unterverzeichnis, gibt bitte den kompletten Pfad zu Deinem Shop an. Beispiel: {% 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":

Öffnen der Einstellungen zu Payrexx in Shopware 6

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".

Automatisches Herstellen der Verbindung zwischen Shopware 6 und Payrexx

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

Anmeldung bei Payrexx

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

Auswahl der zu verbindenden Instanz bei Payrexx

{% 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.

Manuelles Herstellen der Verbindung zwischen Shopware 6 und Payrexx

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

Speichern der Einstellungen und Herstellen der Verbindung

{% 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:

Auswahl der Zahlungsarten in Shopware 6

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

Speichern der Zahlungsarten in Shopware 6

## 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:

Herunterladen der neusten Plugin-Version

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

Deaktivieren der Payrexx-Integration in Shopware 6

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

Hochladen der neusten Plugin-Version in Shopware 6

* Aktiviere das Plugin nach dem Update.