# Stripe + Brew

Synchronisiere Stripe-Kunden in die Zielgruppe der Marke, löse Automatisierungen über 22 Stripe-Events aus und verschicke vorgefertigte Lifecycle-E-Mails (Begrüßung, Ende der Testphase, Rettung fehlgeschlagener Zahlungen, Rückgewinnung).

Kanonische URL: https://brew.new/de/browse/integrations/stripe

- Datenrichtung: Eingehende Daten
- Verbindung: OAuth
- Kundensynchronisierung + Event-Trigger

## Verfügbare Funktionen

- **Event-Trigger**: Löse Brew-Automatisierungen über 22 Stripe-Events aus – zu Abos, Rechnungen, Checkouts, Angeboten, Belastungen, Rückerstattungen und Payment Intents.
- **Kontakte synchronisieren**: Synchronisiere Stripe-Kunden in die Zielgruppe der Marke, mit den benutzerdefinierten Feldern `stripe_*` als filterbaren Attributen.
- **Massenimport von Kunden**: Alle Stripe-Kunden mit einem Klick nachträglich in die aktive Marke übernehmen. Fortsetzbar und ausfallsicher dank Vercel Workflow.
- **Vorlagen für Lifecycle-E-Mails**: Startvorlagen für Begrüßung, Ende der Testphase, Rettung fehlgeschlagener Zahlungen und Rückgewinnung.

## Mach aus Abrechnungs-Events nützliche E-Mails

Verbinde Stripe per OAuth, um markenkonforme E-Mails auszulösen, wenn ein Abo beginnt, eine Testphase sich dem Ende nähert oder die Zahlung einer Rechnung fehlschlägt. Brew registriert den Webhook und stellt die unterstützten Events als Trigger für Automatisierungen bereit.

Für Zahlungen, erneute Zahlungsversuche, Rückerstattungen und Abo-Änderungen bleibt Stripe zuständig. Brew erstellt und versendet die E-Mails.


## Was du damit bauen kannst

- Erinnerungen zur Testphase: Nutze das Event customer.subscription.trial_will_end, um zu erklären, wie es weitergeht, und auf deine Plan- oder Abrechnungsseite zu verlinken.
- Hinweise auf fehlgeschlagene Zahlungen: Nutze das Event invoice.payment_failed, um zeitnah einen Hinweis mit Link zu deiner eigenen Abrechnungsseite zu senden. Stimm das mit den Kunden-E-Mails ab, die Stripe selbst verschickt, damit derselbe Hinweis nicht doppelt rausgeht.
- Willkommens-E-Mails für Abonnenten: Starte mit dem Event customer.subscription.created oder checkout.session.completed und wähle nur einen Trigger, damit niemand doppelt begrüßt wird.
- E-Mails bei Planwechseln: Das Event customer.subscription.updated kann die Felder previousPlan und newPlan liefern, wenn das Event sie enthält.
- Zahlungsbestätigungen: Das Event invoice.paid wird ausgelöst, wenn eine Rechnung bezahlt wurde. Nutze amount, currency und invoiceNumber als Merge-Tags.
- Hinweise vor der Verlängerung: Das Event invoice.upcoming wird ausgelöst, bevor Stripe die nächste Rechnung für ein Abo erstellt, und enthält amount und currency. Ein Verlängerungsdatum steht nicht in seiner Payload, verlinke für die Details also auf deine Abrechnungsseite.
- Follow-ups nach einer Kündigung: Das Event customer.subscription.deleted wird ausgelöst, wenn ein Abo gekündigt oder gelöscht wird. Ein neues Abo stoppt keine bereits laufende Ausführung, füge also vor jeder späteren E-Mail eine Bedingung mit contact.stripe_subscription_status hinzu.
- Hinweise zu Pausierung und Fortsetzung: Mit den Events customer.subscription.paused und customer.subscription.resumed bestätigst du Abonnenten die Änderung.
- Ergebnisse verzögerter Zahlungen: Die Events checkout.session.async_payment_succeeded und checkout.session.async_payment_failed melden, wie eine Zahlung mit verzögerter Zahlungsmethode nach dem Checkout ausgegangen ist. Als Merge-Tags stehen paymentStatus und sessionMode zur Verfügung.
- Erinnerungen bei abgebrochenem Checkout: Brew hat keinen Trigger für abgelaufene Checkout-Sitzungen. Löse ein eigenes Event aus, wenn deine Anwendung feststellt, dass eine Sitzung abgelaufen ist.
- Bestätigungen von Rückerstattungen: Das Event refund.created enthält refundAmount, refundCurrency, refundReason und refundStatus für die jeweilige Rückerstattung. Das Event charge.refunded enthält nur Summen auf Ebene der Belastung, etwa amountRefunded.
- Follow-ups zu Angeboten: Die Events quote.finalized, quote.accepted und quote.canceled enthalten Betrag, Währung und Status des Angebots. Ein Feld mit einem Link zum Angebot gibt es nicht, verweise den Käufer also auf deine eigene Seite.
- Fehlgeschlagene Einmalzahlungen: Das Event payment_intent.payment_failed enthält failureCode, failureMessage und declineCode, sodass die E-Mail aufgreifen kann, warum die Zahlung fehlgeschlagen ist.

