Iniziare con Stripe

Imparerai

Scopra come integrare Stripe con Klaviyo per personalizzare e indirizzare le e-mail in base ai dati delle fatture e dei pagamenti dei suoi clienti.

L'integrazione con Stripe verrà impostata in due fasi. Per prima cosa, collegherà Stripe abilitando l'integrazione in Klaviyo. Poi si impostano i webhook in Stripe, che consentiranno una sincronizzazione in tempo reale dei dati specifici di Stripe in Klaviyo.

Ecco una panoramica dei dati che sincronizziamo da Stripe:

• Quando viene emessa una fattura, e le voci incluse in ciascuna fattura
• Informazioni sul pagamento per quando un utente non riesce a pagare, viene rimborsato o paga con successo.

Abilita l'integrazione di Stripe in Klaviyo

1. In Klaviyo, clicchi sul nome del suo account nell'angolo inferiore sinistro, quindi selezioni Integrazioni.
2. Seleziona Aggiungi integrazioni, cerca Stripe e clicca sulla carta. 
3. Poi, faccia clic su Installa.
4. Clicchi su Connetti a Stripe. Questo la porterà al sito web di Stripe - effettui il login, se necessario.
5. Selezioni l'account Stripe che desidera collegare a Klaviyo e clicchi su Connetti. 
   
6. Tornando a Klaviyo, può scegliere di verificare i webhook di Stripe inserendo il suo segreto di firma (consigliato). Questo si trova in Stripe alla voce Sviluppatori > Webhooks e aggiungerà un ulteriore livello di sicurezza alla sua integrazione.
   
7. Copi l'URL del webhook da questa pagina. Questo verrà incollato nel suo account Stripe nella prossima sezione. 
8. Clicchi su Completa la configurazione.

Configurare i webhook di Stripe

Ora imposteremo i webhook di Stripe, che le consentiranno di sincronizzare i dati di Stripe in tempo reale.

1. Apra Stripe in una nuova scheda e si rechi nella scheda Sviluppatori.
2. Selezioni Webhooks e faccia clic su Aggiungi endpoint.
   
3. Compili i seguenti campi:
   • URL dell'endpoint
     Incolli l'URL appena copiato da Klaviyo.
   • Versione
     Selezioni la versione API più recente.
   • Eventi da inviare
     Klaviyo richiede i dati relativi agli addebiti e alle fatture. Nel menu a tendina Eventi da inviare, selezioni tutti gli eventi di addebito e di fatturazione. Può opzionalmente omettere tutti gli eventi charge.dispute. Crei endpoint per tutti i seguenti eventi:
     • carica.catturato
     • carica.scaduta
     • carica.fallita
     • carica.in sospeso
     • addebito.rimborsato
     • carica.riuscita
     • carica.aggiornato
     • fattura.creata
     • fattura.cancellato
     • fattura.finalizzata
     • fattura.segnata_incassabile
     • fattura.azione_di_pagamento_richiesta
     • fattura.pagamento_fallito
     • fattura.pagamento_successo
     • fattura.inviata
     • fattura.imminente
     • fattura.aggiornato
     • fattura.annullata
4. Dopo aver selezionato tutti gli eventi di addebito e di fatturazione, selezioni Aggiungi endpoint.
   
5. Riceverà la conferma che i suoi webhook sono abilitati.
   
6. La sua integrazione con Stripe è ora abilitata.

Visualizza i dati sincronizzati da Stripe

Per verificare la sua integrazione abilitata:

1. Clicchi sul menu a tendina Analytics in Klaviyo e selezioni Metriche.
2. Trovi la metrica Pagamenti riusciti di Stripe e clicchi sull'icona Feed attività.
   
3. Se la sua integrazione ha iniziato a sincronizzare i dati, vedrà le fatture emesse tramite Stripe popolarsi qui. Quando la sua integrazione è completamente sincronizzata, l'integrazione Stripe mostrerà un bordo verde accanto ad essa nel suo account Klaviyo. Klaviyo importa tutti i dati di Stripe. Per verificarlo, può confrontare il numero di pagamenti andati a buon fine in un determinato giorno con quanto riportato nell'interfaccia di Stripe e confermare che corrispondono.
4. Per esempio, clicchi sull'intestazione del grafico per la metrica Pagato con successo. Questo grafico mostra gli ultimi 30 giorni di dati per impostazione predefinita. Passi il mouse sul punto dati di ieri o guardi nella tabella dei dati sotto il grafico per vedere quanti pagamenti ha avuto ieri. Confronti questo numero con quello memorizzato in Stripe e vedrà che corrispondono esattamente.
5. Se i dati non corrispondono, il problema è molto probabilmente che il fuso orario del suo account Klaviyo non corrisponde al fuso orario del suo account Stripe. Per verificare l'impostazione del fuso orario in Klaviyo:
   • Clicchi sul nome del suo account in basso a sinistra.
   • Selezioni poi Impostazioni > Organizzazione.
   • Scorra in basso fino a Fuso orario.

