# Stripe + Brew

Synchroniseer Stripe-klanten naar de doelgroep van het merk, start automatiseringen vanuit 22 Stripe-events en verstuur kant-en-klare lifecycle-e-mails (welkom, einde proefperiode, opvolging van mislukte betalingen, terugwinnen).

Canonieke URL: https://brew.new/nl/browse/integrations/stripe

- Richting: Inkomend
- Koppelmethode: OAuth
- Klantsynchronisatie + eventtriggers

## Live mogelijkheden

- **Eventtriggers**: Start automatiseringen in Brew vanuit 22 Stripe-events rond abonnementen, facturen, checkouts, offertes, afschrijvingen, terugbetalingen en payment intents.
- **Contacten synchroniseren**: Synchroniseer Stripe-klanten naar de doelgroep van het merk, met aangepaste velden `stripe_*` als attributen waarop je kunt filteren.
- **Bulkimport van klanten**: Importeer met één klik alle bestaande Stripe-klanten in het actieve merk. Hervatbaar en robuust dankzij Vercel Workflow.
- **Sjablonen voor lifecycle-e-mails**: Startsjablonen voor welkomstmails, het einde van de proefperiode, het opvolgen van mislukte betalingen en het terugwinnen van klanten.

## Maak van factureringsevents nuttige e-mails

Koppel Stripe via OAuth om merkconforme e-mails te versturen wanneer een abonnement begint, een proefperiode bijna afloopt of de betaling van een factuur mislukt. Brew registreert de webhook en maakt de ondersteunde events beschikbaar als triggers voor automatiseringen.

Stripe blijft verantwoordelijk voor betalingen, nieuwe betaalpogingen, terugbetalingen en wijzigingen in abonnementen. Brew maakt en verstuurt de e-mails.


## Wat je kunt bouwen

- Herinneringen aan het einde van de proefperiode: gebruik het event customer.subscription.trial_will_end om uit te leggen wat er daarna gebeurt, en link naar de pagina met je pakketten of je factureringspagina.
- Meldingen over mislukte betalingen: gebruik het event invoice.payment_failed om tijdig een melding te sturen met een link naar je eigen factureringspagina. Stem dit af op de klantmails die Stripe verstuurt, zodat dezelfde melding niet twee keer de deur uitgaat.
- Welkomstmails voor abonnees: start vanuit het event customer.subscription.created of checkout.session.completed, en kies één trigger om dubbele welkomstmails te voorkomen.
- E-mails bij een pakketwijziging: het event customer.subscription.updated kan de velden previousPlan en newPlan leveren als het event die bevat.
- Betalingsbevestigingen: Stripe verstuurt invoice.paid zodra een factuur is betaald. Gebruik amount, currency en invoiceNumber als personalisatietags.
- Aankondigingen van een verlenging: Stripe verstuurt invoice.upcoming voordat de volgende factuur voor een abonnement wordt aangemaakt, met de velden amount en currency. De payload heeft geen verlengingsdatum, dus link voor de details naar je factureringspagina.
- Opvolging na een opzegging: Stripe verstuurt customer.subscription.deleted wanneer een abonnement wordt opgezegd of verwijderd. Een nieuw abonnement stopt een run die al loopt niet, dus voeg vóór elke latere e-mail een voorwaarde op contact.stripe_subscription_status toe.
- Meldingen bij pauzeren en hervatten: met customer.subscription.paused en customer.subscription.resumed bevestig je de wijziging aan de abonnee.
- Resultaten van uitgestelde betalingen: checkout.session.async_payment_succeeded en checkout.session.async_payment_failed melden hoe een betaling met een vertraagde betaalmethode na de checkout is afgehandeld. paymentStatus en sessionMode zijn beschikbaar als personalisatietags.
- Herinneringen bij een verlaten checkout: Brew heeft geen trigger voor verlopen Checkout-sessies. Verstuur je eigen aangepaste event zodra je applicatie ziet dat een sessie is verlopen.
- Bevestigingen van terugbetalingen: refund.created bevat refundAmount, refundCurrency, refundReason en refundStatus voor de specifieke terugbetaling. charge.refunded bevat alleen totalen op het niveau van de afschrijving, zoals amountRefunded.
- Opvolging van offertes: quote.finalized, quote.accepted en quote.canceled bevatten het bedrag, de valuta en de status van de offerte. Er is geen veld met een link naar de offerte, dus verwijs de koper naar je eigen pagina.
- Mislukte eenmalige betalingen: payment_intent.payment_failed bevat failureCode, failureMessage en declineCode, zodat de e-mail kan aangeven waarom de betaling is mislukt.

## Opvolging van mislukte betalingen die de actuele status controleert

Begin met één e-mail die start bij het event invoice.payment_failed. Laat je applicatie voor een latere herinnering een nieuwe controle van de factuurstatus in Stripe inplannen. Verstuur alleen een apart aangepast event naar Brew als de factuur nog onbetaald is en de klant nog in aanmerking komt.

Na een wachtstap bevatten de eventvelden nog steeds de oorspronkelijke payload van het event. Een voorwaarde op contact.stripe_subscription_status leest de actuele waarde van het veld op het contact in Brew op het moment dat die stap wordt uitgevoerd. Ze raadpleegt Stripe niet en bewijst niet dat een bepaalde factuur is betaald. Updates van contacten en nieuwe betaalevents annuleren een eerdere run niet automatisch. Een bijgewerkte kaart is evenmin een bewijs van betaling.

