Warum funktioniert mein WooCommerce-Zahlungsgateway nicht mehr?

Ein Zahlungsgateway ist die Verbindung zwischen Ihrem WooCommerce-Shop und dem Unternehmen, das Ihre Zahlungen abwickelt, etwa Stripe, PayPal oder Ihre Bank. Wenn es nicht mehr funktioniert, können Kunden möglicherweise nicht bezahlen, oder sie bezahlen, ohne dass Ihr Shop davon erfährt.

Vielleicht stellen Sie fest, dass:

• eine Zahlungsart aus dem Checkout verschwunden ist
• Kunden beim Bezahlen eine Fehlermeldung sehen
• jede Zahlung abgelehnt wird, auch mit gültigen Karten
• Bestellungen auf „Pending payment“ (Zahlung ausstehend) stehen bleiben, obwohl der Kunde sagt, er habe bezahlt
• Zahlungen im Dashboard Ihres Zahlungsanbieters erscheinen, aber nicht in WooCommerce
• Sie eine E-Mail Ihres Zahlungsanbieters zu Ihrem Konto erhalten haben

Dieses Problem sollten Sie zügig angehen, weil es Umsatz kostet und Kunden im Unklaren lassen kann, ob ihnen etwas abgebucht wurde. Ein Gateway-Problem bedeutet jedoch in der Regel nicht, dass Geld verloren ist. Meist liegen die Zahlungsinformationen weiterhin bei Ihrem Anbieter vor, und die Ursache lässt sich durch die Prüfung einiger bestimmter Punkte finden.

Dieser Leitfaden erklärt, was meistens schiefgeht, was Sie sicher prüfen können, wie Sie mit ausstehenden Bestellungen umgehen und wann es besser ist, technische Unterstützung anzufordern.

Wie funktioniert ein Zahlungsgateway in WooCommerce?

Die meisten Gateways werden WooCommerce über ein Plugin hinzugefügt, das meist vom Zahlungsunternehmen oder von einem Drittentwickler stammt.

Eine typische Zahlung umfasst mehrere Schritte:

1. Der Kunde wählt im Checkout eine Zahlungsart.
2. WooCommerce legt die Bestellung mit dem Status „Pending payment“ (Zahlung ausstehend) an.
3. Der Kunde bezahlt, auf Ihrer Website oder auf der Seite des Anbieters.
4. Der Anbieter sendet eine Bestätigung an Ihre Website zurück, oft über einen Webhook oder eine ähnliche Benachrichtigung.
5. WooCommerce aktualisiert die Bestellung, zum Beispiel auf „Processing“ (In Bearbeitung), und versendet die Bestätigungs-E-Mail.

Ein Problem bei jedem dieser Schritte kann Zahlungen verhindern. Am verwirrendsten sind Fehler bei Schritt 4: Der Kunde hat bezahlt, aber Ihr Shop erhält die Bestätigung nie.

Was könnte das Problem verursacht haben?

Abgelaufene oder geänderte API-Schlüssel und Zugangsdaten

Das Gateway-Plugin nutzt Schlüssel, Tokens oder andere Zugangsdaten, um mit Ihrem Anbieter zu kommunizieren. Wenn diese ablaufen, im Dashboard des Anbieters neu erzeugt oder von einem Kollegen ersetzt werden, kann das Plugin keine Verbindung mehr herstellen.

Das passiert oft, wenn jemand aus Sicherheitsgründen Schlüssel erneuert, das Konto auf einen neuen Benutzer überträgt oder das Plugin neu verbindet.

Testmodus noch aktiv

Viele Gateways haben einen Test- oder Sandbox-Modus, um Zahlungen ohne echtes Geld auszuprobieren. Wenn er nach Tests aktiv geblieben ist oder versehentlich eingeschaltet wurde, werden echte Karten möglicherweise abgelehnt, oder Bestellungen erscheinen als bezahlt, obwohl keine echte Zahlung eingegangen ist.

Fehlgeschlagene Webhooks

Webhooks sind Nachrichten, die der Anbieter an Ihre Website sendet, wenn etwas passiert, etwa eine erfolgreiche Zahlung oder eine Erstattung. Wenn sie Ihre Website nicht erreichen, können Zahlungen beim Anbieter erfolgreich sein, während Bestellungen in WooCommerce ausstehend bleiben.

