---
title: "Primi passi con Stripe"
description: "Scopri come integrare Stripe con Klaviyo per personalizzare e targetizzare le e-mail in base ai dati delle fatture e dei pagamenti dei tuoi clienti."
canonical_url: "https://help.klaviyo.com/hc/it-it/articles/115005082267"
markdown_url: "https://help.klaviyo.com/hc/it-it/articles/115005082267.md"
locale: "it-it"
category: "Integrazioni"
section: "Stripe"
updated: "2025-07-30"
---

# Primi passi con Stripe

## Cosa imparerai

Scopri come integrare Stripe con Klaviyo per personalizzare e targetizzare le e-mail in base ai dati delle fatture e dei pagamenti dei tuoi clienti.

Configurerai l’integrazione Stripe in 2 passaggi. Per prima cosa, collega il tuo account Stripe a Klaviyo. Poi configura i webhook in Stripe e completa la configurazione in Klaviyo per sincronizzare in tempo reale i dati di fatturazione e pagamento.

Ecco una panoramica dei dati che sincronizziamo da Stripe:

- Quando viene emessa una fattura e gli articoli inclusi in ogni fattura

- Informazioni di pagamento quando un utente non riesce a pagare, riceve un rimborso o paga correttamente



## Collega il tuo account Stripe

Prima di iniziare, assicurati di avere un account Stripe attivo e l'autorizzazione a gestire le integrazioni in Klaviyo.

1. In Klaviyo, seleziona la scheda **Integrazioni**.

2. Seleziona **Scopri le app**, cerca *Stripe*, quindi clicca sulla scheda. 

3. Dopodiché, clicca su **Installa**.

4. Clicca su **Connetti a Stripe**. Così accederai al sito di Stripe: accedi se necessario.

5. Seleziona l'account Stripe che desideri connettere a Klaviyo e fai clic su **Connetti**. 




![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/360b7871d37616dd6683a42757b57f7f1095982b-990x578.png?auto=format)

6. Copia l’ **URL del webhook** in **Configurazione webhook**. Mantieni questa pagina aperta mentre crei il webhook in Stripe.



![The stripe integration configuration page.](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/beee0bdb5dcb50ad61063a7c75f941402bc4251c-1200x684.jpg?auto=format)

## Configura i webhook Stripe

Ora configureremo i webhook di Stripe, che ti consentiranno di sincronizzare i dati di Stripe in tempo reale.

