# Stripe + Brew

Sincronizza i clienti Stripe nel pubblico del brand, avvia automazioni da 22 eventi Stripe e invia email del ciclo di vita già pronte (benvenuto, fine della prova, recupero dei pagamenti non riusciti, riattivazione).

URL canonico: https://brew.new/it/browse/integrations/stripe

- Direzione: Dati in entrata
- Collegamento: OAuth
- Sincronizzazione clienti + trigger da evento

## Funzionalità disponibili

- **Trigger da evento**: Avvia le automazioni di Brew da 22 eventi Stripe su abbonamenti, fatture, checkout, preventivi, addebiti, rimborsi e intenti di pagamento.
- **Sincronizzazione dei contatti**: Sincronizza i clienti Stripe nel pubblico del brand, con i campi personalizzati `stripe_*` disponibili come attributi filtrabili.
- **Importazione in blocco dei clienti**: Importazione con un clic di tutti i clienti Stripe esistenti nel brand attivo. Riprendibile e durevole grazie a Vercel Workflow.
- **Modelli di email del ciclo di vita**: Modelli di partenza per benvenuto, fine della prova, recupero dei pagamenti non riusciti e riattivazione.

## Trasforma gli eventi di fatturazione in email utili

Collega Stripe tramite OAuth per far partire email in linea con il tuo brand quando inizia un abbonamento, una prova sta per scadere o il pagamento di una fattura non va a buon fine. Brew registra il webhook e rende disponibili gli eventi supportati come trigger delle automazioni.

Stripe resta responsabile di pagamenti, nuovi tentativi, rimborsi e modifiche agli abbonamenti. Brew crea e invia le email.


## Cosa puoi creare

- Promemoria di fine prova: usa l’evento customer.subscription.trial_will_end per spiegare cosa succede dopo e rimandare alla tua pagina dei piani o della fatturazione.
- Avvisi di pagamento non riuscito: usa l’evento invoice.payment_failed per inviare un avviso tempestivo con un link alla tua pagina di fatturazione. Coordinati con le email ai clienti che invia Stripe, così lo stesso avviso non parte due volte.
- Email di benvenuto per gli abbonati: parti dall’evento customer.subscription.created o checkout.session.completed e scegli un solo trigger, per evitare benvenuti doppi.
- Email per il cambio di piano: l’evento customer.subscription.updated può fornire i campi previousPlan e newPlan, quando l’evento li include.
- Conferme di pagamento: l’evento invoice.paid scatta quando una fattura viene pagata. Usa amount, currency e invoiceNumber come merge tag.
- Avvisi di rinnovo: l’evento invoice.upcoming scatta prima che Stripe crei la fattura successiva di un abbonamento e contiene amount e currency. Il suo payload non include la data di rinnovo, quindi inserisci un link alla tua pagina di fatturazione per i dettagli.
- Follow-up dopo la disdetta: l’evento customer.subscription.deleted scatta quando un abbonamento viene disdetto o eliminato. Un nuovo abbonamento non interrompe un’esecuzione già in corso, quindi aggiungi una condizione su contact.stripe_subscription_status prima di ogni email successiva.
- Avvisi di pausa e ripresa: usa gli eventi customer.subscription.paused e customer.subscription.resumed per confermare la modifica all’abbonato.
- Esito dei pagamenti differiti: gli eventi checkout.session.async_payment_succeeded e checkout.session.async_payment_failed indicano come si è concluso, dopo il checkout, un pagamento con un metodo di pagamento differito. paymentStatus e sessionMode sono disponibili come merge tag.
- Promemoria per i checkout abbandonati: Brew non ha un trigger per le sessioni di Checkout scadute. Invia un tuo evento personalizzato quando la tua applicazione rileva che una sessione è scaduta.
- Conferme di rimborso: l’evento refund.created contiene refundAmount, refundCurrency, refundReason e refundStatus del rimborso specifico. L’evento charge.refunded contiene solo i totali a livello di addebito, come amountRefunded.
- Follow-up sui preventivi: gli eventi quote.finalized, quote.accepted e quote.canceled contengono importo, valuta e stato del preventivo. Non esiste un campo con il link al preventivo, quindi indirizza l’acquirente a una tua pagina.
- Pagamenti una tantum non riusciti: l’evento payment_intent.payment_failed contiene failureCode, failureMessage e declineCode, così l’email può indicare perché il pagamento non è andato a buon fine.

## Un follow-up sul pagamento non riuscito che verifica lo stato attuale

Inizia con un’email attivata dall’evento invoice.payment_failed. Per un promemoria successivo, fai programmare alla tua applicazione una nuova verifica dello stato della fattura in Stripe. Invia a Brew un evento personalizzato separato solo se la fattura risulta ancora non pagata e il cliente è ancora idoneo.