Le metriche di Stripe

Stripe sincronizza le seguenti metriche con Klaviyo:

• Pagamento non riuscito
• Fattura emessa
• Pagamento rimborsato
• Pagato con successo

Pagamento non riuscito

Questa metrica viene registrata ogni volta che un pagamento effettuato tramite Stripe viene contrassegnato come fallito. Utilizzi questa metrica per rivolgersi ai clienti che non pagano, per informarli che hanno un saldo in ritardo. Può filtrare e indirizzare gli eventi di Pagamento non riuscito in base ai seguenti criteri:

• AttemptCount
  Il numero di volte in cui questa fattura ha tentato di addebitare l'utente.
• Valuta
  La valuta della fattura non pagata, ad esempio USD, GBP.
• Fattura
  La fattura a cui è legato questo pagamento non riuscito in Stripe.
• Motivo
  Il motivo per cui in Stripe questo pagamento non è andato a buon fine, ad esempio, La sua carta è scaduta, La sua carta è stata rifiutata.

Fattura emessa

Questa metrica viene registrata ogni volta che viene emessa una fattura ai suoi clienti attraverso Stripe. Utilizzi questa metrica per segmentare i clienti a cui è stata emessa una fattura, ma che non hanno pagato o che hanno fallito il pagamento. Può anche essere utilizzato per attivare segmenti per avvisare i clienti di un pagamento imminente.

Pagamento rimborsato

Questa metrica registra un evento quando lei rimborsa un pagamento tramite Stripe. Può filtrare e indirizzare gli eventi di pagamento rimborsato in base ai seguenti criteri:

• Importo
  Il valore del pagamento che è stato rimborsato.

Pagato con successo

Questa metrica viene registrata ogni volta che un cliente paga con successo una fattura attraverso Stripe. Questi eventi includono dati sul suo cliente, sulla sua fattura e sui prodotti contenuti nella fattura. Utilizzi questa metrica per inviare fatture automatiche ai clienti dopo che hanno pagato, o nei flussi di e-mail per determinare quando un cliente è stato attivo sul suo sito web, ma non ha effettuato pagamenti per i suoi prodotti o servizi. Può quindi inviare a questi utenti delle e-mail che offrono sconti per effettuare un acquisto sul suo sito web.

Può filtrare e indirizzare gli eventi Pagato con successo in base ai seguenti criteri:

• Valuta
  La valuta della fattura pagata, ad esempio USD, GBP.
• Fattura
  La fattura a cui è legato questo pagamento in Stripe.

Dati del cliente

Klaviyo identifica in modo univoco ogni persona attraverso il suo indirizzo e-mail. Se Stripe sincronizza i dati del cliente con un nuovo indirizzo e-mail, Klaviyo creerà un nuovo profilo composto dall'indirizzo e-mail del cliente e dalle metriche Stripe associate. Le date di scadenza della carta di credito sono memorizzate come proprietà personalizzata nel profilo del cliente.

Utilizza i dati di Stripe in Klaviyo

Qualsiasi metrica o metadata di Stripe può essere utilizzata per attivare un flusso in Klaviyo.

Fatture automatizzate

Può inviare automaticamente le ricevute delle fatture ai suoi clienti dopo che hanno effettuato un pagamento, impostando un flusso di fatture, attivato dalla metrica Successfully Paid di Stripe.

Questo flusso può popolare automaticamente un'e-mail che visualizza i dettagli del pagamento dinamico utilizzando i tag del modello che fanno riferimento agli attributi di pagamento di Stripe.

Per maggiori informazioni sull'inserimento di dati dinamici in un modello e-mail, consulti il nostro articolo sui tag dei modelli e sulla sintassi delle variabili.

Il flusso di pagamenti di Stripe è fallito

Avverta i suoi clienti di un pagamento non riuscito con un flusso automatico, attivato dalla metrica Pagamento non riuscito di Stripe.

Risoluzione dei problemi

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

Il motivo più comune per cui un evento Stripe non si sincronizza con Klaviyo è che non c'è un indirizzo e-mail associato all'evento. Poiché Klaviyo utilizza un indirizzo e-mail per identificare in modo univoco una persona, non possiamo creare un profilo per qualcuno che non sia associato ad un indirizzo e-mail. Allo stesso modo, Klaviyo non può collegare un evento ad un profilo se non è associato ad un indirizzo e-mail.

Tenga presente che gli input di nome e cognome non sono necessariamente coerenti o unici, quindi non creiamo profili basati solo su queste informazioni. Questo potrebbe portare a duplicati e a un tracciamento impreciso.

Se, anche con gli indirizzi e-mail associati, non vede ancora la sincronizzazione dei dati di Stripe con Klaviyo, contatti il nostro team di assistenza.

Risultato

Ora ha integrato Stripe con Klaviyo e ha imparato a utilizzare i dati sincronizzati.

Risorse aggiuntive

• Iniziare con i flussi
• Iniziare con i segmenti
• Capire i tipi di dati scambiati tra Klaviyo e le applicazioni