# Shopware 5 {% hint style="info" %} Seit Juli 2024 wird Shopware 5 nicht mehr weiterentwickelt. Benutzern von Shopware 5 wird daher empfohlen, auf Shopware 6 zu migrieren. {% endhint %} ## Allgemein Shopware 5 ist eine in Deutschland entwickelte E-Commerce-Plattform, mit der Händler ihren eigenen Online-Shop erstellen und verwalten können. ### Links * [Login](https://account.shopware.com/front) bei Shopware * [Registrierung](https://account.shopware.com/register) bei Shopware * [Webseite](https://www.shopware.com) von Shopware * [Dokumentation](https://docs.shopware.com/de/shopware-5-de) von Shopware 5 * [Download](https://github.com/payrexx/shopware-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 5 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 5 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
Samsung Pay Apple Pay WIRpay
Pay by Bank Google Pay Barzahlen/viacash
Kauf auf Rechnung Klarnagiropay
Reka WeChat Pay Paysafecash
Centi Alipay JCB
eps Ideal Payment
Bancontact Coinbase
iDEAL Bitcoin
SEPA Direct Debit Vorkasse
Rechnung
## Setup Folge der untenstehenden Anleitung, um Payrexx in Shopware 5 zu integrieren. Falls Du Shopware 6 verwendest, wechsle bitte zur entsprechenden [Anleitung](https://docs.payrexx.com/merchant/integration/e-commerce/shopware-6). ### Installation des Plugins * Lade auf GitHub die aktuellste Version des [Plugins](https://github.com/payrexx/shopware-payrexx-gateway/releases/) herunter, indem Du auf "Source code (ZIP)" klickst:

Herunterladen des Plugins zur Integration von Payrexx in Shopware 5

* Logge Dich nun in Dein [Konto](https://account.shopware.com/front) bei Shopware ein:

Login bei Shopware

* Navigiere im Hauptmenü zu **Erweiterungen** und lade das Plugin für Payrexx hoch. * Aktiviere das hochgeladene Plugin:

Aktivierung des Plugins in Shopware 5

### 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 5 auf "Hinzufügen":

Start der Integration ins E-Commerce-System Shopware 5

* Nimm im untenstehenden Fenster die folgenden Einstellungen vor:

Konfiguration der Anbindung von Shopware 5 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 5 #### Verbindung herstellen * Navigiere in Shopware 5 zum Payrexx-Plugin und konfiguriere es, indem Du die folgenden Einstellungen vornimmst:

Konfiguration des Payrexx-Plugins in Shopware 5

1. **Instance Name:** Füge den zuvor in Payrexx kopierten Instanznamen ein. 2. **API Key:** Füge den zuvor in Payrexx kopierten API-Schlüssel ein. 3. **Create order before redirecting to Payrexx:** 1. **Yes:** Nach dem Klick auf den Bestellbutton wird eine Bestellung erstellt. Solange die Zahlung nicht bestätigt ist, hat sie den Status "Offen". Danach wird der Status auf "Bezahlt" geändert. Sollte die Bestellung fehlschlagen, ist dies im Status ebenfalls ersichtlich. Der Vorteil ist, dass selbst bei Verbindungsunterbrüchen eine Bestellung mit allen wichtigen Angaben erstellt wird. 2. **No:** Die Bestellung wird erst nach abgeschlossenem Zahlungsvorgang erstellt. Sollte allerdings ein Verbindungsunterbruch vorliegen, wird keine Bestellung erstellt. Der Vorteil ist, dass Du weniger Meldungen über Status-Änderungen erhältst. Dafür kann es aber vorkommen, dass keine Bestellung erstellt wird, obwohl der Kunde die Zahlung getätigt hat. #### Zahlungsarten auswählen * Navigiere in Deinem Shopware-Konto zu **Einstellungen > Zahlungsarten**, um festzulegen, mit welchen Zahlungsmitteln Deine Kunden im Shop bezahlen können. ## Ablauf einer Zahlung aus Kundensicht Der folgende Prozess zeigt den Ablauf einer Bestellung bei Shopware inklusive Bezahlung mit Payrexx. * Der Kunde wählt im Shop das gewünschte Produkt aus und legt es in den Warenkorb:

Hinzufügen eines Produkts zum Warenkorb

* Der Kunde klickt auf den Button "Zur Kasse". * Der Kunde loggt sich ein oder erfasst seine persönlichen Daten und klickt danach auf "Weiter":
Login oder Erfassen der Kundendaten im Shopware-Shop
* Der Kunde wählt die gewünschte Zahlungsmethode aus und klickt auf "Weiter":

Auswahl der gewünschten Zahlungsmethode

* Der Kunde schliesst seinen Kauf ab. ## Testen einer Bestellung Nutze unseren Demo-Shop von Shopware, um selbst eine Bestellung zu testen: {% embed url="" %}