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
Der Kunde, der den Checkout verlassen hat.
string
erforderlich
Warum der Checkout verlassen wurde. Einer der folgenden:
  • payment_failed — Kunde hat versucht zu zahlen, aber es scheiterte
  • checkout_incomplete — Kunde hat den Checkout besucht, aber nie versucht zu zahlen
string
erforderlich
Aktueller Lebenszyklusstatus dieses Wiederherstellungsversuchs. Einer der folgenden:
  • abandoned — Erkannt, bisher keine E-Mails gesendet
  • recovering — Mindestens eine Wiederherstellungs-E-Mail gesendet
  • recovered — Kunde hat die Zahlung abgeschlossen
  • exhausted — Alle E-Mails gesendet oder neuerer Checkout gefunden
  • opted_out — Kunde hat sich abgemeldet
string
erforderlich
ISO 8601-Zeitstempel, wann der Checkout als verlassen erkannt wurde.
string | null
Die Zahlungs-ID der erfolgreichen Wiederherstellungszahlung. null bis der Checkout wiederhergestellt wird.

Beispiel: Umgang mit ACR-Webhooks


Dunning-Ereignisse

Die folgenden Webhook-Ereignisse verfolgen den Lebenszyklus der Abonnentenverwaltung:

Felder des Payloads für Dunning-Versuche

string
erforderlich
Das Abonnement, das den Dunning-Versuch ausgelöst hat.
string
erforderlich
Der Kunde, dem das Abonnement gehört.
string
erforderlich
Der Abonnementstatus, der das Dunning ausgelöst hat. Einer der folgenden:
  • on_hold — Abonnement aufgrund eines Zahlungsfehlers pausiert
  • cancelled — Kunde hat über das Kundenportal storniert
string
erforderlich
Aktueller Lebenszyklusstatus dieses Dunning-Versuchs. Einer der folgenden:
  • recovering — Dunning-E-Mails werden gesendet
  • recovered — Kunde hat Zahlungsmethode aktualisiert und Zahlung war erfolgreich
  • exhausted — Alle E-Mails gesendet oder Abonnementstatus geändert
string
erforderlich
ISO 8601-Zeitstempel, wann der Dunning-Versuch erstellt wurde.
string | null
Die Zahlungs-ID der erfolgreichen Wiederherstellungszahlung. null während der Wiederherstellung.

Beispiel: Umgang mit Dunning-Webhooks

Abonnieren Sie sowohl dunning.started als auch dunning.recovered, um den vollständigen Lebenszyklus der Abonnentenverwaltung zu verfolgen. Verwenden Sie dunning.started, um Karenzzeiten zu pausieren oder gefährdete Abonnements in Ihrem System zu markieren.

Abandoned Cart Recovery

Konfigurieren Sie ACR-E-Mail-Sequenzen und Rabattanreize.

Subscription Dunning

Konfigurieren Sie Dunning-E-Mail-Sequenzen für abgelaufene Abonnements.

Subscription Webhooks

Verwandte Abonnement-Lebenszyklusereignisse wie subscription.on_hold und subscription.cancelled.

Webhook-Payload-Schema

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 20. April 2026