Stripe-connector
Koppel je Stripe-account aan Tajo voor read-only synchronisatie van betaalgegevens (klanten, charges, abonnementen en facturen) naar contactherleiding, segmentatie en omzetgedreven automatiseringen (via Brevo en andere engagementproviders).
Overzicht
| Eigenschap | Waarde |
|---|---|
| Authenticatie | Stripe secret key (sk_live_... / sk_test_...) of restricted key |
| Toegang | Read-only, Tajo schrijft nooit naar je Stripe-account |
| Basis-API | https://api.stripe.com/v1 |
| Synchronisatierichting | Stripe → Tajo |
| Realtime webhooks | Nog niet, synchronisatie werkt vandaag op basis van polling |
Instellen
- Open in het Stripe Dashboard Developers → API keys.
- Maak een restricted key aan. Leesrechten op Customers, Charges, Subscriptions en Invoices volstaan. Een restricted key heeft sterk de voorkeur boven de volledige secret key: Tajo leest alleen, dus geef alleen leesrechten.
- Plak de sleutel in de Stripe-verbinding in Tajo.
De verbinding wordt met een read-only verzoek gevalideerd voordat er iets wordt gesynchroniseerd. Je kunt de sleutel in Stripe op elk moment roteren of intrekken.
Wat er synchroniseert
| Gegevens | Wat Tajo ermee doet |
|---|---|
| Klanten | Worden herleid tot contacten (e-mailadres, naam, telefoonnummer, adres) voor identiteit en segmentatie. Toestemming wordt nooit afgeleid uit het bestaan van een klantrecord. |
| Charges | Omzetevents voor lifecycleautomatiseringen op basis van aankopen en voor LTV-segmentatie |
| Abonnementen | Lifecyclestatus (active, past_due, canceled…) voor aanmaningen, win-back en retentieflows |
| Facturen | Betaalstatus voor berichten rond facturatie |
Paginering gebruikt het cursormodel van Stripe (starting_after), zodat grote accounts volledig en hervatbaar synchroniseren.
Huidige beperkingen
Zonder omhaal benoemd, zodat je erop kunt plannen:
- Nog geen realtime webhooks. Wijzigingen komen binnen volgens het synchronisatieschema, niet op het moment dat een betaling slaagt. Het verwerken van webhooks staat op de roadmap.
- Read-only. Tajo maakt of wijzigt geen klanten, betalingen of abonnementen in Stripe.
- Geen Stripe App. Er staat vandaag geen Tajo-app in de Stripe App Marketplace; de verbinding stel je in Tajo in, niet in het Stripe Dashboard.
Problemen oplossen
| Symptoom | Oorzaak en oplossing |
|---|---|
| 401 vanuit Stripe | De sleutel is ingetrokken of geroteerd. Plak de huidige sleutel in de verbinding |
| Klanten synchroniseren wel, charges niet | De restricted key mist leesrechten op Charges |
| Contact heeft geen e-mailadres | Stripe-klanten zonder e-mailadres synchroniseren als anonieme omzetrecords; ze sluiten aan op de contactgraaf zodra het e-mailadres later wordt toegevoegd |
Volgende stappen
- Klantsynchronisatie: Stripe-klanten koppelen aan je system of record
- Bouw in Tajo automatiseringen voor aanmaningen en win-back op wijzigingen in de abonnementsstatus