Einen Webhook-Endpoint mit Workbench einrichtenBeta
In diesem Leitfaden wird beschrieben, wie Sie mit Workbench einen Webhook-Endpoint einrichten.
Einen Webhook-Endpoint bei Workbench registrieren
So registrieren Sie einen Webhook-Endpoint in Workbench:
- Öffnen Sie Workbench im Dashboard und klicken Sie dann auf die Registerkarte Webhooks.
- Klicken Sie auf Neuen Webhook-Endpoint registrieren.
- Wählen Sie die API-Version für das Ereignisobjekt aus, das Sie verwenden möchten.
- Wenn Sie Connect nutzen, können Sie Ereignisse in verbundenen Konten überwachen. Andernfalls wählen Sie Ereignisse in Ihrem Konto aus.
- Wählen Sie die Ereignistypen aus, die Sie an einen Webhook-Endpoint senden möchten, und klicken Sie dann auf Weiter.
- Geben Sie die Endpoint-URL für Stripe zum Senden von Webhooks und eine optionale Beschreibung für den Endpoint an.
- Klicken Sie auf Ziel erstellen, um Ihren Webhook-Endpoint zu erstellen.
Einen neuen Webhook-Endpoint über die Registerkarte Webhooks registrieren
Einen vorhandenen Webhook-Endpoint konfigurieren
Sie können vorhandene Webhook-Endpoints auf der Workbench-Registerkarte Webhooks aktualisieren oder löschen. Sie können einen registrierten Webhook-Endpoint auch vorübergehend deaktivieren. Stripe versucht nicht erneut, Ereignisse zu senden, die generiert werden, während der jeweilige Webhook-Endpoint deaktiviert ist. Sie können Webhook-Endpoints auch programmgesteuert verwalten.
Ereignisübermittlungen anzeigen
Um Ereignisübermittlungen anzuzeigen, wählen Sie zuerst den Webhook-Endpoint unter Webhooks aus und wählen dann die Registerkarte Ereignisübermittlungen aus.
Die Registerkarte Ereignisübermittlungen enthält eine Liste der Ereignisse und deren Status Delivered
, Pending
oder Failed
. Klicken Sie auf ein Ereignis, um die Delivery attempts
anzuzeigen, die den HTTP-Statuscode früherer Übermittlungsversuche und die Zeit ausstehender zukünftiger Übermittlungen enthalten.
Übermittlungsversuche eines Ereignisses auf der Registerkarte Ereignisübermittlungen eines Webhook-Endpoints anzeigen.
Erneut versuchen, ein Ereignis zu senden
Im Live-Modus versucht Stripe bis zu 3 Tage lang, ein bestimmtes Ereignis mit einem exponentiellen Backoff an Ihren Webhook-Endpoint zu übermitteln. Im Abschnitt Ereignisübermittlungen Ihres in Workbench aufgeführten Webhook-Endpoints können Sie anzeigen, wann der nächste Wiederholungsversuch stattfindet.
Im Test-Modus wiederholt Stripe die Übermittlung dreimal innerhalb weniger Stunden. Sie können die Übermittlung einzelner Ereignisse an Ihren Webhook-Endpoint nach dieser Zeit manuell über die Registerkarte Webhooks von Workbench wiederholen, indem Sie zu den für den gewünschten Endpoint aufgelisteten Ereignisübermittlungen navigieren. Sie können auch verpasste Ereignisse abfragen, um die Daten über einen beliebigen Zeitraum abzugleichen.
Versuchen Sie erneut, Ereignisse über die Registerkarte Ereignisübermittlungen eines Webhook-Endpoints zu senden.