Verbinde Stripe mit Brew, wähle die passenden Abrechnungs-Events und prüfe den aktuellen Rechnungs- oder Abo-Status, bevor spätere Erinnerungen rausgehen.
Stripe sendet Events, wenn sich Abos, Rechnungen und Zahlungen ändern. Diese Events können nützliche E-Mails starten, aber jede Nachricht braucht trotzdem einen festgelegten Empfänger, einen Zweck und eine Regel, nach der entschieden wird, ob sie noch aktuell ist.
Die Stripe-Integration von Brew übernimmt die OAuth-Verbindung und die Einrichtung des Webhooks. Dieser Leitfaden zeigt, wie du das E-Mail-Programm gestaltest, das darauf aufbaut. Für Flows, die mit Produkt-Events statt mit der Abrechnung starten, lies KI-E-Mail-Automatisierung.
| Ziel | Infrage kommendes Event | Vor dem Versand prüfen |
|---|---|---|
| Abonnenten begrüßen | customer.subscription.created |
Doppelte Begrüßung durch den Checkout vermeiden |
| Ende der Testphase erklären | customer.subscription.trial_will_end |
Tatsächliche Frist und ob eine Belastung erfolgt |
| Fehlgeschlagene Rechnungszahlung melden | invoice.payment_failed |
Aktuelle Rechnung, Abrechnungslink, bestehende Hinweise von Stripe |
| Planwechsel erklären | customer.subscription.updated |
Welche Felder sich geändert haben und ob die Änderung relevant ist |
| Kündigung bestätigen | customer.subscription.deleted |
Wann der Zugang endet und was der Kunde beantragt hat |
| Rückerstattung erklären | refund.created |
Felder zur Rückerstattung, die das Event mitliefert |
Nutze die Referenz der Stripe-Events und das Schema des gewählten Brew-Triggers. Ein Abo-Update kann für verschiedene Arten von Änderungen stehen. Versende also nicht bei jedem Update eine E-Mail zum Planwechsel, ohne die Daten zu prüfen.
Autorisiere Stripe in Brew auf der Seite „Integrationen“. Brew registriert den Webhook und stellt die unterstützten Trigger bereit. Einen Schalter zum Aktivieren oder Deaktivieren einzelner Events gibt es nicht. Es laufen nur Automatisierungen mit dem Status „Live“, die mit dem Event verknüpft sind.
Nutze „Kunden aus Stripe synchronisieren“, wenn du bestehende Kontakte importieren musst. Der Import eines Abrechnungskontakts begründet keine Einwilligung in Marketing-E-Mails. Die Einstellung „Vollständigen Namen synchronisieren“, die es pro Event gibt, steuert Namensaktualisierungen, nicht, ob E-Mails ausgelöst werden.
Bau die erste Automatisierung als Entwurf, prüf die generierte E-Mail und teste mit kontrollierten Empfängern, bevor du veröffentlichst. Details zur Verbindung findest du in der Einrichtungsanleitung für Stripe; Brew verbindet Live-Konten von Stripe, und Events aus dem Testmodus starten keine Automatisierungen.
Ein sofortiger Hinweis auf den Fehlschlag kann mit invoice.payment_failed starten. Erkläre, was passiert ist, und verlinke auf deine eigene Abrechnungsseite. Versprich nicht, dass Brew die Zahlung erneut einzieht; für Zahlungsvorgänge ist Stripe zuständig.
Für eine Erinnerung drei Tage später lässt du deine Anwendung eine Prüfung des Rechnungsstatus planen. Ist die Rechnung weiterhin unbezahlt und erfüllt der Kunde die Bedingungen noch, löst du ein separates Erinnerungs-Event in Brew aus. Ist die Zahlung inzwischen doch eingegangen, beendest du den Vorgang, ohne das Event auszulösen.
Nach einem Schritt „Warten“ enthalten die Event-Felder weiterhin die ursprüngliche Payload. Eine Bedingung mit contact.stripe_subscription_status liest den aktuellen Wert des Kontaktfelds in Brew, sobald dieser Knoten ausgeführt wird. Sie fragt Stripe nicht ab und beweist nicht, dass genau diese Rechnung bezahlt wurde. Ein späteres Event invoice.paid bricht die ältere Ausführung nicht automatisch ab. Auch eine aktualisierte Zahlungsmethode ist kein Zahlungsnachweis.
Teste drei Fälle: eine Zahlung, die vor der Prüfung für die Erinnerung eingeht, eine Rechnung, die unbezahlt bleibt, und einen wiederholten Job. Verwende für dasselbe logische Event innerhalb des dokumentierten Zeitfensters für Wiederholungen denselben Idempotency-Key.
Brew kann Abrechnungsfelder mit Kontakten synchronisieren, darunter Abo-Status und Plan. Event-Payloads und Kontaktfelder sind unterschiedliche Quellen. Lies das Schema des Triggers, bevor du amount, currency, invoiceNumber, previousPlan, newPlan oder failureMessage verwendest; nicht jedes Event liefert jedes Feld.
IDs von Stripe-Objekten fehlen in der Payload der Automatisierung. Bau keine URL zum Kundenportal aus einer vermuteten Rechnungs- oder Abo-ID. Nutze die authentifizierte Abrechnungsseite deiner Anwendung oder einen Link, den du gezielt in einem eigenen Event mitgibst. Halte dich an den Leitfaden zu Merge-Tags.
Prüf die Einstellungen von Stripe für Kunden-E-Mails. Leg fest, welches System Belege, Hinweise zu fehlgeschlagenen Zahlungen und Erinnerungen versendet. Wenn du eine Automatisierung in Brew aktivierst, schaltet das die E-Mails von Stripe nicht ab.
Halte Werbeinhalte aus Kontohinweisen heraus, solange du den Zweck der Nachricht und die vorliegenden Einwilligungen nicht geprüft hast. Marketing-Erinnerungen setzen die entsprechende Einwilligung und eine funktionierende Abmeldung voraus.
Prüf, ob das Event in Brew erscheint, ob die verknüpfte Automatisierung live ist und ob ihr Ausführungsverlauf den erwarteten Empfänger und das erwartete Ergebnis zeigt. Sieh dir danach die empfangene E-Mail und den Abrechnungslink an. Ist ein Event angekommen, aber keine Nachricht rausgegangen, prüf Filter, Sperrlisten und ob die Versanddomain bereit ist, bevor du von einem fehlgeschlagenen Webhook ausgehst.
Starte mit einem Event und einer getesteten E-Mail. Ergänze spätere Erinnerungen erst, wenn die Prüfungen des aktuellen Stands und das Verhalten bei Wiederholungen durch die Tests deiner Anwendung abgedeckt sind.
