Skip to main content

Ereignisse zur Wiederherstellung verlassener Warenkörbe

Die folgenden Webhook-Ereignisse verfolgen den Lebenszyklus der Wiederherstellung von verlassenen Warenkörben:

Felder des Payloads für verlassene Checkouts

string
erforderlich
Die ursprüngliche Zahlung, die verlassen wurde. Verwenden Sie dies, um Produkt-, Betrags- und Währungsdetails nachzuschlagen.
string
erforderlich
Die Marke, zu der dieser abgebrochene Checkout gehört.
string
erforderlich
Der Kunde, der den Checkout abgebrochen hat.
string
erforderlich
Warum der Checkout abgebrochen wurde. Einer der folgenden Werte:
  • payment_failed — Der Kunde hat eine Zahlung versucht, aber sie ist fehlgeschlagen
  • checkout_incomplete — Der Kunde hat den Checkout besucht, aber nie eine Zahlung versucht
string
erforderlich
Aktueller Lebenszyklusstatus dieses Wiederherstellungsversuchs. Einer der folgenden Werte:
  • abandoned — Erkannt, noch keine E-Mails versendet
  • recovering — Mindestens eine Wiederherstellungs-E-Mail versendet
  • recovered — Der Kunde hat die Zahlung abgeschlossen
  • exhausted — Alle E-Mails versendet oder ein neuerer Checkout gefunden
  • opted_out — Der Kunde hat sich abgemeldet
string
erforderlich
ISO-8601-Zeitstempel des Zeitpunkts, zu dem der Checkout als abgebrochen erkannt wurde.
string | null
Die Zahlungs-ID der erfolgreichen Wiederherstellungszahlung. null, bis der Checkout wiederhergestellt wurde.

Beispiel: Verarbeitung von ACR-Webhooks


Dunning-Ereignisse

Die folgenden Webhook-Ereignisse verfolgen den Dunning-Lebenszyklus eines Abonnements:

Felder der Dunning-Versuch-Payload

string
erforderlich
Das Abonnement, das den Dunning-Versuch ausgelöst hat.
string
erforderlich
Die Marke, zu der dieser Dunning-Versuch gehört.
string
erforderlich
Der Kunde, dem das Abonnement gehört.
string
erforderlich
Der Abonnementstatus, der das Dunning ausgelöst hat. Einer von:
  • on_hold — Verlängerungen aufgrund eines fehlgeschlagenen Zahlungsvorgangs gestoppt
  • cancelled — Der Kunde hat über das Customer Portal gekündigt
string
erforderlich
Aktueller Lebenszyklusstatus dieses Dunning-Versuchs. Einer der folgenden Werte:
  • recovering — Dunning-E-Mails werden versendet
  • recovered — Der Kunde hat die Zahlungsmethode aktualisiert und die Zahlung war erfolgreich
  • exhausted — Alle E-Mails versendet oder der Abonnementstatus hat sich geändert
string
erforderlich
ISO-8601-Zeitstempel des Zeitpunkts, zu dem der Dunning-Versuch erstellt wurde.
string | null
Die Zahlungs-ID der erfolgreichen Wiederherstellungszahlung. null während der Wiederherstellung.

Beispiel: Verarbeitung von Dunning-Webhooks

Abonniere sowohl dunning.started als auch dunning.recovered, um den vollständigen Dunning-Lebenszyklus zu verfolgen. Verwende dunning.started, um Kulanzzeiträume zu pausieren oder in deinem System abonnierten Kunden mit erhöhtem Risiko zu kennzeichnen.

Abandoned Cart Recovery

Konfiguriere ACR-E-Mail-Sequenzen und Rabattanreize.

Subscription Dunning

Konfiguriere Dunning-E-Mail-Sequenzen für ausgelaufene Abonnements.

Subscription Webhooks

Verwandte Ereignisse im Lebenszyklus eines Abonnements wie subscription.on_hold und subscription.cancelled.

Schema der Webhook-Payload

Webhook payload for abandoned_checkout.detected and abandoned_checkout.recovered events

abandoned_at
string<date-time>
erforderlich
abandonment_reason
enum<string>
erforderlich
Verfügbare Optionen:
payment_failed,
checkout_incomplete
brand_id
string
erforderlich

Brand id this abandoned checkout belongs to

customer_id
string
erforderlich
payment_id
string
erforderlich
status
enum<string>
erforderlich
Verfügbare Optionen:
abandoned,
recovering,
recovered,
exhausted,
opted_out
recovered_payment_id
string | null
Zuletzt geändert am 21. August 2026