1. Apri Stripe in una nuova scheda. Usa le [istruzioni di Stripe](https://docs.stripe.com/webhooks) per creare un webhook endpoint con le impostazioni di seguito.

2. Seleziona **Il tuo account** e scegli il formato del payload **Snapshot**.



![Webhooks tab in Stripe showing endpoints section with add endpoint button](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/d455aebdfd13ee1d7e32ae029ef01bc4cb3e1cb3-1898x526.jpg?auto=format)

3. Usa le seguenti impostazioni per l'endpoint:

   - **URL dell'endpoint**
Incolla l'URL che hai appena copiato da Klaviyo.

   - **Versione dell’API**
Seleziona la versione più recente dell’API.

   - **Eventi**
Seleziona tutti gli eventi *charge* e *invoice* per questo endpoint. Facoltativamente, puoi omettere tutti gli eventi *charge.dispute*. Includi i seguenti eventi:

     - addebito acquisito

     - charge.expired

     - charge.failed

     - charge.pending

     - charge.refunded

     - charge.succeeded

     - charge.updated

     - invoice.created

     - invoice.deleted

     - invoice.finalized

     - invoice.marked_uncollectible

     - invoice.payment_action_required

     - invoice.payment_failed

     - invoice.payment_succeeded

     - invoice.sent

     - invoice.upcoming

     - invoice.updated

     - invoice.voided

4. Completa la creazione e l’abilitazione dell’endpoint in Stripe.



![Add a webhook endpoint with full list of events and Add endpoint with purple background](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/0fd24b5432787be47e7aa94d4fff1040125c5da1-597x617.jpg?auto=format)

5. Conferma che l'endpoint sia abilitato in Stripe.



![Stripe webhook page with status Enabled highlighted in green](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/861899cdc863ad9dc59fb35f27faf02aefabdb19-1106x795.jpg?auto=format)

6. Per verificare i webhook Stripe (consigliato), copia il segreto di firma per l’endpoint che hai appena creato in Stripe. Torna in Klaviyo e incollalo in **Segreto di firma** in **Verifica webhook Stripe (consigliato)**. Questo aggiunge un ulteriore livello di sicurezza alla tua integrazione.

7. Clicca su **Completa la configurazione**.



La tua integrazione Stripe è ora attiva e lo storico dei dati inizierà a sincronizzarsi.

## Visualizza i dati sincronizzati da Stripe

Klaviyo importa fino a 5 anni di cronologia di fatture e pagamenti. Per verificarne lo stato, apri **Stripe** da **integrazioni** e seleziona **Dati**. Attendi il completamento della sincronizzazione storica prima di confrontare i totali.

Per controllare la tua integrazione attivata:

1. Clicca sul menu a tendina **Analisi** in Klaviyo e seleziona **Metrica**.

2. Trova e seleziona la metrica **Successfully Paid** di Stripe, quindi seleziona **Feed delle attività**.



![Activity feed for Stripe Successfully Paid metric in Klaviyo](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/1db3809e31442097ea934f3b1f417ca5977db69c-2402x952.jpg?auto=format)

3. Verifica che gli eventi di pagamento riusciti vengano visualizzati nel feed. Solo i pagamenti con un indirizzo e-mail valido si sincronizzano con Klaviyo.

4. Ad esempio, fai clic sull’intestazione **Grafico** per la metrica *Pagati correttamente*. Questo grafico mostra per impostazione predefinita i dati degli ultimi 30 giorni. Passa il mouse sul punto dati di ieri oppure guarda nella tabella dei dati sotto il grafico per vedere quanti pagamenti hai avuto ieri. Confronta quel numero con Stripe per la stessa data e lo stesso fuso orario, tenendo conto dei pagamenti che non hanno indirizzi e-mail validi.

5. Se i totali differiscono, verifica che la sincronizzazione storica sia terminata e che i pagamenti abbiano indirizzi e-mail validi. Confronta anche i fusi orari utilizzati in Klaviyo e Stripe. Per controllare l'impostazione del fuso orario in Klaviyo:

   - Fai clic sul nome del tuo account in basso a sinistra.

   - Seleziona **Impostazioni**, quindi **Generale > Account**.

   - Scorri verso il basso fino a *Fuso orario*.



## Le metriche di Stripe

Stripe sincronizza le seguenti metriche con Klaviyo:

- Pagamento non riuscito

- Fattura emessa

- Pagamento rimborsato

- Pagamento effettuato



![Metrics tab in Klaviyo filtered by Stripe with metrics including failed payment and issued invoice](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/ce592be1b18f5b8eaac8366d7c114dd8d533d532-779x311.jpg?auto=format)

### Pagamento non riuscito

Questa metrica viene registrata ogni volta che un pagamento effettuato tramite Stripe viene contrassegnato come non riuscito. Usa questa metrica per segmentare e raggiungere i clienti con pagamenti non riusciti, per informarli che hanno un saldo scaduto. Puoi filtrare e raggiungere gli eventi Pagamento non riuscito usando dettagli come Valuta e Motivo. Questi eventi includono le seguenti informazioni:

- **AttemptCount**
Il numero di tentativi di pagamento per la fattura associata. Incluso quando il pagamento è collegato a una fattura.

- **Valuta**
La valuta del pagamento non riuscito, ad es. *USD*, *GBP*.

- **Fattura**
La fattura a cui è collegato questo pagamento non riuscito in Stripe, se presente.

- **Motivo**
Il motivo per cui questo pagamento non è andato a buon fine in Stripe, ad esempio *La tua carta è scaduta*, *La tua carta è stata rifiutata*.



### Fattura emessa

Questa metrica viene registrata ogni volta che viene emessa una fattura ai tuoi clienti tramite Stripe. Usa questa metrica per segmentare i clienti a cui è stata emessa una fattura, ma che non hanno pagato oppure il cui pagamento non è andato a buon fine. Puoi anche usarla per attivare un flusso che avvisi i clienti di un pagamento imminente.

### Pagamento rimborsato

Questa metrica registra un evento quando rimborsi un pagamento tramite Stripe. Puoi filtrare e targetizzare gli eventi di pagamento rimborsato in base ai seguenti criteri:

- **Importo**
Il valore del pagamento che è stato rimborsato.



### Pagamento effettuato

Questa metrica viene registrata ogni volta che un cliente completa correttamente un pagamento tramite Stripe, indipendentemente dal fatto che sia collegato o meno a una fattura. Questi eventi includono i dati di pagamento e, quando presenti, la fattura associata e le relative voci. Usa questa metrica per inviare ai clienti ricevute automatiche delle fatture dopo il pagamento oppure usala insieme ai dati di attività del sito web nei flussi e-mail per identificare i clienti che sono stati attivi sul tuo sito web ma non hanno effettuato pagamenti per i tuoi prodotti o servizi. Puoi quindi inviare a questi utenti e-mail che offrono sconti per effettuare un acquisto sul tuo sito web.

Puoi filtrare e indirizzare gli eventi Successfully Paid in base alla **valuta**. Questi eventi includono le seguenti informazioni:

- **Valuta**
La valuta del pagamento, ad es. *USD*, *GBP*.

- **Fattura**
La fattura a cui è collegato questo pagamento in Stripe, se presente.



## Dati dei clienti

Per questa integrazione, Klaviyo identifica i clienti in base al loro indirizzo e-mail. Se Stripe sincronizza i dati dei clienti con un nuovo indirizzo e-mail, Klaviyo creerà un nuovo profilo composto dall’indirizzo e-mail del cliente e dalle metriche Stripe associate. Quando un pagamento include i dettagli della carta, la data di scadenza della carta viene memorizzata nella proprietà personalizzata **Stripe Card Expiration Date** sul profilo del cliente.

**📝 Note:** Per creare un profilo in Klaviyo, deve verificarsi uno degli eventi Stripe elencati sopra.

## Usa i dati di Stripe in Klaviyo

Usa una metrica Stripe per attivare un flusso. Puoi restringere il flusso con filtri di attivazione, ad esempio un filtro **Valuta**, e personalizzare i suoi messaggi con i dati dell’evento che lo attiva.

### Fatture automatizzate

Puoi inviare automaticamente le ricevute delle fatture ai tuoi clienti dopo che effettuano un pagamento configurando un flusso delle fatture, attivato dalla metrica *Successfully Paid* di Stripe.


![Flow in Klaviyo flow builder triggered by Successfully Paid](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/46611590f1817011bb6c6fdcf306e51248c62efe-1000x470.jpg?auto=format)

Questo flusso può compilare automaticamente un'e-mail che mostra dettagli di pagamento dinamici usando tag modello che fanno riferimento agli attributi di pagamento di Stripe.

Per ulteriori informazioni su come incorporare dati dinamici in un modello di e-mail, consulta il nostro articolo su [come utilizzare i dati degli eventi per personalizzare i messaggi del flusso](https://help.klaviyo.com/hc/it-it/articles/115005084927.md).

### Flusso dei pagamenti non riusciti di Stripe

Avvisa i clienti di un pagamento non riuscito con un flusso automatizzato, attivato dalla metrica Stripe *Failed Payment*.

![Flow in Klaviyo flow builder triggered by Failed Payment](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/9d44c342d65383e902b0a485475509005f373b0e-1000x684.jpg?auto=format)

## Risoluzione dei problemi

### Non vedo tutte le attività in Stripe sincronizzate con Klaviyo.

Un pagamento o una fattura Stripe deve avere un indirizzo e-mail valido per potersi sincronizzare con Klaviyo. Per i pagamenti, verifica l’indirizzo e-mail del cliente Stripe; se manca, Klaviyo utilizza l’e-mail presente nei dettagli di fatturazione del pagamento. Per le fatture, Klaviyo utilizza l’e-mail del cliente sulla fattura, usando come alternativa l’e-mail del cliente Stripe se manca. Se l’indirizzo e-mail selezionato da Klaviyo manca o non è valido, l’evento non verrà sincronizzato.

Tieni presente che i campi nome e cognome non sono necessariamente coerenti o univoci, quindi non creiamo profili basandoci solo su queste informazioni. In questo modo potresti creare duplicati e un tracciamento impreciso.

Se, anche con gli indirizzi e-mail associati, non vedi ancora i dati Stripe sincronizzarsi con Klaviyo, contatta [il nostro team di assistenza](https://help.klaviyo.com/hc/it-it/articles/115001002272.md).

## Risultato

Ora hai integrato Stripe con Klaviyo e hai imparato a usare i tuoi dati sincronizzati.

## Risorse aggiuntive

- [Primi passi con i flussi](https://help.klaviyo.com/hc/it-it/articles/115002774932.md)
  Scopri come utilizzare i flussi, noti anche come automazioni o campagne di drip marketing, su Klaviyo, per comunicazioni personalizzate e automatizzate con i tuoi clienti e impara a impostare e pubblicare il tuo primo flusso.
- [Primi passi con i segmenti](https://help.klaviyo.com/hc/it-it/articles/115005237908.md)
  Scopri come creare e usare i segmenti in Klaviyo, uno strumento potente per capire il tuo pubblico e inviare messaggi mirati. 
- [Comprendere i tipi di informazioni scambiate tra Klaviyo e le app](https://help.klaviyo.com/hc/it-it/articles/360030696012.md)
  Scopri quali tipi di dati vengono scambiati tra Klaviyo e le app esterne e dove trovare questi dati nel tuo account Klaviyo. Quando integri un'applicazione di terze parti con Klaviyo, le due piattaforme si scambiano informazioni. La maggior parte dello scambio di dati con Klaviyo è a senso unico; i dati vengono importati nel tuo account Klaviyo, così puoi sfruttare un'ampia gamma di dati dei tuoi clienti all'interno di Klaviyo. 