Webhooks können scheitern, weil die beim Anbieter hinterlegte Adresse falsch ist, die Domain sich geändert hat, die Website offline war oder eine Sicherheits- oder Cache-Regel die Anfrage blockiert.

Probleme mit dem SSL-Zertifikat

Zahlungsanbieter erwarten eine sichere Verbindung. Wenn Ihr SSL-Zertifikat abgelaufen oder falsch konfiguriert ist oder die für Benachrichtigungen genutzte Domain nicht abdeckt, zeigt der Checkout möglicherweise Warnungen an und der Anbieter kann keine Webhooks zustellen.

Ein Update des Gateway-Plugins

Ein Update des Gateway-Plugins, von WooCommerce oder WordPress kann die Funktionsweise des Gateways ändern, neue Einstellungen erfordern oder einen Konflikt mit einem anderen Plugin oder mit der verwendeten Checkout-Art verursachen. Manche Gateways müssen nach einem größeren Update auch neu verbunden werden.

Einschränkungen bei Währung und Land

Eine Zahlungsart kann ausgeblendet oder abgelehnt werden, wenn sie die Shop-Währung, das Land des Kunden oder den Bestellbetrag nicht unterstützt. Wenn Sie die Shop-Währung ändern, neue Länder hinzufügen oder einen Währungsumrechner verwenden, kann eine Zahlungsart ohne Fehlermeldung verschwinden.

Das Konto ist vom Zahlungsanbieter eingeschränkt

Anbieter können ein Konto einschränken, zum Beispiel während sie Dokumente prüfen, das Unternehmen verifizieren oder ungewöhnliche Aktivitäten untersuchen. In diesem Fall liegt das Problem gar nicht auf Ihrer Website. Achten Sie auf E-Mails oder Hinweise im Dashboard des Anbieters.

Andere Probleme auf der Website

Manchmal ist das Gateway in Ordnung, aber der Checkout selbst ist defekt, zum Beispiel wegen eines JavaScript-Fehlers, eines Caches oder eines Plugin-Konflikts. Unser Leitfaden zu Problemen mit dem WooCommerce-Checkout behandelt diese Ursachen.

Was bedeuten Bestellungen, die auf „Pending payment“ hängen bleiben?

Eine Bestellung mit dem Status „Pending payment“ (Zahlung ausstehend) wurde angelegt, aber WooCommerce hat keine Zahlungsbestätigung erhalten.

Das kann bedeuten:

• der Kunde hat die Zahlung begonnen, aber nicht abgeschlossen
• die Zahlung ist fehlgeschlagen
• der Kunde hat bezahlt, aber die Bestätigung hat Ihre Website nicht erreicht

Der erste Fall ist normal: Manche Kunden brechen ihren Kauf ab. Ein plötzlicher Anstieg ausstehender Bestellungen oder Kunden, die Ihnen sagen, dass sie bezahlt haben, deuten auf den dritten Fall hin.

WooCommerce kann unbezahlte ausstehende Bestellungen nach einer in den Lagerbestandseinstellungen festgelegten Zeit automatisch stornieren. Ausstehende Bestellungen können daher später als storniert erscheinen.

Prüfen Sie die Zahlung im Dashboard Ihres Anbieters, bevor Sie eine ausstehende Bestellung als bezahlt markieren. Versenden Sie eine Bestellung niemals nur, weil der Kunde sagt, sie sei bezahlt.

Zuerst verstehen, was sich geändert hat

Überlegen Sie, was passiert ist, bevor die Zahlungen ausgefallen sind:

• Wurde das Gateway-Plugin, WooCommerce oder WordPress aktualisiert?
• Hat jemand die API-Schlüssel geändert oder das Konto neu verbunden?
• Wurde irgendwann der Testmodus aktiviert?
• Wurde die Domain geändert oder die Website migriert?
• Wurde das SSL-Zertifikat erneuert oder geändert?
• Wurde ein Sicherheits-Plugin, eine Firewall oder ein Cache anders konfiguriert?
• Haben Sie die Shop-Währung oder die Länder geändert, in die Sie verkaufen?
• Hat Ihr Zahlungsanbieter Ihnen eine E-Mail geschickt?

Prüfen Sie außerdem, wann die letzte erfolgreiche Zahlung in WooCommerce erfasst wurde, und vergleichen Sie das mit der letzten Zahlung im Dashboard Ihres Anbieters. Wenn sie abweichen, scheitert wahrscheinlich der Bestätigungsschritt.

Was können Sie sicher prüfen?

