Freiberufler
Werbetreibende
Kirchengemeinden
Wohltätigkeitsorganisationen
Kostenloses Plugin
Kostenlos vs. Pro
Bewertungen
Blog
Anleitungen
Stripe ist das beliebteste und funktionsreichste Zahlungs-Gateway für die Abonnement-Abrechnung in WooCommerce. Diese Anleitung führt durch die vollständige Stripe-Integration mit WPSubscription — vom Verbinden der API-Schlüssel über die Konfiguration der Webhooks bis zur Aktivierung von Smart Retries für fehlgeschlagene Zahlungen und der Einrichtung des SCA-konformen 3-D Secure.
Die gesamte Integration dauert bei sorgfältigem Vorgehen 30-45 Minuten und ergibt ein Abrechnungssystem, das auch bei hohem Volumen zuverlässig läuft.
Warum das wichtig ist
Stripe bietet die beste Kombination von Funktionen für Abonnement-Unternehmen: Smart Retries (per Machine Learning optimierte Wiederholungslogik, die 10-20 % mehr fehlgeschlagene Zahlungen zurückgewinnt als eine einfache Wiederholung), Card Updater (automatische Aktualisierung abgelaufener Karten ohne Zutun des Kunden), starke 3-D-Secure-Unterstützung für die SCA-Konformität und die zuverlässigste Webhook-Zustellung der Branche. Stripe hat außerdem die beste Entwicklerdokumentation, die niedrigsten Ablehnungsquoten bei den ausgebenden Banken und die breiteste internationale Abdeckung (über 40 Länder).
Für die meisten WooCommerce-Abonnement-Shops ist Stripe damit die klare Standardwahl — Wettbewerber wie PayPal decken bestimmte Anwendungsfälle ab, doch Stripe ist das Arbeitspferd.
Bevor Sie beginnen
- Ein Stripe-Konto (kostenlos unter stripe.com anzulegen)
- WPSubscription ist installiert und aktiviert
- Administratorzugang sowohl zu WordPress als auch zu Ihrem Stripe-Dashboard
- Die Verifizierung Ihres Unternehmens in Stripe ist abgeschlossen (vor dem Live-Betrieb erforderlich)
- Ein aktives SSL-Zertifikat auf Ihrer WordPress-Website (für den Live-Modus erforderlich)
Schritt-für-Schritt-Anweisungen
Die Stripe-API-Schlüssel abrufen
Melden Sie sich im Stripe-Dashboard unter dashboard.stripe.com an. Gehen Sie zu Developers → API keys.
Dort sehen Sie zwei Sätze von Schlüsseln: Testmodus (für die Entwicklung) und Live-Modus (für den Produktivbetrieb). Kopieren Sie Ihren veröffentlichbaren Schlüssel (beginnt mit pk_) und Ihren geheimen Schlüssel (beginnt mit sk_).
Verwenden Sie für die Ersteinrichtung die Schlüssel des Testmodus (pk_test_ / sk_test_) — auf die Live-Schlüssel wechseln Sie erst, wenn die Integration vollständig geprüft ist. Halten Sie Ihren geheimen Schlüssel unter Verschluss und behandeln Sie ihn wie ein Passwort.
Die API-Schlüssel in WooCommerce eintragen
Gehen Sie im WordPress-Adminbereich zu WooCommerce → Einstellungen → Zahlungen → Stripe. Ist Stripe nicht aufgeführt, müssen Sie zunächst die Erweiterung WooCommerce Stripe Payment Gateway installieren.
Fügen Sie Ihren veröffentlichbaren Schlüssel in das Feld für den veröffentlichbaren Schlüssel und Ihren geheimen Schlüssel in das Feld für den geheimen Schlüssel ein. Aktivieren Sie vorerst den Testmodus.
Konfigurieren Sie weitere Stripe-Funktionen nach Bedarf: Stripe Link für den Ein-Klick-Checkout, Apple Pay und Google Pay. Speichern Sie die Änderungen.
Die Stripe-Webhooks konfigurieren
Gehen Sie im Stripe-Dashboard zu Developers → Webhooks → Add endpoint. Tragen Sie als Endpunkt-URL ein: https://yoursite.com/wc-api/wc_stripe (ersetzen Sie yoursite.com durch Ihre tatsächliche Domain — https ist zwingend).
Wählen Sie unter „Events to listen to“ mindestens aus: payment_intent.succeeded, payment_intent.payment_failed, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.payment_succeeded, invoice.payment_failed. Speichern Sie und kopieren Sie das von Stripe erzeugte Signaturgeheimnis (es beginnt mit whsec_).
Das Webhook-Signaturgeheimnis in WooCommerce hinterlegen
Fügen Sie das Signaturgeheimnis des Stripe-Webhooks unter WooCommerce → Einstellungen → Zahlungen → Stripe in das Feld für das Webhook-Geheimnis ein. Dieser Schritt ist entscheidend — ohne ihn kann WooCommerce nicht überprüfen, ob eingehende Webhook-Ereignisse tatsächlich von Stripe stammen, und Verlängerungen werden möglicherweise nicht ausgelöst.
Das Signaturgeheimnis unterscheidet sich zwischen Test- und Live-Modus — beim Wechsel in den Live-Modus müssen Sie es also aktualisieren. Speichern Sie die Änderungen.
Smart Retries und Card Updater aktivieren
Gehen Sie im Stripe-Dashboard zu Settings → Subscriptions and billing. Aktivieren Sie „Smart Retries“ — die per Machine Learning gesteuerte Wiederholungslogik von Stripe, die den Zeitpunkt anhand des konkreten Ablehnungsgrunds und der Muster der jeweiligen Bank optimiert.
Aktivieren Sie außerdem „Card Updater“, sofern verfügbar — damit werden abgelaufene Kartendaten ohne Zutun des Kunden automatisch bei dessen Bank aktualisiert. Beide Funktionen senken die unfreiwillige Abwanderung deutlich und sind praktisch kostenlose Verbesserungen.
Testen und in den Live-Modus wechseln
Schließen Sie ein Test-Abonnement mit der Stripe-Testkarte 4242 4242 4242 4242, einem beliebigen zukünftigen Ablaufdatum und einer beliebigen dreistelligen Prüfziffer ab. Prüfen Sie, ob es unter WooCommerce → Subscriptions (Abonnements) und in Stripe unter Customers erscheint.
Kontrollieren Sie im Stripe-Webhook-Dashboard, ob die Ereignisse erfolgreich zugestellt wurden (Antwort 200). Testen Sie eine Verlängerung mit den Test Clocks von Stripe, indem Sie die Zeit vorstellen.
Kehren Sie danach zu WooCommerce → Einstellungen → Zahlungen → Stripe zurück, deaktivieren Sie den Testmodus, ersetzen Sie die Testschlüssel durch die Live-Schlüssel, hinterlegen Sie das Signaturgeheimnis des Live-Modus für den Webhook und führen Sie einen letzten kleinen Test mit echtem Geld durch.
Profi-Tipps
- Aktivieren Sie Smart Retries sofort — die per Machine Learning optimierten Wiederholungen von Stripe gewinnen 10-20 % mehr fehlgeschlagene Zahlungen zurück
- Konfigurieren Sie Stripe Tax, um Umsatzsteuer bzw. Mehrwertsteuer bei jeder Verlängerung automatisch zu berechnen und abzuführen
- Nutzen Sie Stripe Radar zur Betrugserkennung — die Risikobewertung per Machine Learning stoppt betrügerische Abonnements vor der Aktivierung
- Richten Sie Abfragen in Stripe Sigma ein, um Abonnement-Auswertungen jenseits des Standard-Dashboards zu erhalten
- Aktivieren Sie das Stripe Customer Portal als Selbstbedienungsergänzung zum Bereich Mein Konto in WooCommerce
Ergebnis
Stripe ist vollständig in WPSubscription integriert und übernimmt das Anlegen von Abonnements, die automatische wiederkehrende Abrechnung, das Erkennen und Zurückgewinnen fehlgeschlagener Zahlungen über Smart Retries, die SCA-konforme Authentifizierung per 3-D Secure sowie die nahtlose Verarbeitung der Ereignisse per Webhook — alles ohne manuelles Eingreifen.
Fehlerbehebung
Problem:Webhook-Ereignisse werden im Stripe-Dashboard als fehlgeschlagen angezeigt
Lösung:Die häufigste Ursache ist eine falsche Endpunkt-URL oder ein Problem mit dem SSL-Zertifikat. Prüfen Sie, ob die URL exakt your-store.com/wc-api/wc_stripe lautet (kein überzähliger Schrägstrich, zwingend über https). Kontrollieren Sie, ob Ihre Website ein gültiges SSL-Zertifikat besitzt (weder selbst signiert noch abgelaufen). Prüfen Sie außerdem, ob eine Firewall, ein Sicherheits-Plugin (Wordfence, Sucuri) oder eine Ratenbegrenzung die Webhook-Anfragen blockiert.
Problem:Abonnements sind aktiv, die Verlängerungsbelastungen werden aber nicht ausgelöst
Lösung:Prüfen Sie WooCommerce → Status → Protokolle auf Stripe-Einträge. Häufig fehlt das Webhook-Signaturgeheimnis oder es ist veraltet. Kopieren Sie es erneut unter Stripe → Developers → Webhooks → Ihr Endpunkt → Signing secret und aktualisieren Sie das Feld in WooCommerce. Prüfen Sie außerdem, ob der WordPress-Cron läuft — unter WooCommerce → Status → Geplante Aktionen.
Problem:Kunden erhalten Fehlermeldungen bei der 3-D-Secure-Authentifizierung
Lösung:Für Kunden in der EU und im Vereinigten Königreich ist das aufgrund der PSD2- und SCA-Anforderungen normal. WPSubscription verarbeitet 3-D Secure mit Stripe automatisch — der Kunde muss die Authentifizierung jedoch bei seiner Bank abschließen (Code per SMS, Push-Nachricht in der Banking-App, biometrische Bestätigung). Gelingt das nicht, sollte der Kunde seine Bank kontaktieren und prüfen lassen, ob das Verfahren korrekt eingerichtet ist. Manche Banken verlangen vorab eine Registrierung für 3-D Secure.
Problem:Stripe belastet Kunden, in WooCommerce erscheinen aber keine Bestellungen
Lösung:Das deutet auf eine fehlgeschlagene Webhook-Zustellung hin — Stripe hat belastet, WooCommerce aber nicht benachrichtigt. Prüfen Sie die Webhook-Protokolle in Stripe auf fehlgeschlagene Zustellungen. Häufige Ursachen: eine abweichende Endpunkt-URL, eine Server-Ausfallzeit, ein blockierendes Sicherheits-Plugin oder ein nicht übereinstimmendes Signaturgeheimnis. Sie können fehlgeschlagene Webhooks im Stripe-Dashboard erneut senden, um den Abgleich manuell nachzuholen.
Häufig gestellte Fragen
Warum Stripe statt PayPal für WooCommerce-Abonnements?
Was kostet Stripe für Abonnements?
Wie handhabe ich Stripe Tax bei Abonnements?
Was ist Stripe Radar und sollte ich es aktivieren?
Kann ich Stripe im Testmodus betreiben und gleichzeitig echte Zahlungen über PayPal annehmen?
Verwandte Glossarbegriffe
Weitere Anleitungen
Wiederkehrende Zahlungen in WooCommerce einrichten
6 Schritte · Verbinden Sie Ihr Zahlungs-Gateway und konfigurieren Sie automatische Abrechnungspläne für Abonnement-Produkte.
Fehlgeschlagene Zahlungen in WooCommerce behandeln
6 Schritte · Konfigurieren Sie automatische Wiederholungen und Kundenbenachrichtigungen, um fehlgeschlagene Abonnement-Zahlungen zurückzugewinnen.
Abonnement-Verlängerungen in WooCommerce automatisieren
6 Schritte · Richten Sie mit WPSubscription eine vollständig automatische Verlängerungsabrechnung ein, damit Ihr Umsatz von selbst läuft.
