Stripe Apps Integrationsleitfaden

Mit Stripe Apps können Sie benutzerdefinierte Funktionen direkt in das Stripe Dashboard einbetten und Händlern Zugang zur Tajo-Brevo-Integration geben, ohne ihren Zahlungsworkflow zu verlassen. Dieser Leitfaden deckt alles ab, was Sie zum Erstellen, Testen und Veröffentlichen einer Stripe App benötigen, die Stripe über Tajo mit Brevo verbindet.

Was sind Stripe Apps?

Stripe Apps erweitern das Stripe Dashboard um benutzerdefinierte UI-Komponenten und Backend-Integrationen. Sie ermöglichen Drittentwicklern:

• Benutzerdefinierte Ansichten zu Stripe Dashboard-Seiten hinzuzufügen (Kunden, Zahlungen, Rechnungen usw.)
• Auf Stripe-Daten über kontrollierte Berechtigungen zuzugreifen
• Daten zwischen Stripe und externen Plattformen wie Brevo zu synchronisieren
• Onboarding- und Konfigurationsflows innerhalb des Dashboards bereitzustellen

Tajo + Brevo Integrationsziele

Die Tajo Stripe App verbindet Stripe mit Brevo für:

• Kundenintelligenz: Synchronisierung von Stripe-Kundenprofilen, Zahlungshistorie und Lebenszeitwert mit Brevo-Kontakten
• Event-Tracking: Übertragung von Stripe-Events (Zahlungen, Abonnements, Rückerstattungen) als Brevo-Transaktionsevents
• Automatisierte Kampagnen: Auslösung von Brevo E-Mail-, SMS- und WhatsApp-Kampagnen basierend auf Stripe-Aktivität
• Treueprogramme: Aufbau von Kundenbindungs-Workflows mit Stripe-Kaufdaten, synchronisiert mit Brevo

Architekturübersicht

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Stripe Dashboard │────▶│   Tajo Platform  │────▶│     Brevo       │
│  (Stripe App UI) │◀────│   (Middleware)    │◀────│   (CRM/Email)   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                        │                        │
   Customer views          Data sync &              Contacts,
   Payment details         Event routing            Campaigns,
   App settings            Webhook handling         Automations

Leitfaden-Inhalte

Diese Dokumentation deckt den kompletten Lebenszyklus der Erstellung und Veröffentlichung einer Stripe App ab:

Erste Schritte

Konfiguration & Referenz

Funktionen & Integration

Betrieb & Wachstum

Voraussetzungen

Bevor Sie eine Stripe App erstellen, stellen Sie sicher, dass Sie haben:

1. Stripe-Konto: Ein aktiviertes Stripe-Konto (nicht auf Testmodus beschränkt)
2. Stripe CLI: Installieren Sie die Stripe CLI für lokale Entwicklung und App-Uploads
3. Node.js: Version 16 oder neuer für die App UI Extension
4. Tajo-Plattformzugang: Aktives Tajo-Konto mit konfigurierten Brevo API-Anmeldedaten

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

Schlüsselkonzepte

App Manifest

Jede Stripe App hat eine stripe-app.json Manifest-Datei, die Berechtigungen, Viewports und Konfiguration deklariert. Siehe die App Manifest Referenz für das vollständige Schema.

UI Extensions

Stripe Apps können React-basierte UI-Komponenten in bestimmten Dashboard-Viewports rendern. Das UI-Toolkit bietet vorgefertigte Komponenten, die dem Design-System des Stripe Dashboards entsprechen.

Berechtigungen

Apps müssen die spezifischen Stripe API-Ressourcen deklarieren, auf die sie zugreifen müssen. Benutzer genehmigen diese Berechtigungen während der Installation. Siehe die Berechtigungsreferenz.

Signing Secret

Jede App erhält ein Signing Secret zur Überprüfung von Installationssignaturen und zur Sicherung der Kommunikation zwischen Ihrem Backend und Stripe.

Entwicklungs-Workflow

1. Definieren Sie Ihr Manifest mit erforderlichen Berechtigungen und Viewports
2. Erstellen Sie die UI Extension mit Stripes React-Komponentenbibliothek
3. Implementieren Sie Backend-Endpunkte für die Datensynchronisierung mit Brevo über Tajo
4. Testen Sie lokal mit stripe apps start
5. Hochladen mit stripe apps upload
6. Einreichen zur Überprüfung über das Stripe Dashboard
7. Veröffentlichen und über Analytics überwachen

Nächste Schritte

Beginnen Sie mit dem Veröffentlichungsleitfaden, um die vollständigen Anforderungen zu verstehen, und arbeiten Sie dann die technischen Referenzen durch, um Ihr App-Manifest und die Berechtigungen zu konfigurieren.