## Ein Follow-up zu fehlgeschlagenen Zahlungen, das den aktuellen Stand prüft

Starte mit einer E-Mail, die durch das Event invoice.payment_failed ausgelöst wird. Für eine spätere Erinnerung lässt du deine Anwendung eine neue Prüfung des Rechnungsstatus in Stripe planen. Löse ein separates eigenes Event in Brew nur aus, wenn die Rechnung weiterhin unbezahlt ist und der Kunde die Bedingungen noch erfüllt.

Nach einem Schritt „Warten“ enthalten die Event-Felder weiterhin die ursprüngliche Payload des Events. Eine Bedingung mit contact.stripe_subscription_status liest den aktuellen Wert des Felds im Brew-Kontakt, sobald dieser Knoten ausgeführt wird. Sie fragt Stripe nicht ab und beweist nicht, dass eine bestimmte Rechnung bezahlt wurde. Kontaktaktualisierungen und neue Zahlungs-Events brechen eine frühere Ausführung nicht automatisch ab. Auch eine aktualisierte Karte ist kein Zahlungsnachweis.

Teste beide Pfade: Ein Kunde, dessen Rechnung noch unbezahlt ist und der die Bedingungen noch erfüllt, bekommt die Erinnerung; ein Kunde, der vor der geplanten Prüfung zahlt, bekommt sie nicht. Teste Wiederholungen anhand des dokumentierten Idempotenzverhaltens.


## Stripe in Brew einrichten

- Öffne „Integrationen“, wähle Stripe und klicke auf „Verbinden“. Autorisiere den Zugriff per OAuth bei Stripe.
- Brew stellt den Webhook und 22 unterstützte Event-Typen bereit. Einen Schalter zum Aktivieren oder Deaktivieren einzelner Events gibt es nicht.
- Um bestehende Kunden zu importieren, öffne „Verwalten“ und wähle „Kunden aus Stripe synchronisieren“. Ein Kundendatensatz allein begründet keine Einwilligung in Marketing-E-Mails.
- Erstelle eine Automatisierung und wähle ihr Stripe-Event. Prüfe Empfänger, Payload-Felder, E-Mail-Inhalt und Abrechnungslinks.
- Brew verbindet Live-Konten von Stripe, und Events aus dem Testmodus synchronisieren keine Kontakte und starten keine Automatisierungen. Lass die Automatisierung im Status „Entwurf“ und teste sie vor dem Veröffentlichen mit Empfängern, die du kontrollierst. Nur Automatisierungen mit dem Status „Live“ werden ausgeführt, wenn ein passendes Event eintrifft.
- Ein Agent kann Automatisierungen über den Brew-MCP-Server oder die API erstellen, testen und veröffentlichen, nachdem eine berechtigte Person das Stripe-Konto in der App verbunden hat.

## Unterstützte Stripe-Events

Brew unterstützt diese 22 Event-Typen:

