SchnittstellenVeröffentlicht: 11.09.2026 · 3 Min. Lesezeit

WooCommerce-Webhook deaktiviert: Bestellungen fehlen

Von Daniel Wesseling, Die Netzhandwerker · Angaben geprüft am 11.09.2026 gegen die WooCommerce-Dokumentation und den WooCommerce-Quellcode

Die kurze Antwort

WooCommerce deaktiviert einen Webhook automatisch, wenn mehr als fünf Zustellungen hintereinander scheitern. Als Fehlschlag zählt jede Antwort außer 2xx, 301 und 302. Danach bekommt das Zielsystem keine Bestellungen mehr, ohne dass im Shop etwas auffällt. Abhilfe: Ursache im Zustellprotokoll finden, Webhook wieder auf „Aktiv“ stellen und fehlende Bestellungen über die REST-API mit Datumsfilter nachholen.

Wann WooCommerce einen Webhook abschaltet

Laut Dokumentation deaktiviert WooCommerce einen Webhook nach mehr als fünf aufeinanderfolgenden Fehlzustellungen. Fehlschlag ist jede Antwort, die kein 2xx, 301 oder 302 ist, also etwa 4xx- und 5xx-Antworten. Im Quellcode der Klasse WC_Webhook ist die Grenze über den Filter woocommerce_max_webhook_delivery_failures einstellbar, Vorgabe 5. Eine erfolgreiche Zustellung setzt den Fehlerzähler wieder auf null; beim Abschalten löst WooCommerce die Aktion woocommerce_webhook_disabled_due_delivery_failures aus.

Ein Webhook hat drei Zustände: „Aktiv“ liefert aus, „Pausiert“ hält die Zustellung vorübergehend an, „Deaktiviert“ steht für einen Stopp wegen Fehlern.

So erkennen Sie es

Status: Unter WooCommerce > Einstellungen > Erweitert > Webhooks steht der Webhook auf „Deaktiviert“.
Protokoll: Unter WooCommerce > Status > Logs die Quelle webhooks-delivery wählen. WooCommerce protokolliert dort die Zustellungen samt Antwort des Zielservers.
Zielsystem: Die letzte dort angekommene Bestellung ist älter, als sie sein dürfte.

Woran die Zustellung scheitert

Das Protokoll zeigt den Antwortcode. Typische Bilder: Das Zielsystem war nicht erreichbar oder antwortete mit einem Serverfehler (5xx). Die Webhook-Adresse hat sich geändert oder verlangt eine neue Anmeldung (4xx). Oder das Ziel leitet mit einem anderen Code als 301 oder 302 weiter; auch das zählt nach der Regel oben als Fehlschlag. Sechs solche Antworten hintereinander genügen, etwa während eines Updates am Zielsystem.

Wieder aktivieren

Ursache beheben: Zielsystem erreichbar, Webhook-Adresse und Anmeldung stimmen.
Den Webhook öffnen, Status auf „Aktiv“ setzen, speichern.
Beim Speichern mit Status „Aktiv“ schickt WooCommerce laut Dokumentation einen Ping an die Webhook-Adresse. Im Protokoll prüfen, ob er ankommt.
Prüfen, ob das Zielsystem die Signatur noch prüft: Aus dem hinterlegten Secret bildet WooCommerce einen Hash, der im Kopf jeder Zustellung mitgeht.

Fehlende Bestellungen nachholen

Was während der Abschaltung passiert ist, liefert der Webhook nicht nach. Die Lücke schließt die REST-API: Der Endpunkt für Bestellungen kennt die Filter after und modified_after mit einem Datum nach ISO 8601, dazu dates_are_gmt für die Zeitzone. Damit lassen sich alle Bestellungen seit dem letzten erfolgreichen Eingang abrufen und im Zielsystem ergänzen. Wichtig: Das Zielsystem muss doppelte Bestellungen an der Bestellnummer erkennen, sonst entstehen beim Nachholen Dubletten.

Damit es nicht wieder still passiert

Eine Abschaltung meldet WooCommerce nicht von sich aus nach außen. Die Aktion beim Abschalten lässt sich für eine Warnung nutzen, und ein regelmäßiger Abgleich zwischen Shop und Zielsystem fällt auf, bevor Kunden nachfragen.

Wenn das Bordmittel nicht reicht

Wir richten eine Überwachung ein, die abgeschaltete Webhooks und fehlende Bestellungen meldet, und holen Lücken nach. Mehr dazu unter Schnittstellen-Wache.

Häufige Fragen

Warum hat WooCommerce meinen Webhook deaktiviert?

Weil mehr als fünf Zustellungen hintereinander gescheitert sind. Als Fehlschlag zählt jede Antwort außer 2xx, 301 und 302.

Wo sehe ich, warum ein WooCommerce-Webhook scheitert?

Unter WooCommerce, Status, Logs mit der Quelle webhooks-delivery. Dort steht die Antwort des Zielservers zu jeder Zustellung.

Liefert WooCommerce verpasste Webhooks nach?

Nein. Fehlende Bestellungen holen Sie über die REST-API nach, etwa mit dem Filter after oder modified_after ab dem letzten erfolgreichen Eingang.

Kann ich die Grenze von fünf Fehlern ändern?

Ja, über den Filter woocommerce_max_webhook_delivery_failures. Eine höhere Grenze verschiebt das Problem aber nur; die Ursache bleibt.

Wie merke ich künftig, dass ein Webhook abgeschaltet wurde?

Mit einer Warnung auf die Aktion woocommerce_webhook_disabled_due_delivery_failures oder einem regelmäßigen Abgleich zwischen Shop und Zielsystem.

Quellen

Alle Angaben geprüft am 11.09.2026. Herstellertexte in eigenen Worten zusammengefasst; Menüs und Versionen ändern sich, maßgeblich ist das jeweils aktuelle Hilfe-Dokument.