WooCommerce-Plugin-Guide

Dieser Guide verbindet einen WooCommerce-Shop von Anfang bis Ende mit FlowAlp Pay: Integration im Dashboard aktivieren, Plugin installieren und verbinden, Zahlungsmethoden zuordnen und alles mit einer Testbestellung prüfen. Das Plugin bietet Multi-Currency-Support, Zahlungsmethoden-Icons im Checkout, Warenkorb-Übertragung, Webhook-Statusupdates, Look-and-Feel-Konfiguration, Einstellungen pro Methode, Subscription-Support und Rückerstattungs-Synchronisation.

Voraussetzungen#

• Eine aktuelle WordPress- und WooCommerce-Installation — der genau getestete Versionsbereich steht im Plugin-Eintrag
• Ein FlowAlp Pay Konto mit Dashboard-Zugriff unter https://pay.flowalp.com (Konto erstellen)
• Die WooCommerce-Integration in Ihrem Dashboard — die Verfügbarkeit hängt von Ihrer Kontokonfiguration ab
• Ein öffentlich erreichbarer Storefront über HTTPS mit gültigem Zertifikat

Schritt 1 — Integration in FlowAlp Pay aktivieren#

1. Melden Sie sich unter https://pay.flowalp.com an und öffnen Sie API & Plugins.
2. Klicken Sie unter E-Commerce-Integration hinzufügen auf Alle anzeigen und fügen Sie WooCommerce hinzu.
3. Das Panel zeigt den für diese Verbindung ausgestellten API-Key und Ihren [Instanznamen](/de/docs/flowalp-pay-instance-name-de/).
4. Tragen Sie die Shop-Adresse ein — die exakte Storefront-URL. Liegt der Shop in einem Unterverzeichnis, geben Sie den vollen Pfad an, z. B. https://meine-website.example/shop.
5. Entscheiden Sie, ob fehlgeschlagene Webhooks wiederholt werden sollen: bis zu 10 Versuche nach 5 Minuten, 15 Minuten, 1 Stunde, 2 Stunden, 4 Stunden und danach alle 24 Stunden.
6. Klicken Sie zum Abschluss auf Aktivieren.

Schritt 2 — Plugin in WordPress installieren#

1. Gehen Sie in WordPress zu Plugins → Plugin hinzufügen.
2. Installieren Sie das WooCommerce-Zahlungs-Plugin für Ihr FlowAlp Pay Konto — das Integrations-Panel im Dashboard verlinkt auf den richtigen Eintrag.
3. Klicken Sie auf Jetzt installieren, danach auf Aktivieren.

Schritt 3 — Plugin mit dem Konto verbinden#

Öffnen Sie WooCommerce → Einstellungen und wechseln Sie auf den vom Plugin ergänzten Tab der Zahlungsplattform. Wählen Sie den Plattform-Eintrag, tragen Sie Ihren Instanznamen ein — die Subdomain Ihrer Zahlungsseiten-URL, also demo-shop bei demo-shop.pay.flowalp.com — und starten Sie die Verbindung. Sie werden zum FlowAlp Pay Login unter https://login.pay.flowalp.com weitergeleitet; nach der Anmeldung sind Shop und Konto automatisch verknüpft.

Zeigt Ihre Plugin-Version statt des Assistenten manuelle Credential-Felder, fügen Sie Instanzname und API-Key exakt so ein, wie das Integrations-Panel im Dashboard sie anzeigt.

Schritt 4 — Zahlungsmethoden aktivieren und zuordnen#

1. Gehen Sie zu WooCommerce → Einstellungen → Zahlungen — jede Zahlungsmethode erscheint als eigener Eintrag.
2. Aktivieren oder deaktivieren Sie Methoden über das Drei-Punkte-Menü.
3. Klicken Sie bei einer Methode auf Verwalten, um Titel, Beschreibung und — wo angeboten — den Subscription-Support zu setzen.
4. Speichern Sie die Änderungen.

Eine Methode erscheint nur im Checkout, wenn sie auch auf Ihrem FlowAlp Pay Konto aktiv ist und die Shop-Währung unterstützt. Typische Schweizer Line-ups umfassen TWINT, Visa, Mastercard, American Express, PostFinance, Apple Pay, Google Pay, PayPal und Klarna — die Verfügbarkeit hängt von Ihrer Kontokonfiguration ab; siehe Zahlungsmethoden.

Schritt 5 — Testbestellung durchführen#

1. Wechseln Sie in den TEST-Modus, wie in Testing für Entwickler beschrieben.
2. Legen Sie ein Produkt in den Warenkorb und gehen Sie zum Checkout.
3. Wählen Sie eine Zahlungsmethode — WooCommerce leitet auf die FlowAlp Pay Zahlungsseite weiter.
4. Bezahlen Sie mit Testkarten oder Test-Credentials.
5. Prüfen Sie die Ergebnisse: Der Browser kehrt zur Bestätigungsseite des Shops zurück, die WooCommerce-Bestellung wechselt den Status, die Transaktion erscheint im Dashboard und das Webhook-Log verzeichnet eine 200-Antwort.

Subscriptions und wiederkehrende Zahlungen#

Um wiederkehrende Produkte zu verkaufen, installieren und aktivieren Sie das Plugin WooCommerce Subscriptions. Es gibt zwei Verlängerungsmodelle: Bei der automatischen Verlängerung wird die hinterlegte Zahlungsmethode bei Fälligkeit belastet — das unterstützen nur bestimmte Methoden. Bei der manuellen Verlängerung erhält die Kundschaft pro fälliger Rate eine E-Mail mit einem Zahlungslink — das funktioniert mit allen Methoden Ihres Kontos. Möchten Sie gar keine wiederkehrenden Zahlungen, deaktivieren Sie die Funktion unter WooCommerce → Einstellungen → Subscriptions. Hintergrund zur Abrechnungsseite: Abos und wiederkehrende Zahlungen.

Rückerstattungen#

Führen Sie volle oder teilweise Rückerstattungen im FlowAlp Pay Dashboard aus. Nach Abschluss wird die Rückerstattung automatisch an WooCommerce gemeldet und erscheint an der Bestellung.

Fehlerbehebung#

FAQ#

• Wo finde ich Instanzname und API-Key? Im Dashboard unter API & Plugins, im Panel der WooCommerce-Integration — siehe auch API-Zugangsdaten.
• Kann ich testen, ohne echtes Geld zu belasten? Ja — nutzen Sie den TEST-Modus mit den Testkarten und führen Sie mindestens eine erfolgreiche und eine fehlgeschlagene Zahlung durch.
• Unterstützt das Plugin mehrere Währungen? Ja. Jede Zahlungsmethode muss die verwendete Währung allerdings unterstützen.
• Bleibt der Checkout in meinem Shop? Das Plugin nutzt den Redirect-Flow zur gehosteten Zahlungsseite; eingebettete Varianten für eigene Seiten zeigt der Checkout-Überblick.
• Ein Kunde oder eine Subscription ist verschwunden — hat das Zahlungs-Plugin sie gelöscht? Nein. Das Plugin verändert nie Kundendaten in WooCommerce; prüfen Sie das Subscriptions-Plugin oder manuelle Änderungen durch WordPress-Benutzer.