- checkout.session.async_payment_succeeded
- checkout.session.async_payment_failed
- checkout.session.completed
- customer.created
- customer.updated
- customer.deleted
- customer.subscription.created
- customer.subscription.updated
- customer.subscription.paused
- customer.subscription.resumed
- customer.subscription.trial_will_end
- customer.subscription.deleted
- invoice.created
- invoice.paid
- invoice.payment_failed
- invoice.upcoming
- quote.finalized
- quote.accepted
- quote.canceled
- charge.refunded
- refund.created
- payment_intent.payment_failed

## Kundensynchronisierung und Personalisierung

Kunden- und Abo-Events können Brew-Kontakte mit Abrechnungskontext aktualisieren. Zu den verfügbaren Kontaktfeldern gehören stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end und stripe_delinquent. Welche davon verfügbar sind, hängt vom Stripe-Event und den empfangenen Daten ab.

Richte dich bei Merge-Tags nach dem deklarierten Payload-Schema des gewählten Events. Je nach Event gehören dazu die Felder firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan und failureMessage. Geldbeträge stehen in Cent, wo das Schema Cent angibt.

IDs von Stripe-Objekten werden aus den Payloads von Automatisierungen entfernt. Geh nicht davon aus, dass sich Rechnungs- oder Abo-IDs als Merge-Tags nutzen lassen. Auch die Stripe-Kunden-ID speichert Brew nicht am Kontakt.

Die Einstellung „Vollständigen Namen synchronisieren“, die es pro Event gibt, steuert, ob Stripe den Namen des Kontakts aktualisieren darf. Sie aktiviert oder deaktiviert keinen Trigger.


## Kann ich eine Erinnerung stoppen, wenn der Kunde bezahlt hat?

Ein späteres Zahlungs-Event bricht eine Ausführung, die durch einen früheren Fehlschlag gestartet wurde, nicht automatisch ab. Plane in deiner Anwendung vor der Erinnerung eine Prüfung ein und löse nur dann ein neues Event aus, wenn die Rechnung noch unbezahlt ist.


## Warum erscheint ein Event, ohne dass eine E-Mail versendet wird?

Ein Event zu empfangen und eine E-Mail zu senden, sind getrennte Schritte. Prüfe, ob eine passende Automatisierung live ist, sieh dir ihre Filter und ihren Ausführungsverlauf an und prüfe, ob der Empfänger erreichbar und die Versanddomain bereit ist. Die Einstellung „Vollständigen Namen synchronisieren“ steuert nur Namensaktualisierungen.


## Limits und Fehlerbehebung

- Brew kann keine Belastungen erstellen, keine Rückerstattungen auslösen und keine Stripe-Abos ändern.
- Wenn ein Event unter „Verwalten“ im Tab „Events“ erscheint, aber keine E-Mail ankommt, prüfe, ob die verknüpfte Automatisierung live ist, sieh dir ihre Filter und ihren Ausführungsverlauf an und prüfe den Empfänger sowie, ob die Versanddomain bereit ist.
- Bei anhaltenden Signaturfehlern im Webhook verbinde Stripe neu, damit ein neues Webhook-Secret bereitgestellt wird.
- Nutze das Event refund.created, wenn die E-Mail Felder zur Rückerstattung braucht; prüfe die verfügbaren Felder im Schema des Triggers.
- Prüfe die Einwilligung und den Zweck jeder E-Mail. Der Import von Abrechnungskontakten erlaubt keine Werbeversände.

## Quellen und Einrichtungsanleitungen

- [Lifecycle-E-Mail-Workflow mit Stripe aufbauen](/de/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events)
- [E-Mail-Integrationen für Stripe vergleichen](/de/blog/best-email-marketing-tools-with-stripe-integration-subscription-events-and-automation-compared)
- [Einrichtungsanleitung für Stripe](https://docs.brew.new/integrations/import/stripe)
- [Automatisierung erstellen](https://docs.brew.new/create-emails/build-an-automation)
- [Merge-Tags](https://docs.brew.new/create-emails/merge-tags)
- [Referenz der Stripe-Events](https://docs.stripe.com/api/events/types)
- [Stripe-Einstellungen für Kunden-E-Mails](https://docs.stripe.com/billing/revenue-recovery/customer-emails)

## Verwandte Seiten

- [Alle Integrationen](https://brew.new/de/browse/integrations.md)
- [Registrieren](https://brew.new/de/sign-up.md)
- Website: https://brew.new