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.
   

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

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 per creare un webhook endpoint con le impostazioni di seguito.
2. Seleziona Il tuo account e scegli il formato del payload Snapshot.

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.

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

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à.

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

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.

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.

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.

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.

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.

Risultato

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

Risorse aggiuntive