Met de Stripe-koppeling van MailBlue synchroniseer je klant-, bestel- en abonnementsgegevens vanuit Stripe naar je MailBlue-account. Daarmee kun je contacten in MailBlue aanmaken en bijwerken en geautomatiseerde workflows starten zodra er in Stripe een gebeurtenis plaatsvindt.
Waar moet ik rekening mee houden?
Voordat je start, is het goed om dit te weten:
Je hebt een MailBlue-account en een Stripe-account nodig om de koppeling in te stellen.
Deze koppeling voegt contacten niet automatisch toe aan een lijst in MailBlue.
Je kunt Stripe-velden alleen koppelen aan bestaande velden in MailBlue. De koppeling maakt geen nieuwe velden aan in je MailBlue-account.
Stripe Customer-, Invoice-, Charge-, Checkout Session- en Subscription-gebeurtenissen maken en werken contacten bij in MailBlue. Subscription- en Checkout Session-gebeurtenissen maken ook Abonnementen en Bestellingen aan in MailBlue.
Deze koppeling ondersteunt de 'one-click checkout'-functie niet.
Alleen Stripe-klantgegevens zijn beschikbaar om te koppelen aan MailBlue-contacten.
Hoe werkt de Stripe-koppeling van MailBlue?
Tijdens het instellen kies je een Stripe-resource en een synchronisatievoorkeur. Afhankelijk van je keuze wordt ofwel alleen Stripe-klantdata gesynchroniseerd, of worden ook bestel- of abonnementsgegevens gesynchroniseerd.
De data wordt via een webhook vanuit Stripe naar MailBlue gestuurd. In Stripe is iedere webhook een gebeurtenis. Hieronder zie je welke webhooks welke gegevens synchroniseren:
Webhook-gebeurtenis | Contact maken | Bestelling maken | Terugkerende betaling maken | E-commerce klant maken |
charge.succeeded | ✅ | ❌ | ❌ | ❌ |
charge.refunded | ✅ | ❌ | ❌ | ❌ |
customer.created | ✅ | ❌ | ❌ | ❌ |
customer.updated | ✅ | ❌ | ❌ | ❌ |
customer.subscription.created | ✅ | ❌ | ✅ | ❌ |
customer.subscription.updated | ✅ | ❌ | ✅ | ❌ |
customer.subscription.deleted | ✅ | ❌ | ✅ | ❌ |
customer.subscription.trial_will_end | ✅ | ❌ | ✅ | ❌ |
customer.subscription.paused | ✅ | ❌ | ✅ | ❌ |
customer.subscription.resumed | ✅ | ❌ | ✅ | ❌ |
invoice.created | ✅ | ❌ | ❌ | ❌ |
invoice.updated | ✅ | ❌ | ❌ | ❌ |
invoice.payment_succeeded | ✅ | ❌ | ❌ | ❌ |
invoice.payment_failed | ✅ | ❌ | ❌ | ❌ |
invoice.upcoming | ✅ | ❌ | ❌ | ❌ |
checkout.session.async_payment_succeeded | ✅ | ✅ | ❌ | ✅ |
Stripe-contacttags
Alle Stripe-klantdata wordt via een resource-gebeurtenis gesynchroniseerd en krijgt daarbij deze twee tags op het contact:
'stripe-integration'
'stripe-integration-EVENT_NAME'
Contacten die via de resource 'Subscription' (terugkerende betalingen) worden gesynchroniseerd, krijgen deze tags:
'stripe-integration'
'stripe-integration-Billing_Subscription_Events'
Terugkerende betalingen
Kies je 'Subscription' als resource tijdens het instellen, dan worden gegevens over terugkerende betalingen gesynchroniseerd zodra een klant een abonnement koopt.
Stripe-automatiseringstriggers
Zodra je de koppeling hebt ingesteld, zijn deze automatiseringstriggers beschikbaar in je MailBlue-account:
Stripe-gebeurtenis ontvangen - de gebeurtenissen die je hier kunt kiezen, zijn gebaseerd op de resource-gebeurtenis die je tijdens het instellen selecteerde. Je vindt deze trigger in de sectie 'CX apps' van het trigger-venster. Je kunt deze trigger gebruiken voor gebeurtenissen zoals charge-, customer- of invoice-gebeurtenissen.
Doet een aankoop - deze trigger voegt contacten toe aan je automatisering wanneer ze een aankoop doen met Stripe.
Kies je 'Subscription' als resource, dan verschijnen deze triggers zodra de eerste terugkerende betaling naar MailBlue is gesynchroniseerd:
Terugkerende betaling bijgewerkt (beschikbaar bij de resource 'Subscription')
Terugkerende betaling aangemaakt (beschikbaar bij de resource 'Subscription')
Personalisatie-tags
Na het instellen van de koppeling kun je personalisatie-tags die horen bij je PayPal-gebeurtenissen invoegen in je geautomatiseerde campagnes.
Hoe koppel ik Stripe aan MailBlue?
Ga in je MailBlue-account naar je profiel > 'Apps'.
Zoek naar 'Stripe'.
Klik op de optie 'Stripe' om deze te openen.
De Stripe-app-pagina wordt geladen. Klik op de knop 'Account koppelen'.
Er opent een pop-up. Plak of typ je Stripe 'Secret key' in het veld en klik op 'Koppelen'.
Je API-token vind je in je Stripe-dashboard via 'Live API-sleutels' > 'Secret key'.
Kies op het volgende scherm een resource en een synchronisatievoorkeur. Zo doe je dat:
Klik op de dropdown 'Resource kiezen' en selecteer de resource die je wilt gebruiken. Je kunt kiezen uit: Charge, Customer, Subscription, Invoice, Checkout Session.
Klik op de dropdown 'Synchronisatietype' en selecteer wat je wilt synchroniseren. Je kunt historische records synchroniseren en nieuwe records vastleggen, of alleen nieuwe records synchroniseren.
Klik op 'Doorgaan' om naar het volgende scherm te gaan.
Koppel daarna velden uit je Stripe-account aan velden in je MailBlue-account. Het veld voor het e-mailadres is verplicht.
Klik op het eerste Stripe-dropdownveld en selecteer het veld dat je wilt synchroniseren naar het e-mailadresveld in MailBlue.
Koppel optioneel het veld 'Stripe ID' door op de tweede MailBlue-dropdown te klikken en het veld te kiezen waar je het aan wilt koppelen.
Koppel je het veld 'Customer Name' uit Stripe? MailBlue splitst deze waarde automatisch in de velden 'Voornaam' en 'Achternaam' in MailBlue.
Koppel extra velden door op 'Veldkoppeling toevoegen' te klikken.
Klik op 'Afronden'.
Op de Stripe-app-pagina in je MailBlue-account verschijnt een bevestiging dat het instellen van de koppeling is voltooid.
De Stripe-koppeling verschijnt ook op de pagina 'Gekoppelde apps' in je MailBlue-account.
Hoe beheer ik de Stripe-koppeling?
Je beheert je Stripe-koppeling via de Stripe-app-pagina in je MailBlue-account.
Zo ga je naar de Stripe-app-pagina:
Ga in je MailBlue-account naar je profiel > 'Apps'.
Klik op de optie 'Gekoppelde apps'.
Klik op 'Stripe'.
Vanaf deze pagina kun je:
Het e-mailadres van je gekoppelde Stripe-account bekijken.
De verbindingsstatus van de resource bekijken.
De resourcenaam bekijken.
Synchronisatielogs bekijken.
Een ander Stripe-account koppelen.
Een nieuwe resource koppelen.
Je Stripe-account ontkoppelen.
Een resource ontkoppelen.
Hoe werk ik veldkoppelingen bij?
Je kunt de veldkoppeling voor je gekoppelde Stripe-resource op ieder moment aanpassen. Nadat je de veldkoppeling bijwerkt, gelden de nieuwe koppelregels voor nieuwe synchronisaties. Gegevens van contacten die al eerder zijn gesynchroniseerd, worden niet aangepast.
Zo werk je de koppeling voor je Stripe-velden bij:
Ga naar de Stripe-app-pagina in je MailBlue-account (klik op je profiel > 'Apps' > 'Gekoppelde apps' > 'Stripe').
Klik op de resource die je wilt bijwerken.
Zoek de veldkoppeling die je wilt aanpassen en gebruik de dropdowns om de koppeling bij te werken.
Klik op 'Afronden'.
Hoe verbreek ik de koppeling van een Stripe-resource?
Wanneer je een Stripe-resource ontkoppelt, ontvangt je MailBlue-account geen data meer vanuit Stripe wanneer er een gebeurtenis plaatsvindt voor die resource. Je kunt de resource later altijd weer opnieuw koppelen als dat nodig is.
Het verwijderen van een resource verwijdert geen eerder gesynchroniseerde data uit je MailBlue-account.
Zo ontkoppel je een Stripe-resource:
Ga naar de Stripe-app-pagina in je MailBlue-account (klik op je profiel > 'Apps' > 'Gekoppelde apps' > 'Stripe').
Klik op het prullenbak-icoon naast de resource die je wilt ontkoppelen.
Er verschijnt een bevestigingsvenster. Klik op 'Verwijderen'.
De resource wordt verwijderd van de Stripe-app-pagina in je MailBlue-account. Je Stripe-account blijft wel gekoppeld aan MailBlue.
Hoe ontkoppel ik mijn Stripe-account?
Je kunt je Stripe-account op ieder moment ontkoppelen van MailBlue. Dit betekent dat:
Het Stripe-account niet langer zichtbaar is onder 'Gekoppelde apps'.
Er geen data meer wordt overgezet van je Stripe-account naar je MailBlue-account.
Het ontkoppelen verwijdert geen eerder gesynchroniseerde data uit je MailBlue-account.
Zo ontkoppel je je Stripe-account:
Ga naar de Stripe-app-pagina in je MailBlue-account (klik op je profiel > 'Apps' > 'Gekoppelde apps' > 'Stripe').
Klik op de knop 'Koppeling verbreken'.
Er verschijnt een bevestigingsvenster voor het ontkoppelen van het account. Klik op 'Koppeling verbreken'.
Je Stripe-account is nu ontkoppeld van je MailBlue-account. Je kunt de koppeling later opnieuw maken en velden opnieuw koppelen voor de resources die je wilt gebruiken.
Waarom zie ik de melding 'Er is een fout opgetreden bij het opslaan van mijn koppeling'?
Je kunt deze melding zien tijdens de stap waarin je velden koppelt, bijvoorbeeld als je je Stripe-account ook met andere diensten hebt gekoppeld.
Let op: Stripe heeft een harde limiet voor het aantal webhooks per account tussen hun applicatie en een andere applicatie. Deze limiet is 16 webhooks per Stripe-account.
Je kunt het aantal actieve webhooks zien door in te loggen in je Stripe-account.
Je kunt deze foutmelding oplossen door een van de 16 actieve webhooks te deactiveren of te verwijderen.
Veelgestelde vragen
Welke gegevens kan ik synchroniseren met de Stripe-koppeling?
Welke gegevens kan ik synchroniseren met de Stripe-koppeling?
Afhankelijk van de resource die je kiest, synchroniseert MailBlue Stripe-klantdata en eventueel ook bestel- of abonnementsgegevens.
Maakt de koppeling automatisch nieuwe velden aan in MailBlue?
Maakt de koppeling automatisch nieuwe velden aan in MailBlue?
Nee. Je kunt Stripe-velden alleen koppelen aan bestaande velden in je MailBlue-account.
Voegt de koppeling contacten automatisch toe aan een lijst?
Voegt de koppeling contacten automatisch toe aan een lijst?
Nee. Contacten worden wel aangemaakt of bijgewerkt, maar niet automatisch aan een lijst toegevoegd.
Kan ik later resources (opnieuw) koppelen of ontkoppelen?
Kan ik later resources (opnieuw) koppelen of ontkoppelen?
Ja. Je kunt resources ontkoppelen of nieuwe resources toevoegen via de Stripe-app-pagina, en je kunt ze later ook weer opnieuw koppelen.