---
title: "Shop5 Plugin Payment Payrexx"
canonical: "https://doc.wawi.ch/space/DOCPL/2980708450/Shop5%20Plugin%20Payment%20Payrexx"
format: markdown
---
---
# Installation
Installieren Sie das Plugin gemäss Anleitung unter [elink.ch/plugin5](https://elink.ch/plugin5)
# Konfigurationsvorbereitung in der Payrexx Plattform
Erstellen Sie ein neues Payrexx-Konto auf der Payrexx Plattform über folgenden Link: [login.payrexx.com](https://elink.ch/apayre)
## Webhook einrichten
Gehen Sie auf den Menüpunkt «Webhooks» (1) und klicken Sie auf «Webhook hinzufügen» tragen Sie dann Ihren «Webshop Name» ein (2). Anschliessend kopieren Sie die unten grau hinterlegte URL und tragen Sie diese unter «Webhook URL» ein (3). Ersetzen Sie «ihrshopname.ch» durch Ihre offizielle Shop-URL. Setzen Sie den «Webhook Inhaltstyp» auf «JSON» (4), die «Webhook Version» auf «2020-06-10» (5) und speichern Sie den Webhook indem Sie auf «Hinzufügen» (6) klicken.
```
https://ihrshopname.ch/includes/modules/notify.php?plugin=xv_payrexx
```
Öffnen Sie nun den neu erstellten «Webhook» nochmals und klicken auf «Test Transaktion senden» es sollte nachfolgendes Fenster erscheinen und stehen «Daten erfolgreich an den angegebenen Server übermittelt» (1) sollte ein Fehler (2) erscheinen, prüfen Sie die «Webhook URL» [*Bild oben (3)*]. Wenn Sie die Shop-URL korrekt eingetragen haben, ergänzen Sie die URL mit «www.» oder entfernen Sie ggf. das «www.»
> ℹ️ Sollten Sie mehrere Webshop’s anbinden wollen, erstellen Sie für jeden Webshop einen eigenen «Webhook» *(wiederholen Sie dazu alle Schritte in diesem Kapitel)*
## API Integrationen für Plugin Zugang
Gehen Sie auf den Menüpunkt «API & Integrationen» (1) dort klicken Sie unter «API Integration hinzufügen» auf «API Schlüssel hinzufügen» (2)
Geben Sie den Namen Ihres Webshop’s (1) ein und klicken Sie auf «Hinzufügen» (2)
Anschliessend kopieren Sie von Ihrem Webshop (1) den «API Schlüssel» mit einem klick auf den «Kopieren» Button (2) und speichern diesen z.B. im «Word».* (Dieser wird später in der Plugin Konfiguration benötigt)*
> ℹ️ Sollten Sie mehrere Webshop’s anbinden wollen, erstellen Sie für jeden Webshop einen eigenen «API Schlüssel» *(wiederholen Sie dazu alle Schritte in diesem Kapitel)*
# Plugin Konfiguration
Öffnen Sie in Ihrem Webshopbackend *(www.IHRSHOPNAME.ch/admin)* das Verzeichnis «Installierte Plugins» (1) → «Payment Payrexx» (2) dort anschliessend den Tab «Payrexx Grundeinstellungen» (3) und geben dort unter «Instanzname» (4) den Namensteil aus Ihrem Payrexx Plattformzugang z.B. www.**musterfirma**.payrexx.com ein und tragen Sie den «API Schlüssel», den Sie im vorangehenden Schritt kopiert haben unter «API Secret» (5) ein und klicken Sie anschliessend auf «Speichern» (6).
> ⚠️ Achtung: Nur den «Musterfirma» Teil eingeben, nicht die ganze URL.
Anschliessend wechseln Sie in den Tab «Konfiguration» (1) und wählen dort alle im Shop gewünschten Zahlungsarten an (2) und klicken anschliessend auf «Zahlungsprovider abgleichen» (3) um die Plugin Konfiguration abzuschliessen.
# Webshop Zahlungsarten
Gehen Sie in Ihrem Webshopbackend *(www.IHRSHOPNAME.ch/admin),* in das Verzeichnis «Zahlungen» (1) → «Zahlungsarten» (2) und scrollen Sie nach ganz unten. Dort finden Sie die aktivierten Zahlungsarten *(mit «Payrexx» hintenangestellt)* (3), klicken nacheinander auf «bearbeiten» (4) und führen den nächsten Schritt für jede Zahlungsart aus.
Im neu geöffneten Fenster geben Sie unter «Angezeigter Name» (1) den Namen an, welcher beim Zahlvorgang für den Kunden erscheinen soll.
> ⚠️ Beachten Sie, dass der «Angezeigter Name» nicht schon in einer anderen Zahlungsart verwendet wird (*z.B. «Kreditkarte»*), ansonsten passen Sie diesen an.
Als nächstes hinterlegen Sie bei «Bild-URL» (2) den Pfad des Bildes / Icons, welches Sie für die Zahlungsart verwenden möchten.
> ℹ️ Die Bilder finden Sie wenn Sie via [FTP](https://elink.ch/ftp) auf Ihren Shop zugreifen in folgendem Ordner: «IHRSHOPHAUPTVERZEICHNIS/plugins/xv_payrexx/images/»
Anschliessend wählen Sie den «Name der Gebühr» (3) und die «Sortiernummer» (4) welche die Reihenfolge auf der Zahlungsauswahlseite festlegt *(je höher die Zahl, desto weiter unten)* anschliessend noch den «Hinweistext» (5) der unter dem Bild erscheint.
## Zahlungszeitpunkt
Im JTL-Shop kann der Zeitpunkt der Zahlung konfiguriert werden. Hierbei handelt es sich um Standardfunktionen vom Shop. In einem JTL-Shop wird eine Bestellung erst erzeugt wenn im Webshop die Abschlussseite aufgerufen wird und die Bestellnummer angezeigt wurde.
#### Zahlung vor Bestellabschluss: «Nein»** **(Standard)
Bei «Zahlung vor Bestellabschluss» (6) wählen Sie «Nein» (Empfehlung), wenn der Kunde erst nach der erfolgreichen Bestellung bezahlen soll.
Vorteil:
:check_mark: Webshop-Bestellung wird sofort erstellt und ans JTL-Wawi übertragen
:check_mark: Dies verhindert, dass Sie Zahlungen ohne Bestellungen erhalten
:check_mark: Die Webshopbestellnummer in der Transaktion wird als «Referenz ID» eingetragen (ist also identisch)
Nachteil:
:cross_mark: Wenn Kunden eine Zahlung abbricht oder nicht ausführen, gibt es trotzdem eine Bestellung (im JTL-Wawi) jedoch keine Zahlung. Dafür erfährt der Händler das es eine Bestellung gibt, und könnte nachfassen.
#### Zahlung vor Bestellabschluss: «JA»
Alternativ wählt man bei «Zahlung vor Bestellabschluss» (6) «JA»** **(nicht Empfohlen). Wenn der Shop erst nach der erfolgreichen Zahlung eine Bestellung erzeugen soll.
Vorteil:
:check_mark: Sie bekommen nur noch Bestellungen die vom Kunde erfolgreich bezahlt wurden
Nachteil:
:cross_mark: Der Händler erfährt nie, wenn eine Bestellung vom Kunde aufgeführt wurde, jedoch die Rückleitung an den Shop misslingt oder die Zahlung abgebrochen wurde
:cross_mark: Wenn der Kunde bestellt, bezahlt, jedoch nicht mehr auf den Webshop zurück kommt, liegt eine Zahlung vor, es gibt jedoch keine Shop-Bestellung dazu. Dies kann vorkommen, wenn ein Kunde nach einer Zahlung zum Beispiel den Browser einfach «schliesst» statt zum Webshop zurückzukehren
:cross_mark: Es wird eine fiktive, zufällige «Referenz ID» in der Transaktion eingetragen (da ja noch keine Bestellung im Webshop vorhanden ist und somit noch keine Bestellnummer existiert)
## Mindestbestellwert
Stellen Sie den «Mindestbestellwert» (7) auf «1» und klicken anschliessend auf «Speichern» (8).
> ⚠️ Beachten Sie, dass der «Angezeigter Name» (1) mit dem Namen der Zahlungsart im WaWi unter «Zahlungen» → «Zahlungsarten» → «Name» übereinstimmt, für alle Zahlungsarten in jeder Sprache.
> ℹ️ Diesen Schritt für alle Zahlungsarten wiederholen
# Webshop Versandarten
Gehen Sie in Ihrem Webshopbackend *(www.IHRSHOPNAME.ch/admin)* in das Verzeichnis «Versand» (1) → «Versandarten» und klicken bei der gewünschten Versandart auf das Icon «Bearbeiten» (2)
Gehen Sie in den Bereich «AKZEPTIERTE ZAHLUNGSARTEN» (1) und wählen Sie dort alle «Zahlungsarten» (2) aus, welche Sie für diese Versandart aktivieren möchten und geben Sie *(wenn es rechtlich erlaubt ist)* einen allfälligen «Aufpreis/Rabatt» (3) ein. Klicken Sie anschliessend ganz unten auf «Speichern» (4)
> ⚠️ Speichern mit Klick auf «Versandart ändern» nicht vergessen.
> ℹ️ Diesen Schritt für alle Versandarten wiederholen
# Webshop Abschlussseite nach externer Bezahlung
Wechseln Sie nun in das Verzeichnis «DARSTELLUNG» (1) → «Standardansichten»(2) → «Bestellvorgang» (3) zu den Einstellungen für den «Bestellabschluss» (4). Wählen Sie unter «Abschlussseite nach externer Bezahlung» (5) → Ihre gewünschte Auswahl und «Speichern» (6) Sie die Einstellung.
# CSS Anpassung für Icons auf Zahlungsseite
Für JTL-Shop «EVO» Template:
```css
/* Zahlungsarten Icon */
#fieldset-payment img {
max-width: 100%;
}
```
Für JTL-Shop «NOVA» Template: *(unter: IHRSHOPHAUPTVERZEICHNIS/templates/NOVA/themes/clear/custom.css)*
```css
/* Zahlungsarten Icon */
#fieldset-payment img {
height: 45px;
}
```
Für JTL-Shop «SALEPIX» Templates *(unter "IHRSHOPHAUPTVERZEICHNIS/templates/TEMPLATENAME-CHILD/themes/mytheme/mytheme.css)*
```css
/* Zahlungsarten Icon */
#fieldset-payment .img-sm {
width: auto;
max-width: 100% !important;
height: 45px;
}
```