Dopo un nodo Attesa, i campi dell’evento contengono ancora il payload originale. Una condizione contact.stripe_subscription_status legge il valore attuale del campo sul contatto di Brew nel momento in cui quel nodo viene eseguito. Non interroga Stripe e non dimostra che una certa fattura sia stata pagata. Gli aggiornamenti del contatto e i nuovi eventi di pagamento non annullano automaticamente un’esecuzione precedente. Anche l’aggiornamento di una carta non è una prova di pagamento.

Testa entrambi i percorsi: un cliente con la fattura ancora non pagata, e ancora idoneo, riceve il promemoria; un cliente che paga prima della verifica programmata no. Testa i nuovi tentativi con il contratto di idempotenza documentato.


## Configura Stripe in Brew

- Apri Integrazioni, scegli Stripe e seleziona Collega. Autorizza l’accesso tramite OAuth di Stripe.
- Brew configura il webhook e 22 tipi di evento supportati. Non esiste un interruttore per attivare o disattivare gli eventi.
- Per importare i clienti esistenti, apri Gestisci e scegli Sincronizza i clienti da Stripe. Un record cliente, da solo, non costituisce un consenso all’email di marketing.
- Crea un’automazione e seleziona il suo evento Stripe. Controlla destinatario, campi del payload, contenuto dell’email e link di fatturazione.
- Brew collega account Stripe in modalità live, e gli eventi in modalità test non sincronizzano i contatti né avviano automazioni. Lascia l’automazione in bozza e testala con destinatari sotto il tuo controllo prima di pubblicarla. Quando arriva un evento corrispondente, vengono eseguite solo le automazioni attive.
- Un agente può creare, testare e pubblicare automazioni tramite il server MCP di Brew o l’API, dopo che una persona autorizzata ha collegato l’account Stripe nell’app.

## Eventi Stripe supportati

Brew supporta questi 22 tipi di evento:

- 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

## Sincronizzazione dei clienti e personalizzazione

Gli eventi su clienti e abbonamenti possono aggiornare i contatti di Brew con informazioni sulla fatturazione. I campi del contatto disponibili includono stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end e stripe_delinquent. La disponibilità dipende dall’evento Stripe e dai dati ricevuti.

Per i merge tag, usa lo schema del payload dichiarato dall’evento selezionato. A seconda dell’evento, i campi includono firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan e failureMessage. Gli importi sono in centesimi dove lo schema indica i centesimi.

Gli identificatori degli oggetti Stripe vengono rimossi dai payload delle automazioni. Non dare per scontato di poter usare gli ID di fatture o abbonamenti come merge tag. Brew non salva sul contatto nemmeno l’ID cliente di Stripe.

L’impostazione Sincronizza il nome completo, per ogni evento, stabilisce se Stripe può aggiornare il nome del contatto. Non attiva né disattiva un trigger.


## Posso fermare un promemoria dopo che il cliente ha pagato?

Un evento di pagamento successivo non annulla automaticamente un’esecuzione avviata da un errore precedente. Programma una verifica lato applicazione prima del promemoria e invia un nuovo evento solo se la fattura risulta ancora non pagata.


## Perché un evento compare senza che venga inviata un’email?

Ricevere un evento e inviare un’email sono passaggi separati. Verifica che un’automazione corrispondente sia attiva, controlla i suoi filtri e la cronologia delle esecuzioni, e verifica l’idoneità del destinatario e il dominio di invio. L’impostazione Sincronizza il nome completo controlla solo gli aggiornamenti del nome.


## Limiti e risoluzione dei problemi

- Brew non può creare addebiti, emettere rimborsi o modificare gli abbonamenti Stripe.
- Se un evento compare nella scheda Eventi di Gestisci ma non arriva nessuna email, controlla che l’automazione associata sia attiva, verificane filtri e cronologia delle esecuzioni, poi controlla il destinatario e che il dominio di invio sia pronto.
- In caso di errori persistenti sulla firma del webhook, ricollega Stripe per generare un nuovo secret del webhook.
- Usa l’evento refund.created quando l’email richiede campi specifici del rimborso; verifica i campi disponibili nello schema del trigger.
- Verifica il consenso e la finalità di ogni email. Importare i contatti della fatturazione non autorizza gli invii promozionali.

## Fonti e guide alla configurazione

- [Crea un flusso di email del ciclo di vita con Stripe](/it/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events)
- [Confronta le integrazioni email per Stripe](/it/blog/best-email-marketing-tools-with-stripe-integration-subscription-events-and-automation-compared)
- [Guida alla configurazione di Stripe](https://docs.brew.new/integrations/import/stripe)
- [Crea un’automazione](https://docs.brew.new/create-emails/build-an-automation)
- [Merge tag](https://docs.brew.new/create-emails/merge-tags)
- [Riferimento degli eventi Stripe](https://docs.stripe.com/api/events/types)
- [Impostazioni delle email ai clienti di Stripe](https://docs.stripe.com/billing/revenue-recovery/customer-emails)

## Correlati

- [Tutte le integrazioni](https://brew.new/it/browse/integrations.md)
- [Registrati](https://brew.new/it/sign-up.md)
- Sito web: https://brew.new