WooCommerce

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.

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

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
Crypto		CembraPay
		xMoney
		VERD

Setup

Die folgende Anleitung zeigt dir, wie du zahls.ch in WooCommerce einbindest.

Installation des Plugins

Melde dich in deinem WordPress-Admin an.
Navigiere zu Plugins > Installieren.
Suche nach dem Plugin zahls.ch Credit Cards, PostFinance and TWINT for WooCommerce.
Klicke auf Jetzt installieren und anschliessend auf Aktivieren.

Alternativ kannst du das Plugin als ZIP herunterladen und unter Plugins > Installieren > Plugin hochladen installieren.

Zahlungsarten in zahls.ch aktivieren

Navigiere im Dashboard deines zahls.ch-Kontos zu Zahlungsanbieter.
Aktiviere Payrexx Pay und/oder Payrexx Pay Plus sowie die gewünschten Zahlungsarten.
Wir empfehlen mindestens TWINT, Mastercard, Visa, Apple Pay, Google Pay und PostFinance.

Details zur Aktivierung findest du unter Aktivierung der Bezahldienste.

API-Schlüssel erstellen

Navigiere im Dashboard zu API und Integrationen.
Klicke auf API-Schlüssel hinzufügen.
Vergib einen Namen (z. B. «WooCommerce») und klicke auf Hinzufügen.
Kopiere den API-Schlüssel — du brauchst ihn im nächsten Schritt.

Weitere Informationen: API und Integrationen.

Konfiguration von WooCommerce

Navigiere in WordPress zu WooCommerce > Einstellungen > Zahlungen.
Öffne die Zahlungsmethode zahls.ch.
Nimm die folgenden Einstellungen vor:

Feld	Beschreibung
Activate	Aktiviere zahls.ch als Zahlungsmethode.
Title	Bezeichnung im Checkout (Standard: «Credit Cards / TWINT»).
Description	Optionale Beschreibung im Checkout.
Instance	Instanzname deines zahls.ch-Kontos ohne `.zahls.ch`. Lautet deine URL `beispiel.zahls.ch`, trägst du nur `beispiel` ein.
API key	Der API-Schlüssel aus API und Integrationen.
Look&Feel ID	Optional: Look & Feel ID für ein bestimmtes Checkout-Design. Bei nur einem Profil kannst du das Feld leer lassen.
Prefix	Optional: Präfix für die Bestellreferenz, wenn mehrere Shops dasselbe zahls.ch-Konto nutzen.
Logos	Wähle die Zahlungsmittel-Logos, die im Checkout angezeigt werden sollen.

Speichere die Einstellungen.

Webhook einrichten

Damit Bestellungen in WooCommerce den korrekten Status erhalten, musst du in zahls.ch einen Webhook anlegen:

Navigiere im Dashboard zu Webhooks.
Klicke auf Webhook erstellen.
Trage folgende Webhook-URL ein und ersetze die Domain durch deine Shop-Domain:

https://www.ihredomain.ch/?wc-api=wc_zahls_gateway

Wähle als Webhook-Inhaltstyp PHP-Post.
Aktiviere das Ereignis Transaction.
Speichere den Webhook.

Weitere Informationen: Webhooks.

Abonnemente

Damit Kunden im Checkout Abonnemente abschliessen können, installiere und aktiviere das Plugin WooCommerce Subscriptions. Anschliessend kannst du in den zahls.ch-Plugin-Einstellungen wiederkehrende Zahlungen aktivieren.

Bei Abonnementen wird unterschieden zwischen solchen mit einer automatischen und solchen mit einer manuellen Erneuerung:

Automatische Erneuerung

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

Modifikationen an Kunden

zahls.ch 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 «WooCommerce Subscriptions» oder manuell durch einen Benutzer in WordPress verursacht worden sein.

Rückerstattungen

Um einem Kunden den Betrag oder Teilbetrag einer Transaktion zurückzuerstatten, gehe nach der folgenden Anleitung vor:

Rückerstattung und Teilrückerstattung

Nachdem du die Rückerstattung in zahls.ch 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 zahls.ch:

Der Kunde wählt ein Produkt aus und legt es in den Warenkorb.
Nach der Überprüfung seines Warenkorbs fährt der Kunde weiter zum Checkout.
Der Kunde wählt die Zahlungsmethode zahls.ch (z. B. «Credit Cards / TWINT») aus.
Der Kunde wird zur Bezahlseite von zahls.ch weitergeleitet, wo er die gewünschte Zahlungsart wählt und die Zahlung abschliesst.