Stripe-Connector
Verbinde dein Stripe-Konto mit Tajo für eine rein lesende Synchronisation von Zahlungsdaten, also Kund:innen, Zahlungen, Abos und Rechnungen, in Kontaktauflösung, Segmentierung und umsatzgetriebene Automationen (über Brevo und andere Engagement-Anbieter).
Überblick
| Eigenschaft | Wert |
|---|---|
| Authentifizierung | Stripe Secret Key (sk_live_... / sk_test_...) oder eingeschränkter Key |
| Zugriff | Nur lesend, Tajo schreibt nie in dein Stripe-Konto |
| Basis-API | https://api.stripe.com/v1 |
| Sync-Richtung | Stripe → Tajo |
| Echtzeit-Webhooks | Noch nicht, der Sync läuft heute per Polling |
Einrichtung
- Öffne im Stripe Dashboard Developers → API keys.
- Erstelle einen eingeschränkten Key, Leseberechtigung auf Customers, Charges, Subscriptions und Invoices genügt. Ein eingeschränkter Key ist dem vollen Secret Key deutlich vorzuziehen: Tajo liest nur, also gib auch nur Lesezugriff.
- Füge den Key in die Stripe-Verbindung in Tajo ein.
Die Verbindung wird vor jedem Sync mit einer reinen Leseanfrage geprüft. Du kannst den Key in Stripe jederzeit rotieren oder widerrufen.
Was synchronisiert wird
| Daten | Was Tajo damit macht |
|---|---|
| Kund:innen | Werden zu Kontakten aufgelöst (E-Mail, Name, Telefon, Adresse) für Identität und Segmentierung. Ein Einverständnis wird nie daraus abgeleitet, dass ein Kundendatensatz existiert. |
| Zahlungen | Umsatz-Events für kaufbasierte Lifecycle-Automationen und LTV-Segmentierung |
| Abos | Lifecycle-Status (active, past_due, canceled…) für Dunning, Rückgewinnung und Retention-Flows |
| Rechnungen | Zahlungsstatus für Nachrichten rund um die Abrechnung |
Die Paginierung nutzt das Cursor-Modell von Stripe (starting_after), damit auch große Konten vollständig und wiederaufnehmbar synchronisiert werden.
Aktuelle Einschränkungen
Klar benannt, damit du sie einplanen kannst:
- Noch keine Echtzeit-Webhooks. Änderungen kommen nach dem Sync-Zeitplan an, nicht in dem Moment, in dem eine Zahlung erfolgreich ist. Der Webhook-Empfang steht auf der Roadmap.
- Nur lesend. Tajo erstellt oder ändert in Stripe keine Kund:innen, Zahlungen oder Abos.
- Keine Stripe App. Im Stripe App Marketplace gibt es heute keine Tajo-App; die Verbindung wird in Tajo konfiguriert, nicht im Stripe Dashboard.
Fehlerbehebung
| Symptom | Ursache und Lösung |
|---|---|
| 401 von Stripe | Key widerrufen oder rotiert, füge den aktuellen Key in die Verbindung ein |
| Kund:innen werden synchronisiert, Zahlungen nicht | Dem eingeschränkten Key fehlt die Leseberechtigung auf Charges |
| Kontakt hat keine E-Mail-Adresse | Stripe-Kund:innen ohne E-Mail werden als anonyme Umsatzdatensätze synchronisiert; sie kommen in den Kontaktgraphen, sobald die E-Mail nachgetragen wird |
Nächste Schritte
- Kundensynchronisation: Stripe-Kund:innen in dein System of Record übernehmen
- Baue in Tajo Dunning- und Rückgewinnungs-Automationen auf Basis von Statusänderungen der Abos