Event-Typen & Bedeutung

Zu jedem überwachten Stripe-Ereignis schickt Churnbell eine Benachrichtigung mit Details und einer kurzen Erklärung. Hier findest du alle bekannten Ereignistypen im Überblick. Unbekannte Typen werden ebenfalls zugestellt — mit generischer Einordnung.

Ereignis	Bedeutung
🔔 Abo gekündigt `customer.subscription.deleted`	Dieses Abo ist beendet – der Kunde hat keine aktive Subscription mehr und wird nicht weiter abgerechnet. Wiederkehrender Umsatz (MRR) geht hier verloren.
⏳ Kündigung vorgemerkt `customer.subscription.updated`	Der Kunde hat zum Ende der laufenden Periode gekündigt. Das Abo bleibt bis zum genannten Datum aktiv, verlängert sich danach aber nicht – noch ist Zeit, ihn zurückzugewinnen.
⚠️ Zahlung fehlgeschlagen `invoice.payment_failed`	Eine (meist wiederkehrende) Zahlung ist fehlgeschlagen. Stripe versucht es in den nächsten Tagen automatisch erneut (Dunning). Gelingt es mehrfach nicht, kann das Abo am Ende gekündigt werden – frühe Erinnerung an den Kunden lohnt sich.
💰 Zahlung eingegangen `invoice.paid`	Eine Rechnung wurde erfolgreich bezahlt – das Geld ist deinem Stripe-Guthaben gutgeschrieben (die Auszahlung an dein Bankkonto folgt nach Stripes Auszahlungsplan).
🎉 Neues Abo `customer.subscription.created`	Ein Kunde hat ein neues Abo abgeschlossen – neuer wiederkehrender Umsatz. Startet es in einer Testphase, wird erst nach deren Ende abgerechnet.
🚨 Dispute eröffnet `charge.dispute.created`	Ein Kunde hat eine Zahlung bei seiner Bank angefochten (Chargeback). Der Betrag wird vorläufig einbehalten. WICHTIG: Bis zur genannten Frist Belege einreichen, sonst gilt der Dispute als verloren (Betrag + Gebühr).
🎉 Kündigung zurückgenommen `customer.subscription.updated`	Gute Nachricht: Der Kunde hat seine geplante Kündigung zurückgenommen – das Abo verlängert sich normal weiter.
ℹ️ Abo aktualisiert `customer.subscription.updated`	An einem Abo wurde etwas geändert (z. B. Plan, Menge, Zahlungsmittel oder Status).
⏰ Testphase endet bald `customer.subscription.trial_will_end`	Die kostenlose Testphase dieses Kunden läuft demnächst ab (Stripe meldet das rund 3 Tage vorher). Danach beginnt die reguläre Abrechnung – oder der Kunde springt ab. Guter Moment für eine Erinnerung.
💰 Zahlung erfolgreich `payment_intent.succeeded`	Ein Zahlungsvorgang wurde erfolgreich abgeschlossen. Das ist die technische Bestätigung hinter einer Zahlung – bei Abos/Rechnungen siehst du meist zusätzlich eine bezahlte Rechnung.
⚠️ Zahlung fehlgeschlagen `payment_intent.payment_failed`	Ein Zahlungsvorgang ist fehlgeschlagen (z. B. Karte abgelehnt, keine Deckung). Bei einmaligen Zahlungen muss der Kunde es erneut versuchen.
💰 Zahlung belastet `charge.succeeded`	Ein Zahlungsmittel (z. B. Karte) wurde erfolgreich belastet. Bei Abos/Rechnungen erscheint parallel meist eine bezahlte Rechnung – dann ist das hier nur die technische Belastung.
⚠️ Belastung fehlgeschlagen `charge.failed`	Die Belastung eines Zahlungsmittels ist fehlgeschlagen (z. B. abgelehnt oder keine Deckung).
↩️ Rückerstattung `charge.refunded`	Eine Zahlung wurde (ganz oder teilweise) an den Kunden zurückerstattet. Der Betrag wird deinem Stripe-Guthaben wieder belastet.
⚠️ Dispute aktualisiert `charge.dispute.updated`	Zu einer laufenden Zahlungsanfechtung (Chargeback) gibt es Neuigkeiten – z. B. wurden weitere Belege angefordert oder der Status hat sich geändert. Prüfe die Frist und reiche fehlende Nachweise rechtzeitig ein.
🚩 Dispute abgeschlossen `charge.dispute.closed`	Eine Zahlungsanfechtung (Chargeback) wurde entschieden. „won" = zu deinen Gunsten (Betrag bleibt), „lost" = Betrag und Dispute-Gebühr gehen an den Kunden zurück.
🚨 Betrugswarnung `radar.early_fraud_warning.created`	Die Bank des Karteninhabers meldet eine Zahlung als möglicherweise betrügerisch – oft ein Vorbote eines Chargebacks. Eine frühzeitige Rückerstattung kann einen teuren Dispute verhindern.
🏦 Guthaben aktualisiert `balance.available`	Dein Stripe-Guthaben hat sich geändert. „Verfügbar" steht zur Auszahlung an dein Bankkonto bereit; „Ausstehend" wird von Stripe noch gehalten, bis Zahlungen final abgesichert sind. (Kein Kundenbezug – betrifft dein Konto.)
🏦 Auszahlung gestartet `payout.created`	Stripe hat eine Auszahlung an dein Bankkonto angestoßen. „Ankunft" ist das voraussichtliche Gutschriftsdatum. Betrifft dein eigenes Konto, nicht einen Kunden.
🏦 Auszahlung gutgeschrieben `payout.paid`	Stripe zahlt Guthaben an dein hinterlegtes Bankkonto aus. „Ankunft" ist das voraussichtliche Gutschriftsdatum. Betrifft dein eigenes Konto, nicht einen Kunden.
🏦 Auszahlung abgeglichen `payout.reconciliation_completed`	Stripe hat den Abgleich dieser Auszahlung abgeschlossen – alle enthaltenen Einzelbuchungen sind der Auszahlung zugeordnet. Rein informativ, es ist nichts zu tun.
⚠️ Auszahlung fehlgeschlagen `payout.failed`	Eine Auszahlung an dein Bankkonto ist fehlgeschlagen (z. B. falsche oder gesperrte Bankverbindung). Bitte die Bankdaten im Stripe-Dashboard prüfen, sonst bleibt das Geld im Stripe-Guthaben.
🧾 Kommende Rechnung `invoice.upcoming`	Vorschau auf die nächste Rechnung – sie ist NOCH NICHT berechnet oder abgebucht worden. Stripe schickt diese Vorab-Info typischerweise einige Tage vor der nächsten Abbuchung (praktisch, um Kunden vorzuwarnen oder Beträge zu prüfen).
🧾 Rechnung erstellt `invoice.finalized`	Eine Rechnung wurde finalisiert und ist damit fix – kurz darauf versucht Stripe den Einzug. Meist nur informativ.
💰 Checkout abgeschlossen `checkout.session.completed`	Ein Kunde hat eine Stripe-Checkout-Bezahlseite erfolgreich abgeschlossen (Einmalkauf oder Abo-Start). Bei „subscription" entsteht zusätzlich ein neues Abo.
👤 Neuer Kunde `customer.created`	In deinem Stripe-Konto wurde ein neuer Kunde angelegt. Das heißt noch nicht, dass schon gezahlt wurde – oft der erste Schritt vor einem Kauf oder Abo.
ℹ️ Kunde aktualisiert `customer.updated`	Kundendaten wurden geändert (z. B. E-Mail, Standard-Zahlungsmittel oder Adresse).
ℹ️ Kundenportal geöffnet `billing_portal.session.created`	Ein Kunde hat sein Stripe-Kundenportal geöffnet (z. B. um Zahlungsdaten zu ändern oder zu kündigen). Am Abo selbst hat sich dadurch noch nichts geändert – Routineaktivität, wird bei „Routine-Ereignisse überspringen" unterdrückt.
👤 Kunde gelöscht `customer.deleted`	Ein Kunde wurde in Stripe gelöscht. Eventuell bestehende Abos werden damit ebenfalls beendet.