Test beide paden: een klant van wie de factuur nog onbetaald is en die nog in aanmerking komt, krijgt de herinnering; een klant die vóór de ingeplande controle betaalt, krijgt hem niet. Test nieuwe pogingen met het gedocumenteerde idempotentiecontract.


## Stripe instellen in Brew

- Open Integraties, kies Stripe en klik op Koppelen. Geef toegang via Stripe OAuth.
- Brew maakt de webhook en 22 ondersteunde eventtypen aan. Er is geen schakelaar om events in of uit te schakelen.
- Om bestaande klanten te importeren, open je Beheren en kies je Klanten synchroniseren vanuit Stripe. Een klantrecord alleen betekent nog geen toestemming voor marketingmails.
- Maak een automatisering aan en selecteer het bijbehorende Stripe-event. Controleer de ontvanger, de payloadvelden, de inhoud van de e-mail en de factureringslinks.
- Brew koppelt live Stripe-accounts, en events uit de testmodus synchroniseren geen contacten en starten geen automatiseringen. Laat de automatisering op Concept staan en test die vóór het publiceren met ontvangers die je zelf in de hand hebt. Alleen automatiseringen met de status Live worden uitgevoerd wanneer er een overeenkomend event binnenkomt.
- Een agent kan automatiseringen aanmaken, testen en publiceren via de MCP-server of de API van Brew, nadat iemand met de juiste rechten het Stripe-account in de app heeft gekoppeld.

## Ondersteunde Stripe-events

Brew ondersteunt de volgende 22 eventtypen:

- 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

## Klantsynchronisatie en personalisatie

Klant- en abonnementsevents kunnen contacten in Brew bijwerken met factureringscontext. Beschikbare contactvelden zijn onder meer stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end en stripe_delinquent. Welke velden beschikbaar zijn, hangt af van het Stripe-event en de ontvangen gegevens.

Gebruik voor personalisatietags het gedeclareerde payloadschema van het gekozen event. Afhankelijk van het event zijn er onder meer de velden firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan en failureMessage. Geldbedragen staan in centen als het schema centen aangeeft.

ID’s van Stripe-objecten worden uit de payloads van automatiseringen verwijderd. Ga er niet van uit dat je factuur- of abonnements-ID’s als personalisatietags kunt gebruiken. Brew slaat ook de klant-ID van Stripe niet op bij het contact.

De instelling Volledige naam synchroniseren, per event, bepaalt of Stripe de naam van het contact mag bijwerken. Ze schakelt geen trigger in of uit.


## Kan ik een herinnering stoppen als een klant heeft betaald?

Een later betaalevent annuleert niet automatisch een run die door een eerdere mislukte betaling is gestart. Plan vóór de herinnering een controle in je applicatie in, en verstuur alleen een nieuw event zolang de factuur nog onbetaald is.


## Waarom verschijnt er een event zonder dat er een e-mail wordt verstuurd?

Een event ontvangen en een e-mail versturen zijn aparte stappen. Controleer of een overeenkomende automatisering op Live staat, bekijk de filters en de uitvoeringsgeschiedenis, en controleer of de ontvanger in aanmerking komt en of het verzenddomein in orde is. De instelling Volledige naam synchroniseren regelt alleen het bijwerken van namen.


## Limieten en problemen oplossen

- Brew kan geen afschrijvingen aanmaken, geen terugbetalingen doen en geen Stripe-abonnementen wijzigen.
- Verschijnt een event op het tabblad Events onder Beheren, maar komt er geen e-mail aan, controleer dan of de gekoppelde automatisering op Live staat, de filters en de uitvoeringsgeschiedenis, de ontvanger en of het verzenddomein klaar is om te versturen.
- Blijven er fouten met de webhookhandtekening optreden, koppel Stripe dan opnieuw om een nieuw webhookgeheim aan te maken.
- Gebruik het event refund.created als de e-mail velden nodig heeft die specifiek over de terugbetaling gaan; controleer de beschikbare velden in het triggerschema.
- Controleer de toestemming en het doel van elke e-mail. Factureringscontacten importeren geeft je nog geen toestemming voor promotionele verzendingen.

## Bronnen en handleidingen

- [Een workflow voor lifecycle-e-mails met Stripe bouwen](/nl/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events)
- [E-mailintegraties met Stripe vergelijken](/nl/blog/best-email-marketing-tools-with-stripe-integration-subscription-events-and-automation-compared)
- [Handleiding voor Stripe](https://docs.brew.new/integrations/import/stripe)
- [Een automatisering bouwen](https://docs.brew.new/create-emails/build-an-automation)
- [Personalisatietags](https://docs.brew.new/create-emails/merge-tags)
- [Overzicht van Stripe-events](https://docs.stripe.com/api/events/types)
- [Instellingen voor klantmails in Stripe](https://docs.stripe.com/billing/revenue-recovery/customer-emails)

## Gerelateerd

- [Alle integraties](https://brew.new/nl/browse/integrations.md)
- [Account aanmaken](https://brew.new/nl/sign-up.md)
- Website: https://brew.new