Das Dashboard des Zahlungsanbieters prüfen

Melden Sie sich im Dashboard Ihres Anbieters an und prüfen Sie:

• ob die letzten Zahlungen erscheinen und mit welchem Status
• Hinweise zu Ihrem Konto, zur Verifizierung oder zu Limits
• ob das Konto im Live-Modus oder im Testmodus ist
• die Einstellungen für Webhooks oder Benachrichtigungen, falls vorhanden

Die meisten Anbieter zeigen, ob die letzten Webhook-Zustellungen erfolgreich waren oder fehlgeschlagen sind. Wo genau, hängt vom Anbieter ab.

Die Gateway-Einstellungen in WooCommerce prüfen

Gehen Sie zu WooCommerce > Settings > Payments (auf Deutsch: WooCommerce > Einstellungen > Zahlungen) und öffnen Sie die Einstellungen des betroffenen Gateways. Prüfen Sie:

• ob die Zahlungsart aktiviert ist
• ob der Test- oder Sandbox-Modus im Live-Shop ausgeschaltet ist
• ob das Konto verbunden ist oder die Zugangsdaten eingetragen sind

Fügen Sie keine neuen Schlüssel ein, solange Sie nicht sicher sind, dass es die richtigen Live-Schlüssel für diesen Shop sind.

Die ausstehenden Bestellungen durchsehen

Gehen Sie zu WooCommerce > Orders (WooCommerce > Bestellungen) und filtern Sie nach „Pending payment“ (Zahlung ausstehend). Sehen Sie sich die Daten an. Wenn sich ausstehende Bestellungen ab einem bestimmten Tag häufen, ist das ein nützlicher Hinweis.

Eine Zahlung testen

Wenn möglich, geben Sie eine echte Bestellung mit geringem Betrag über das Live-Gateway auf und prüfen Sie das Ergebnis in WooCommerce und im Dashboard des Anbieters. Erstatten Sie den Betrag anschließend.

Ihren Zahlungsanbieter kontaktieren

Wenn Sie Hinweise zum Konto, Ablehnungen ohne klaren Grund oder fehlgeschlagene Webhooks sehen, wenden Sie sich an den Support Ihres Anbieters. Er sieht Details zu Ihrem Konto und zu seiner Seite der Verbindung, die von Ihrer Website aus nicht sichtbar sind.

Was sollten Sie vermeiden?

Vermeiden Sie:

• API-Schlüssel neu zu erzeugen, ohne zu wissen, wo sie sonst noch verwendet werden
• den Testmodus in einem Live-Shop während der Geschäftszeiten einzuschalten
• ausstehende Bestellungen als bezahlt zu markieren, ohne das Dashboard des Anbieters zu prüfen
• das Gateway-Plugin ohne Backup zu löschen und neu zu installieren
• die Firewall oder das Sicherheits-Plugin dauerhaft zu deaktivieren
• ein zweites Gateway-Plugin für denselben Anbieter neben dem ersten zu installieren
• API-Schlüssel oder Zugangsdaten per E-Mail oder in öffentlichen Foren weiterzugeben

Ändern Sie immer nur eine Sache und testen Sie nach jeder Änderung.

Wann sollten Sie technische Unterstützung anfordern?

Technische Unterstützung ist empfehlenswert, wenn:

• Kunden belastet werden, Bestellungen aber ausstehend bleiben
• alle Zahlungen scheitern und der Anbieter sagt, das Konto sei in Ordnung
• Webhooks fehlschlagen und Sie nicht erkennen, warum
• das Problem nach einem Update oder einer Migration begonnen hat
• Sie Abonnements oder wiederkehrende Zahlungen verkaufen
• der Shop individuellen Code rund um Checkout oder Zahlungen nutzt
• Sie sich nicht sicher fühlen, Gateway-Einstellungen in einem Live-Shop zu ändern
• das Problem immer wieder auftritt

Sie müssen die Ursache nicht kennen, bevor Sie um Hilfe bitten. Eine Beschreibung dessen, was Kunden sehen und was das Dashboard Ihres Anbieters zeigt, ist ein guter Ausgangspunkt.

Welche Informationen sollten Sie sammeln?

Nützliche Angaben sind:

