Aan de slag met Stripe

Wat je leert

Leer hoe je Stripe met Klaviyo integreert om e-mails te personaliseren en te targeten op basis van factuur- en betalingsgegevens van je klanten.

Je stelt de Stripe-integratie in 2 stappen in. Verbind eerst je Stripe-account met Klaviyo. Stel vervolgens webhooks in Stripe in en rond de installatie in Klaviyo af om factuur- en betalingsgegevens in realtime te synchroniseren.

Hier is een overzicht van de gegevens die we synchroniseren vanuit Stripe:

• Wanneer er een factuur wordt uitgegeven, en de items die in elke factuur zijn opgenomen
• Betaalgegevens voor wanneer een gebruiker een betaling niet voltooit, een restitutie krijgt of succesvol betaalt

Je Stripe-account koppelen

Voordat je begint, zorg dat je een live Stripe account hebt en toestemming om integraties te beheren in Klaviyo.

1. Selecteer in Klaviyo het tabblad Integraties.
2. Selecteer Apps ontdekken, zoek naar Stripe en klik vervolgens op de kaart.
3. Klik vervolgens op Installeren.
4. Klik op Koppelen aan Stripe. Dit brengt je naar de website van Stripe - log indien nodig in.
5. Selecteer het Stripe-account dat je met Klaviyo wilt koppelen en klik op Koppelen.
   

6. Kopieer de webhook-URL onder Webhook instellen. Houd deze pagina open terwijl je de webhook in Stripe aanmaakt.

Stripe-webhooks instellen

Nu stellen we je Stripe-webhooks in, zodat je je Stripe-gegevens in realtime kunt synchroniseren.

1. Open Stripe in een nieuw tabblad. Gebruik de instructies van Stripe om een webhook-eindpunt te maken met de onderstaande instellingen.
2. Selecteer Je account en kies de Snapshot -payloadindeling.

3. Gebruik de volgende instellingen voor het eindpunt:
   • URL van eindpunt
     Plak de URL die je zojuist uit Klaviyo hebt gekopieerd.
   • API-versie
     Selecteer de nieuwste API-versie.
   • Gebeurtenissen
     Selecteer alle charge - en invoice -gebeurtenissen voor dit eindpunt. Je kunt alle charge.dispute -gebeurtenissen eventueel weglaten. Neem de volgende gebeurtenissen op:
     • charge.captured
     • 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. Rond het maken van het eindpunt in Stripe af en schakel het in.

5. Bevestig dat het eindpunt is ingeschakeld in Stripe.

6. Als je Stripe-webhooks wilt verifiëren (aanbevolen), kopieer je het ondertekeningsgeheim voor het eindpunt dat je net in Stripe hebt gemaakt. Ga terug naar Klaviyo en plak het in Signing secret onder Verify Stripe webhooks (Recommended). Dit voegt een extra beveiligingslaag toe aan je integratie.
7. Klik op Installatie afronden.

Je Stripe-integratie is nu ingeschakeld en historische gegevens worden binnenkort gesynchroniseerd.

Bekijk gegevens die vanuit Stripe zijn gesynchroniseerd

Klaviyo importeert maximaal 5 jaar aan factuur- en betalingsgeschiedenis. Open Stripe vanuit integraties en selecteer Gegevens om de voortgang te controleren. Wacht tot de historische synchronisatie is voltooid voordat je totalen vergelijkt.

Controleer je ingeschakelde integraties:

1. Klik in Klaviyo op de vervolgkeuzelijst Analytics en selecteer meetwaarde.
2. Zoek en selecteer Stripe's meetwaarde Succesvol betaald en selecteer vervolgens Activiteitenfeed.

3. Controleer of succesvolle betalingsevenementen in de feed verschijnen. Alleen betalingen met een geldig e-mailadres worden gesynchroniseerd met Klaviyo.
4. Klik bijvoorbeeld op de kop Grafiek voor de meetwaarde Successfully Paid. Deze grafiek toont standaard data van de afgelopen 30 dagen. Ga met je muis over het datapunt van gisteren, of kijk in de datatabel onder de grafiek, om te zien hoeveel betalingen je gisteren had. Vergelijk dat aantal met Stripe voor dezelfde datum en tijdzone, waarbij je rekening houdt met betalingen die geen geldige e-mailadressen hebben.
5. Als de totalen afwijken, controleer dan of de historische synchronisatie is afgerond en of de betalingen geldige e-mailadressen hebben. Vergelijk ook de tijdzones die in Klaviyo en Stripe worden gebruikt. Zo controleer je je tijdzone-instelling in Klaviyo:
   • Klik linksonder op je accountnaam.
   • Selecteer Instellingen en vervolgens Algemeen > account.
   • Scroll naar beneden naar Tijdzone.

De Stripe-meetwaarden

Stripe synchroniseert de volgende meetwaarden naar Klaviyo:

• Mislukte betaling
• Factuur uitgegeven
• Terugbetaalde betaling
• Heeft Betaald

Mislukte betaling

Deze meetwaarde wordt geregistreerd elke keer dat een betaling via Stripe als mislukt wordt gemarkeerd. Gebruik deze meetwaarde om klanten met mislukte betalingen te targeten en ze te laten weten dat ze een achterstallig saldo hebben. Je kunt Failed Payment-events filteren en targeten met behulp van details zoals valuta en reden. Deze gebeurtenissen bevatten de volgende informatie:

