# WooCommerce {% hint style="info" %} Verfügbar für Wordpress 5.6 - 6.8 und WooCommerce 5.0 - 10.0.1 {% endhint %} ## Allgemein WooCommerce ist ein E-Commerce-Tool, das als Plugin in WordPress integriert werden kann. Das Open-Source-Plugin ermöglicht es Händlern, ihrer Webseite umfangreiche E-Commerce-Funktionalitäten hinzuzufügen. Mit WooCommerce können unter anderem Shops, Produkte, Warenkörbe und die Zahlungsabwicklung verwaltet werden. ### Links * [Webseite](https://wordpress.com/) von WordPress * [Webseite](https://woocommerce.com) von WooCommerce * [Dokumentation](https://woocommerce.com/documentation/woocommerce/) von WooCommerce * Download des [Plugins](https://wordpress.org/plugins/woo-payrexx-gateway/) ### Funktionen * ✅ Mehrwährungs-Fähigkeit * ✅ Zahlungsmittel-Logos im Checkout * ✅ Warenkorb-Übertragung * ✅ Webhook-Fähigkeit * ✅ Einstellungen zu Look & Feel * ✅ Individuelle Zahlungsmittel-Konfiguration * ✅ Abonnement-Support * ✅ Durchführung von Rückerstattungen {% hint style="info" %} Bitte beachte, dass die Integration in WooCommerce 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 WooCommerce-Plugin unterstützt:

Payrexx Pay	Payrexx Pay Plus	Externe Zahlungsanbieter
Mastercard	Mastercard	Masterpass
Visa	Visa	PayPal
PostFinance Pay	American Express	Maestro
TWINT	Diners Club International	HeyLight
Apple Pay	Discover Card	WIRpay
Google Pay	Apple Pay	Boncard
Samsung Pay	Google Pay	PostFinance Card
Pay by Bank	Klarna	PostFinance E-Finance
Kauf auf Rechnung		Rechnung
Reka		POWERPAY
Centi		CembraPay
Crypto		xMoney
		VERD

## Setup Die folgende Anleitung zeigt Dir, wie Du Payrexx in WooCommerce einbinden kannst. ### 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 bei WooCommerce auf "Hinzufügen":

* Nimm im nächsten Fenster die folgenden Einstellungen vor:

1. **API-Schlüssel:** Anzeige des API-Schlüssels für die Verbindung mit WooCommerce 2. **Instanzname:** Anzeige des Instanznamens Deines Payrexx-Kontos 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. ### Installation des Plugins {% hint style="info" %} Logge Dich in Dein [Konto](https://wordpress.com/log-in/de) bei WordPress ein, bevor Du beginnst. {% endhint %} * Navigiere in Deinem WordPress-Konto zu **Plugins > Neues Plugin hinzufügen**. * Suche nach dem Plugin "WooCommerce Payrexx Payment Gateway". * Klicke auf die Schaltfläche "Jetzt Installieren":

* Klicke auf die blaue Schaltfläche "Aktivieren":

### Konfiguration von WooCommerce * Navigiere in Deinem WordPress-Konto zu **WooCommerce > Einstellungen**. * Klicke auf den Reiter "Payrexx". * Stelle die Verbindung von WooCommerce zu Payrexx her:

Herstellen der Verbindung zwischen WooCommerce und Payrexx

**Verbindung automatisch herstellen:** * Wähle die Plattform aus, die Du benutzt. In der Regel ist das "Payrexx" (1). * Erfasse den Instanznamen. Wenn Deine URL beispiel.payrexx.com ist, so lautet Dein Instanzname *beispiel* (3). * Klicke auf "Verbinden Sie" (2), worauf Du zu Payrexx weitergeleitet wirst. * Melde Dich in Deinem Payrexx-Konto an:

* Nach der Anmeldung sind Payrexx und WooCommerce automatisch miteinander verbunden:

Erfolgreiche Verbindung zwischen Payrexx und WooCommerce