• die URL der Website
• der Zahlungsanbieter und der Name des Gateway-Plugins
• Datum und Uhrzeit der letzten erfolgreichen Zahlung
• Screenshots von Fehlermeldungen, die Kunden angezeigt werden
• die Anzahl der Bestellungen, die auf „Pending payment“ hängen
• Hinweise oder E-Mails des Zahlungsanbieters
• ob Webhook-Zustellungen fehlschlagen, sofern Sie das sehen können
• kürzliche Updates, Migrationen oder geänderte Einstellungen
• den WooCommerce-Systemstatusbericht

Senden Sie keine API-Schlüssel, Passwörter oder vollständigen Kartendaten per E-Mail. D4Hub erklärt Ihnen, wie Sie Zugänge sicher teilen.

Wie D4Hub helfen kann

Ziel ist es, die Zahlungen wiederherzustellen und sicherzustellen, dass jede bezahlte Bestellung korrekt erfasst wird.

Je nach Problem kann D4Hub Sie unterstützen bei:

• der Prüfung der Gateway-Konfiguration und der Verbindung
• der Auswertung der Logs von WooCommerce und Gateway
• der Prüfung der Webhook-Einstellungen und fehlgeschlagener Zustellungen
• dem Auffinden von Sicherheits-, Firewall- oder Cache-Regeln, die Zahlungsbenachrichtigungen blockieren
• der Behebung von SSL- und Domain-Problemen, die Zahlungen beeinträchtigen
• der Ermittlung von Konflikten durch Updates von Plugins, WooCommerce oder WordPress
• dem Abgleich ausstehender Bestellungen mit den Zahlungen im Dashboard Ihres Anbieters
• der Prüfung der Einstellungen zu Währung, Ländern und Checkout-Kompatibilität
• dem Test des gesamten Zahlungsablaufs nach der Korrektur
• Empfehlungen für ein Monitoring, damit Sie Zahlungsprobleme früher bemerken

Sie können in jeder Phase um Unterstützung bitten.

D4Hub kann zum Beispiel:

• bestätigen, ob eine geplante Änderung sicher ist
• die Untersuchung nach einem erfolglosen Versuch übernehmen
• die vollständige Diagnose und Reparatur durchführen
• den Zahlungsablauf nach einer vorübergehenden Lösung prüfen

echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null | openssl x509 -noout -dates

wp plugin list --status=active

Häufige Fragen

Wurde meinen Kunden doppelt abgebucht?

Das kann passieren, wenn ein Kunde nach einem scheinbaren Fehler erneut bezahlt. Prüfen Sie im Dashboard Ihres Anbieters, ob es doppelte Zahlungen desselben Kunden gibt, und erstatten Sie Duplikate direkt dort. Wenn Sie betroffene Kunden zügig kontaktieren, vermeiden Sie Verwirrung.

Warum ist eine Zahlungsart aus dem Checkout verschwunden?

Sie wurde vielleicht deaktiviert, unterstützt die aktuelle Währung, das Land oder den Bestellbetrag nicht, oder das Plugin ist nicht mit Ihrer Checkout-Art kompatibel. Prüfen Sie zuerst die Gateway-Einstellungen, dann die Logs.

Der Anbieter sagt, auf seiner Seite sei alles in Ordnung. Was nun?

Dann liegt das Problem wahrscheinlich auf Ihrer Website oder zwischen beiden: Zugangsdaten, Webhooks, SSL, eine Sicherheitsregel oder ein Plugin-Konflikt. Die WooCommerce-Logs und die Ergebnisse der Webhook-Zustellung sind die besten Ausgangspunkte.

Kann ich als schnelle Lösung zu einem anderen Zahlungsgateway wechseln?

Als vorübergehende Maßnahme kann das funktionieren, aber ein neues Gateway braucht ein eigenes Konto, eine eigene Verifizierung und eigene Tests. Außerdem löst es nicht den Abgleich der Bestellungen, die bereits ausstehend hängen. Betrachten Sie es als kurzfristige Option, nicht als Lösung.

Ist es sicher, ausstehende Bestellungen als bezahlt zu markieren?

Nur, nachdem Sie die Zahlung im Dashboard Ihres Anbieters bestätigt haben. Fügen Sie der Bestellung eine Notiz hinzu, die erklärt, wie Sie die Zahlung überprüft haben.

Kann D4Hub helfen, wenn ich bereits versucht habe, das Problem zu beheben?

Ja. Erklären Sie, was Sie geändert haben und was nach jeder Änderung passiert ist. Das hilft, den Ablauf zu rekonstruieren und den nächsten sicheren Schritt zu finden.