# Stripe + Brew

Synchronisez vos clients Stripe dans l’audience de la marque, déclenchez des automatisations à partir de 22 événements Stripe et lancez des e-mails de cycle de vie prêts à l’emploi (bienvenue, fin d’essai, relance des paiements échoués, reconquête).

URL canonique : https://brew.new/fr/browse/integrations/stripe

- Sens des données : Données entrantes
- Connexion : OAuth
- Synchronisation des clients et déclencheurs

## Fonctionnalités disponibles

- **Déclencheurs par événement** : Déclenchez des automatisations Brew à partir de 22 événements Stripe : abonnements, factures, sessions Checkout, devis, charges, remboursements et intentions de paiement.
- **Synchronisation des contacts** : Synchronisez vos clients Stripe dans l’audience de la marque, avec des champs personnalisés `stripe_*` utilisables comme attributs filtrables.
- **Import groupé de clients** : Import en un clic de tous vos clients Stripe existants dans la marque active. Reprise possible et exécution durable via Vercel Workflow.
- **Modèles d’e-mails de cycle de vie** : Modèles de départ pour la bienvenue, la fin d’essai, la relance des paiements échoués et la reconquête.

## Transformez vos événements de facturation en e-mails utiles

Connectez Stripe via OAuth pour lancer des e-mails à l’image de votre marque quand un abonnement démarre, qu’un essai touche à sa fin ou que le paiement d’une facture échoue. Brew configure le webhook et rend les événements pris en charge disponibles comme déclencheurs d’automatisation.

Stripe reste responsable des paiements, des nouvelles tentatives de paiement, des remboursements et des changements d’abonnement. Brew crée et envoie les e-mails.


## Ce que vous pouvez créer

- Rappels de fin d’essai : utilisez l’événement customer.subscription.trial_will_end pour expliquer la suite et renvoyer vers votre page d’offres ou de facturation.
- Avis de paiement échoué : utilisez l’événement invoice.payment_failed pour envoyer rapidement un avis avec un lien vers votre propre page de facturation. Coordonnez-le avec les e-mails clients envoyés par Stripe, pour que le même avis ne parte pas deux fois.
- E-mails de bienvenue pour les abonnés : partez de l’événement customer.subscription.created ou checkout.session.completed, en choisissant un seul déclencheur pour éviter les e-mails de bienvenue en double.
- E-mails de changement d’offre : l’événement customer.subscription.updated peut fournir les champs previousPlan et newPlan lorsqu’il les contient.
- Confirmations de paiement : l’événement invoice.paid est envoyé quand une facture est payée. Utilisez amount, currency et invoiceNumber comme balises de fusion.
- Rappels avant renouvellement : l’événement invoice.upcoming est envoyé avant que Stripe ne crée la prochaine facture d’un abonnement, et il contient amount et currency. Son payload ne comporte pas de date de renouvellement : renvoyez vers votre page de facturation pour les détails.
- Relances après résiliation : l’événement customer.subscription.deleted est envoyé quand un abonnement est résilié ou supprimé. Un nouvel abonnement n’arrête pas une exécution déjà en cours : ajoutez donc une condition sur contact.stripe_subscription_status avant chaque e-mail suivant.
- Avis de mise en pause et de reprise : avec les événements customer.subscription.paused et customer.subscription.resumed, confirmez le changement à l’abonné.
- Résultats des paiements différés : les événements checkout.session.async_payment_succeeded et checkout.session.async_payment_failed indiquent l’issue d’un moyen de paiement différé une fois la session Checkout terminée. paymentStatus et sessionMode sont disponibles comme balises de fusion.
- Relances après un paiement abandonné : Brew n’a pas de déclencheur pour les sessions Checkout expirées. Déclenchez votre propre événement personnalisé quand votre application constate l’expiration d’une session.
- Confirmations de remboursement : l’événement refund.created contient refundAmount, refundCurrency, refundReason et refundStatus pour le remboursement concerné. L’événement charge.refunded ne contient que des totaux au niveau de la charge, comme amountRefunded.
- Relances de devis : les événements quote.finalized, quote.accepted et quote.canceled contiennent le montant, la devise et le statut du devis. Il n’existe pas de champ pour le lien du devis : renvoyez l’acheteur vers votre propre page.
- Échecs de paiements ponctuels : l’événement payment_intent.payment_failed contient failureCode, failureMessage et declineCode, pour que l’e-mail puisse expliquer pourquoi le paiement a échoué.

## Une relance de paiement échoué qui vérifie l’état actuel

Commencez par un e-mail déclenché par l’événement invoice.payment_failed. Pour un rappel ultérieur, faites programmer par votre application une nouvelle vérification du statut de la facture dans Stripe. Ne déclenchez un événement personnalisé Brew distinct que si la facture reste impayée et que le client est toujours éligible.

Après une étape d’attente, les champs de l’événement contiennent toujours le payload d’origine. Une condition contact.stripe_subscription_status lit la valeur actuelle du champ sur le contact Brew au moment où ce nœud s’exécute. Elle n’interroge pas Stripe et ne prouve pas qu’une facture donnée a été payée. Les mises à jour du contact et les nouveaux événements de paiement n’annulent pas automatiquement une exécution antérieure. La mise à jour d’une carte ne prouve pas non plus le paiement.