**Verbindung manuell herstellen:** Alternativ kann die Verbindung auch manuell hergestellt werden: * Wähle die Plattform aus, die Du benutzt. In der Regel ist das "Payrexx" (1). * Erfasse den Instanznamen. Wenn Deine URL beispiel.payrexx.com ist, so lautet Dein Instanzname *beispiel* (3). * Kopiere den API-Schlüssel aus der [Konfiguration von Payrexx](#konfiguration-von-payrexx) und füge ihn hier ein (4). * Klicke auf "Validieren". **Weitere Einstellungen** * **Look & Feel-Profil-ID:** Falls Du in Payrexx mehrere [Look & Feel-Profile](https://docs.payrexx.com/merchant/payrexx-administration/einstellungen/look-and-feel) hast, kannst Du in diesem Feld definieren, welches verwendet werden soll, indem Du die [ID](https://docs.payrexx.com/merchant/payrexx-administration/einstellungen/look-and-feel#look-and-feel-id) des gewünschten Profil eingibst. Wenn Du nur ein Look & Feel-Profil hast, kannst Du das Feld leer lassen. * **Prefix:** Dieses Feld muss nur ausgefüllt werden, wenn Du bei Payrexx ein Plattform-Kunde bist und mehrere Shops in einem Payrexx-Konto verwaltest. Jedes Shop-Plugin übermittelt als Referenz eine Bestellungs-ID an Payrexx. Der Präfix dieser Referenz sorgt dafür, dass Payrexx weiss, um welchen Shop es geht. ### Zahlungsarten konfigurieren * Navigiere in Deinem WordPress-Konto zu **WooCommerce > Einstellungen**. * Klicke auf den Reiter "Zahlungen". * Lege fest, welche der verfügbaren Zahlungsarten Du aktivieren möchtest, indem Du auf den jeweiligen Regler klickst.

Aktivierte Zahlungsarten (Visa, Mastercard und TWINT) aus Payrexx

* Klicke auf ein Zahlungsmittel, um weitere Einstellungen vorzunehmen:

Weitere Einstellungen zu einer Zahlungsart, hier am Beispiel von Visa

1. **Aktivieren/Deaktivieren**: Lege fest, ob die Zahlungsart im Checkout verfügbar sein soll oder nicht. 2. **Titel:** Lege den Titel respektive die Bezeichnung der Zahlungsart fest. 3. **Beschreibung:** Erfasse optional eine Beschreibung der Zahlungsart. 4. **Abonnemente:** Wähle, ob die Zahlungsart für [Abonnemente](https://docs.payrexx.com/merchant/zahlungen/funktionalitaeten/abonnemente) (wiederkehrende Zahlungen) verwendet werden kann oder nicht. {% hint style="warning" %} Bitte beachte, dass wiederkehrende Zahlungen nur funktionieren, wenn das Plugin [WooCommerce Subscriptions](#abonnemente-aktivieren) aktiviert ist. {% endhint %} 5. **Änderungen speichern:** Klicke auf die blaue Schaltfläche, um die Einstellungen zu speichern. ### Abonnemente Damit Deine Kunden im Checkout-Prozess Abonnemente abschliessen können, ist es notwendig, das Plugin "WooCommerce Subscriptions" zu installieren und zu aktivieren: {% embed url="" %} Bei Abonnementen wird unterschieden zwischen solchen mit einer [automatischen](#automatische-erneuerung) und solchen mit einer [manuellen Erneuerung](#manuelle-erneuerung): #### Automatische Erneuerung Das durch den Kunden hinterlegte Zahlungsmittel wird automatisch belastet, sobald eine neue Abonnementzahlung fällig ist. Automatische Erneuerungen werden nur von bestimmten Zahlungsmitteln unterstützt. #### Manuelle Erneuerung Der Kunde erhält eine E-Mail mit einem Zahlungslink, sobald eine Abonnementzahlung fällig ist. Manuelle Erneuerungen werden von allen Zahlungsarten aus Payrexx Pay und Payrexx Pay Plus unterstützt. Weitere Informationen zu automatischen und manuellen Erneuerungen findest Du in der Dokumentation von WooCommerce: {% embed url="" %} {% hint style="info" %} Falls Du keine wiederkehrenden Zahlungen erlauben möchtest, kannst Du die Abonnementsfunktion unter **WooCommerce > Settings > General Settings** deaktivieren. {% endhint %} #### Modifikationen an Kunden Payrexx führt in WooCommerce keine Modifikationen an Kunden durch. Sollte ein Kunde gelöscht oder sein Abonnement verschwunden sein, kann dies entweder durch das Plugin "Subscriptions for WooCommerce" oder manuell durch einen Benutzer in WordPress verursacht worden sein. ### Rückerstattungen {% hint style="warning" %} Rückerstattungen (auch Teilbeträge) müssen in Payrexx vorgenommen werden. In WooCommerce ausgelöste Rückerstattungen werden nicht an Payrexx übertragen. {% endhint %} Um einem Kunden den Betrag oder Teilbetrag einer Transaktion zurückerstatten, gehe bitte nach der folgenden Anleitung vor: {% content-ref url="../../zahlungen/funktionalitaeten/rueckerstattung" %} [rueckerstattung](https://docs.payrexx.com/merchant/zahlungen/funktionalitaeten/rueckerstattung) {% endcontent-ref %} Nachdem Du die Rückerstattung in Payrexx durchgeführt hast, wird dies automatisch an WooCommerce kommuniziert und in der Bestellung entsprechend angezeigt. ## Bestellung und Bezahlung aus Kundensicht Der folgende Ablauf zeigt die Bestellung und Bezahlung eines Produkts in einem WooCommerce-Shop mit integrierter Zahlungslösung von Payrexx: * Der Kunde wählt ein Produkt aus und legt es in den Warenkorb:

Hinzufügen eines Produkts zum Warenkorb in WooCommerce

* Nach der Überprüfung seines Warenkorbs fährt der Kunde weiter zum Checkout:

* Der Kunde wählt aus der Liste das gewünschte Zahlungsmittel aus, im folgenden Beispiel Visa:

Auswahl des Zahlungsmittels in WooCommerce

* Der Kunde wird zur Bezahlseite von Payrexx weitergeleitet, wo er die Zahlung abschliesst:

{% hint style="success" %} Die Zahlung im WooCommerce-Shop ist damit erfolgreich abgeschlossen. {% endhint %}