• AttemptCount
  Het aantal betalingspogingen voor de gekoppelde factuur. Opgenomen wanneer de betaling is gekoppeld aan een factuur.
• Valuta
  De valuta van de mislukte betaling, bijvoorbeeld USD, GBP.
• Factuur
  De factuur waaraan deze mislukte betaling is gekoppeld in Stripe, indien aanwezig.
• Reden
  De reden in Stripe waarom deze betaling is mislukt, bijv. Je kaart is verlopen, Je kaart is geweigerd.

Factuur uitgegeven

Deze meetwaarde wordt geregistreerd telkens wanneer er via Stripe een factuur aan je klanten wordt uitgegeven. Gebruik deze meetwaarde om te segmenteren op klanten aan wie een factuur is uitgegeven, maar die ofwel niet hebben betaald of bij wie een betaling is mislukt. Je kunt deze ook gebruiken om een flow te activeren om klanten op de hoogte te stellen van een aankomende betaling.

Terugbetaalde betaling

Deze meetwaarde registreert een gebeurtenis wanneer je een betaling terugbetaalt via Stripe. Je kunt gebeurtenissen Terugbetaalde betaling filteren en targeten op basis van de volgende criteria:

• Bedrag
  De waarde van de betaling die werd terugbetaald.

Heeft Betaald

Deze meetwaarde wordt geregistreerd telkens wanneer een klant succesvol een betaling doet via Stripe, ongeacht of deze is gekoppeld aan een factuur. Deze events bevatten betalingsgegevens en, indien aanwezig, de bijbehorende factuur en de factuurregels. Gebruik deze meetwaarde om geautomatiseerde factuurbonnen naar klanten te sturen nadat ze hebben betaald, of gebruik hem samen met website-activiteitsgegevens in e-mailflows om klanten te identificeren die actief zijn geweest op je website, maar geen betalingen hebben gedaan voor je producten of diensten. Je kunt die gebruikers vervolgens e-mails sturen waarin je kortingen aanbiedt om een aankoop te doen op je website.

Je kunt gebeurtenissen van Succesvol betaald filteren en targeten op valuta. Deze gebeurtenissen bevatten de volgende informatie:

• Valuta
  De valuta van de betaling, bijvoorbeeld USD, GBP.
• Factuur
  De factuur waaraan deze betaling in Stripe is gekoppeld, indien aanwezig.

klantgegevens

Voor deze integratie identificeert Klaviyo klanten op basis van hun e-mailadres. Als Stripe klantgegevens synchroniseert met een nieuw e-mailadres, maakt Klaviyo een nieuw profiel aan dat bestaat uit het e-mailadres van de klant en bijbehorende Stripe-meetwaarden. Als een betaling kaartgegevens bevat, wordt de vervaldatum van de kaart opgeslagen in de aangepaste eigenschap Stripe Card Expiration Date in het profiel van de klant.

Stripe-gegevens in Klaviyo gebruiken

Gebruik een Stripe-meetwaarde om een flow te activeren. Je kunt de flow verfijnen met triggerfilters, zoals een Valuta -filter, en de berichten ervan personaliseren met gegevens uit de gebeurtenis die de flow heeft geactiveerd.

Geautomatiseerde facturen

Je kunt automatisch factuurbetalingsbewijzen naar je klanten versturen nadat ze een betaling hebben gedaan door een factuurflow in te stellen, getriggerd door Stripe's meetwaarde Successfully Paid.

Deze flow kan automatisch een e-mail invullen die dynamische betalingsgegevens weergeeft met behulp van templatetags die verwijzen naar Stripe-betalingskenmerken.

Voor meer informatie over het insluiten van dynamische gegevens in een e-mailtemplate, bekijk je ons artikel over het gebruik van eventgegevens om flow-berichten te personaliseren.

Flow voor mislukte Stripe-betalingen

Informeer je klanten over een mislukte betaling met een geautomatiseerde flow, die wordt geactiveerd door de Stripe-meetwaarde Mislukte betaling.

Probleemoplossing

Ik zie niet alle activiteit in Stripe die wordt gesynchroniseerd met Klaviyo.

Een Stripe-betaling of -factuur moet een geldig e-mailadres hebben om naar Klaviyo te synchroniseren. Controleer bij betalingen het e-mailadres van de Stripe-klant; als dat ontbreekt, gebruikt Klaviyo het e-mailadres in de factureringsgegevens van de betaling. Voor facturen gebruikt Klaviyo het e-mailadres van de klant op de factuur en als dat ontbreekt, gebruikt Klaviyo het e-mailadres van de Stripe-klant. Als het e-mailadres dat Klaviyo selecteert ontbreekt of ongeldig is, wordt de gebeurtenis niet gesynchroniseerd.

Houd er rekening mee dat invoer voor voor- en achternaam niet per se consistent of uniek is, dus we maken niet alleen op basis van deze informatie profielen aan. Dat kan leiden tot duplicaten en onnauwkeurige tracking.

Als je, zelfs met gekoppelde e-mailadressen, nog steeds niet ziet dat Stripe-gegevens met Klaviyo synchroniseren, neem dan contact op met ons supportteam.

Resultaat

Je hebt Stripe nu geïntegreerd met Klaviyo en geleerd hoe je je gesynchroniseerde gegevens gebruikt.

Extra hulpbronnen