Testez les deux chemins : un client dont la facture est toujours impayée, et qui reste éligible, reçoit le rappel ; un client qui paie avant la vérification programmée ne le reçoit pas. Testez les nouvelles tentatives en vous appuyant sur le contrat d’idempotence documenté.


## Configurer Stripe dans Brew

- Ouvrez Intégrations, choisissez Stripe, puis cliquez sur « Connecter ». Autorisez l’accès via l’OAuth de Stripe.
- Brew configure le webhook et 22 types d’événements pris en charge. Il n’existe pas d’interrupteur pour activer ou désactiver un événement.
- Pour importer vos clients existants, ouvrez Gérer et choisissez « Synchroniser les clients Stripe ». Une fiche client ne vaut pas, à elle seule, consentement aux e-mails marketing.
- Créez une automatisation et sélectionnez son événement Stripe. Vérifiez le destinataire, les champs du payload, le contenu de l’e-mail et les liens de facturation.
- Brew connecte des comptes Stripe en production : les événements du mode test de Stripe ne synchronisent aucun contact et ne lancent aucune automatisation. Laissez l’automatisation en brouillon et testez-la avec des destinataires maîtrisés avant de la publier. Seules les automatisations actives s’exécutent quand un événement correspondant arrive.
- Un agent peut créer, tester et publier des automatisations via le serveur MCP de Brew ou l’API, une fois qu’une personne autorisée a connecté le compte Stripe dans l’app.

## Événements Stripe pris en charge

Brew prend en charge les 22 types d’événements suivants :

- 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

## Synchronisation des clients et personnalisation

Les événements client et abonnement peuvent mettre à jour les contacts Brew avec des informations de facturation. Les champs de contact disponibles incluent stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end et stripe_delinquent. Leur disponibilité dépend de l’événement Stripe et des données reçues.

Pour les balises de fusion, utilisez le schéma de payload déclaré par l’événement sélectionné. Selon l’événement, les champs incluent firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan et failureMessage. Les montants sont exprimés en centimes lorsque le schéma l’indique.

Les identifiants des objets Stripe sont retirés des payloads d’automatisation. Ne partez pas du principe que les ID de facture ou d’abonnement peuvent servir de balises de fusion. Brew ne stocke pas non plus l’ID client Stripe sur le contact.

Le paramètre « Synchroniser le nom complet », propre à chaque événement, détermine si Stripe peut mettre à jour le nom du contact. Il n’active ni ne désactive aucun déclencheur.


## Puis-je arrêter un rappel une fois que le client a payé ?

Un événement de paiement ultérieur n’annule pas automatiquement une exécution lancée par un échec antérieur. Programmez une vérification côté application avant le rappel, et ne déclenchez un nouvel événement que si la facture est toujours impayée.


## Pourquoi un événement apparaît-il sans qu’aucun e-mail ne soit envoyé ?

Recevoir un événement et envoyer un e-mail sont deux étapes distinctes. Vérifiez qu’une automatisation correspondante est active, examinez ses filtres et son historique d’exécution, puis contrôlez l’éligibilité du destinataire et le domaine d’envoi. Le paramètre « Synchroniser le nom complet » ne contrôle que la mise à jour des noms.


## Limites et dépannage

- Brew ne peut ni créer de charges, ni émettre de remboursements, ni modifier les abonnements Stripe.
- Si un événement apparaît dans Gérer › Événements mais qu’aucun e-mail n’arrive, vérifiez que l’automatisation associée est active, ainsi que ses filtres, son historique d’exécution et le destinataire, et que le domaine d’envoi est prêt.
- En cas d’erreurs de signature de webhook persistantes, reconnectez Stripe pour générer un nouveau secret de webhook.
- Utilisez l’événement refund.created quand l’e-mail a besoin de champs propres aux remboursements ; vérifiez les champs disponibles dans le schéma du déclencheur.
- Vérifiez le consentement et la finalité de chaque e-mail. Importer des contacts de facturation n’autorise pas les envois promotionnels.

## Sources et guides de configuration

- [Créer un workflow d’e-mails de cycle de vie avec Stripe](/fr/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events)
- [Comparer les intégrations e-mail pour Stripe](/fr/blog/best-email-marketing-tools-with-stripe-integration-subscription-events-and-automation-compared)
- [Guide de configuration de Stripe](https://docs.brew.new/integrations/import/stripe)
- [Créer une automatisation](https://docs.brew.new/create-emails/build-an-automation)
- [Balises de fusion](https://docs.brew.new/create-emails/merge-tags)
- [Référence des événements Stripe](https://docs.stripe.com/api/events/types)
- [Paramètres des e-mails clients de Stripe](https://docs.stripe.com/billing/revenue-recovery/customer-emails)

## Voir aussi

- [Toutes les intégrations](https://brew.new/fr/browse/integrations.md)
- [Inscription](https://brew.new/fr/sign-up.md)
- Site web : https://brew.new