Weitere Ereignis-Familien

Alle übrigen Stripe-Ereignisse ordnet Churnbell nach ihrer Familie ein: Jeder Untertyp (z. B. person.updated) bekommt einen lesbaren Titel und eine Kurzerklärung – der genaue Typ steht immer in der Benachrichtigung.

Familie	Einordnung
`payment_method.*`	Zahlungsmittel – ein hinterlegtes Zahlungsmittel wurde angelegt, aktualisiert oder entfernt.
`setup_intent.*`	Zahlungsmittel-Einrichtung – ein Zahlungsmittel wurde für spätere Zahlungen eingerichtet.
`refund.*`	Rückerstattung – ein Ereignis zu einer Rückerstattung.
`invoiceitem.*`	Rechnungsposten – ein einzelner Posten einer Rechnung wurde geändert.
`credit_note.*`	Gutschrift – eine Gutschrift zu einer Rechnung wurde erstellt oder geändert.
`customer.tax_id.*`	USt-IdNr. eines Kunden – eine USt-IdNr. wurde hinzugefügt, geprüft oder entfernt.
`customer.discount.*`	Kundenrabatt – ein Rabatt/Gutschein an einem Kunden wurde geändert.
`customer.source.` · `source.`	Zahlungsquelle – eine (ältere) Zahlungsquelle eines Kunden wurde geändert.
`review.*`	Zahlungsprüfung – Stripe Radar hat eine Zahlung zur manuellen Prüfung markiert oder freigegeben.
`price.` · `product.` · `plan.*`	Katalog – ein Preis, Produkt oder Abo-Plan in deinem Katalog wurde geändert.
`coupon.` · `promotion_code.`	Gutschein & Aktionscode – ein Gutschein oder Aktionscode wurde angelegt oder geändert.
`subscription_schedule.*`	Abo-Zeitplan – geplante Abo-Änderungen (Phasen) wurden angelegt oder angepasst.
`quote.*`	Angebot – ein Stripe-Angebot wurde erstellt, angenommen oder geändert.
`tax_rate.*`	Steuersatz – ein Steuersatz wurde angelegt oder geändert.
`account.*`	Stripe-Konto – eine Änderung an deinem Stripe-Konto selbst (z. B. Einstellungen oder Verifizierungsstatus). Kein Kundenbezug.
`person.*`	Person im Stripe-Konto – eine in deinem Konto hinterlegte Person (Inhaber/Vertretungsberechtigte), meist Teil der Identitätsprüfung (KYC). Kein Kundenbezug.
`capability.*`	Konto-Funktion – eine Zahlungsfunktion deines Kontos wurde aktiviert oder deaktiviert (z. B. eine Zahlungsmethode).
`mandate.*`	Zahlungsmandat – z. B. eine SEPA-Lastschrift-Einzugsermächtigung wurde erteilt oder widerrufen.
`topup.*`	Guthaben-Aufladung – eine Aufladung deines Stripe-Guthabens.
`transfer.*`	Transfer (Connect) – ein Transfer an ein verbundenes Konto (Stripe Connect).
`payment_link.*`	Payment Link – ein Payment Link wurde angelegt oder geändert.
`billing_portal.configuration.*`	Kundenportal – die Konfiguration deines Stripe-Kundenportals wurde geändert.
`reporting.*`	Report – ein Report aus deinem Stripe-Konto wurde erstellt oder ist fertig.
`identity.*`	Identitätsprüfung – ein Ereignis zu einer Identitätsprüfung (Stripe Identity).
`file.*`	Datei – in deinem Stripe-Konto wurde eine Datei erstellt (z. B. ein Report oder ein Beleg).

Auch Untertypen der oben einzeln erklärten Bereiche (etwa invoice.marked_uncollectible) werden so eingeordnet – z. B. als „Rechnung", „Kartenzahlung" oder „Abo". Gänzlich unbekannte Typen kommen als „Stripe-Ereignis" mit Verweis aufs Stripe-Dashboard an.

💡 Welche dieser Ereignisse dich erreichen, steuerst du über Regeln & Muster.