Leitfaden zur Stripe-Apps-Integration

Mit Stripe Apps bettest du eigene Funktionen direkt in das Stripe Dashboard ein. Dieser Abschnitt ist ein Entwicklungsleitfaden: Er dokumentiert, wie eine solche App für die Tajo-Brevo-Integration gebaut, getestet und veröffentlicht würde.

Was sind Stripe Apps?

Stripe Apps erweitern das Stripe Dashboard um eigene UI-Komponenten und Backend-Integrationen. Sie erlauben Drittentwickler:innen:

• Eigene Ansichten zu Seiten des Stripe Dashboards hinzuzufügen (Kund:innen, Zahlungen, Rechnungen usw.)
• Über abgegrenzte Berechtigungen auf Stripe-Daten zuzugreifen
• Daten zwischen Stripe und externen Plattformen wie Brevo zu synchronisieren
• Onboarding- und Konfigurations-Flows direkt im Dashboard bereitzustellen

Ziele der Integration von Tajo + Brevo

Die Tajo-Stripe-App verbindet Stripe mit Brevo und liefert:

• Customer Intelligence: Synchronisiert Stripe-Kundenprofile, Zahlungshistorie und Lifetime Value in Brevo-Kontakte
• Event-Tracking: Sendet Stripe-Events (Zahlungen, Abos, Rückerstattungen) als transaktionale Events an Brevo
• Automatisierte Kampagnen: Löst E-Mail-, SMS- und WhatsApp-Kampagnen in Brevo auf Basis von Stripe-Aktivität aus
• Treueprogramme: Baut Retention-Workflows mit Stripe-Kaufdaten, die nach Brevo synchronisiert werden

Architekturüberblick

Inhalt des Leitfadens

Diese Dokumentation deckt den kompletten Lebenszyklus ab, von der Entwicklung bis zur Veröffentlichung einer Stripe App:

Erste Schritte

Konfiguration und Referenz

Funktionen und Integration

Betrieb und Wachstum

Voraussetzungen

Bevor du eine Stripe App baust, stelle sicher, dass du Folgendes hast:

1. Stripe-Konto: Ein aktiviertes Stripe-Konto (nicht auf den Testmodus beschränkt)
2. Stripe CLI: Installiere die Stripe CLI für lokale Entwicklung und App-Uploads
3. Node.js: Version 16 oder neuer für die UI-Extension der App
4. Zugang zur Tajo-Plattform: Aktives Tajo-Konto mit konfigurierten Brevo-API-Zugangsdaten

Schnellstart

# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start

Kernkonzepte

App-Manifest

Jede Stripe App hat ein Manifest stripe-app.json, das Berechtigungen, Viewports und Konfiguration deklariert. Das vollständige Schema findest du in der Referenz zum App-Manifest.

UI-Extensions

Stripe Apps können React-basierte UI-Komponenten in bestimmten Dashboard-Viewports rendern. Das UI-Toolkit liefert fertige Komponenten, die zum Designsystem des Stripe Dashboards passen.

Berechtigungen

Apps müssen die konkreten Stripe-API-Ressourcen deklarieren, auf die sie zugreifen wollen. Nutzer:innen bestätigen diese Berechtigungen bei der Installation. Siehe die Referenz zu Berechtigungen.

Signing Secret

Jede App erhält ein Signing Secret, um Installations-Signaturen zu prüfen und die Kommunikation zwischen deinem Backend und Stripe abzusichern.

Entwicklungsablauf

1. Definiere dein Manifest mit den nötigen Berechtigungen und Viewports
2. Baue die UI-Extension mit der React-Komponentenbibliothek von Stripe
3. Implementiere Backend-Endpunkte für den Datensync mit Brevo über Tajo
4. Teste lokal mit stripe apps start
5. Lade sie mit stripe apps upload hoch
6. Reiche sie über das Stripe Dashboard zur Prüfung ein
7. Veröffentliche sie und beobachte sie über Analytics

Nächste Schritte

Starte mit dem Leitfaden zur Veröffentlichung, um alle Anforderungen zu verstehen, und arbeite dich dann durch die technischen Referenzen, um App-Manifest und Berechtigungen zu konfigurieren.