--- title: "Veröffentlichung im Stripe App Marketplace | Tajo" description: "Schritt-für-Schritt-Anleitung zur Vorbereitung, Einreichung und Veröffentlichung deiner Stripe App im Marketplace" url: https://tajo.io/de/docs/stripe-apps/publish-app/ markdown: https://tajo.io/de/docs/stripe-apps/publish-app.md lang: de-DE author: "Set Noa" author_url: https://tajo.io/de/set-noa/ robots: noindex --- Beantrage frühzeitigen Zugang Gib deinen Vornamen und deine geschäftliche E-Mail-Adresse ein. Wir senden dir einen Link, mit dem du deine Anfrage für den Tajo-Zugang bestätigst. # Veröffentlichung im Stripe App Marketplace [Set Noa](https://tajo.io/de/set-noa/) Wenn du deine Stripe App im Marketplace veröffentlichst, steht sie allen Stripe-Nutzer:innen zur Verfügung. Diese Anleitung behandelt die Anforderungen, die Vorbereitungsschritte und den Einreichungsprozess. Caution **Status: geplant, nicht gebaut.** Tajo hat keine Stripe App, daher lässt sich nichts in diesem Abschnitt heute installieren. Die App-Kennungen, URLs und Zugangsdaten auf dieser Seite sind illustrative Platzhalter, keine echten Endpunkte. ## Voraussetzungen Bevor du eine App im Stripe App Marketplace veröffentlichen kannst, musst du diese Anforderungen erfüllen: - **Aktiviertes Stripe-Konto**: Dein Konto darf nicht auf den Testmodus beschränkt sein - **Eine App pro Konto**: Jedes Stripe-Konto kann nur eine öffentliche App im Marketplace veröffentlichen - **Nur Englisch**: Alle App-Inhalte, UI-Texte und Listing-Informationen müssen auf Englisch sein - **Fertige App**: Deine App muss vollständig funktionsfähig und getestet sein Caution Wenn du mehrere Apps veröffentlichen willst, musst du für jede ein eigenes Stripe-Konto anlegen. ## Schritte zur Veröffentlichung ### Schritt 1: Manifest aktualisieren Setze `distribution_type` in deiner `stripe-app.json` auf `public`: ```json { "id": "com.tajo.brevo-integration", "version": "1.0.0", "name": "Tajo Brevo Integration", "icon": "./icon.png", "distribution_type": "public", "permissions": [ { "permission": "customer_read", "purpose": "Sync customer data to Brevo contacts" }, { "permission": "customer_write", "purpose": "Update customer metadata with Brevo sync status" }, { "permission": "event_read", "purpose": "Track payment and subscription events for Brevo automation" } ] } ``` ### Schritt 2: App vorbereiten Stelle sicher, dass deine App vor dem Einreichen alle [Überprüfungsanforderungen](https://tajo.io/de/docs/stripe-apps/review-requirements) erfüllt: 1. Teste gründlich im Live- und im Sandbox-Modus 2. Prüfe, dass alle Berechtigungen notwendig und dokumentiert sind 3. Bestätige, dass Fehlerbehandlung und Ladezustände umgesetzt sind 4. Kontrolliere, dass alle UI-Texte auf Englisch sind ### Schritt 3: App hochladen Lade deine App mit der Stripe CLI hoch: ```bash # Upload your app to Stripe stripe apps upload # Verify the upload stripe apps versions list ``` ### Schritt 4: Listing schreiben Wechsle ins Stripe Dashboard und vervollständige dort dein App-Listing. Für die Einreichung im Marketplace sind alle Listing-Felder Pflicht. ### Schritt 5: Zur Überprüfung einreichen Reiche die App nach dem Vervollständigen des Listings über das Stripe Dashboard zur Überprüfung ein. Das Team von Stripe bewertet deine App anhand der [Qualitätsanforderungen](https://tajo.io/de/docs/stripe-apps/review-requirements). ### Schritt 6: Veröffentlichen Sobald die App genehmigt ist, kannst du sie veröffentlichen und damit im Marketplace verfügbar machen. ## Manifest für die öffentliche Verteilung Das Manifest muss `distribution_type: "public"` enthalten und alle benötigten Berechtigungen mit klaren Zweckbeschreibungen deklarieren: ```json { "id": "com.tajo.brevo-integration", "version": "1.2.0", "name": "Tajo for Brevo", "icon": "./assets/icon.png", "distribution_type": "public", "stripe_api_access_type": "oauth", "allowed_redirect_uris": [ "https://tajo.io/stripe/callback" ], "permissions": [ { "permission": "customer_read", "purpose": "Read customer profiles to sync with Brevo contacts" }, { "permission": "customer_write", "purpose": "Write sync metadata to customer records" }, { "permission": "charge_read", "purpose": "Access payment data for Brevo event tracking" }, { "permission": "event_read", "purpose": "Read Stripe events so a sync picks up changes" }, { "permission": "product_read", "purpose": "Sync product catalog to Brevo for campaign personalization" }, { "permission": "invoice_read", "purpose": "Track invoice events for Brevo transactional emails" } ], "ui_extension": { "views": [ { "viewport": "stripe.dashboard.customer.detail", "component": "CustomerDetailView" }, { "viewport": "stripe.dashboard.home.overview", "component": "OverviewView" } ] }, "post_install_action": { "type": "onboarding" } } ``` Lade die konfigurierte App hoch mit: ```bash stripe apps upload ``` ## Anforderungen an das Listing Dein App-Listing muss alle folgenden Felder enthalten: | Feld | Anforderungen | Details | | --- | --- | --- | | **Name** | Max. 35 Zeichen | Der Anzeigename im Marketplace | | **Icon** | 300x300 Pixel, PNG oder SVG | Quadratisches Icon, keine abgerundeten Ecken (die ergänzt Stripe) | | **Built by** | Firmen- oder Entwicklername | Wird unter dem App-Namen angezeigt | | **Kategorie** | Aus den Kategorien von Stripe wählen | Wähle die passendste Kategorie für deine App | | **Untertitel** | Max. 80 Zeichen | Kurzer Slogan in den Suchergebnissen | | **Über die App** | Max. 1.000 Zeichen | Ausführliche Beschreibung dessen, was deine App leistet | | **Wichtigste Funktionen** | Bis zu 5, mit Bildern | Hebe die Hauptfunktionen mit Screenshots oder Diagrammen hervor | | **Preise** | Kostenlos, kostenpflichtig oder Freemium | Nenne Preismodell und Kosten eindeutig | | **Support** | Kontakt-URL oder E-Mail | Wo Nutzer:innen Hilfe zu deiner App bekommen | | **Datenschutzerklärung** | URL zur Datenschutzerklärung | Rechtlich erforderliches Dokument zum Umgang mit Daten | ### Hinweise zum Namen - Muss im Marketplace eindeutig sein - Sollte den Zweck deiner App klar erkennen lassen - Vermeide generische Begriffe, die Nutzer:innen verwirren können - Beispiel: “Tajo for Brevo” (15 Zeichen) ### Hinweise zum Icon - Maße: exakt 300x300 Pixel - Format: PNG oder SVG - Runde die Ecken nicht selbst ab, Stripe erledigt das automatisch - Verwende ein klares, wiedererkennbares Logo oder Symbol - Achte darauf, dass es auch in kleiner Darstellung lesbar bleibt ### Abschnitt „Über die App“ Schreibe eine überzeugende Beschreibung, die Folgendes abdeckt: - Welches Problem deine App löst - Die wichtigsten Fähigkeiten der Integration - Für wen die App gedacht ist - Etwaige Voraussetzungen oder Anforderungen Beispiel: > Tajo for Brevo verbindet deine Stripe-Zahlungsdaten mit der Marketing-Automation-Plattform von Brevo. Synchronisiere Kund:innen automatisch, verfolge Zahlungsereignisse und löse personalisierte Kampagnen per E-Mail, SMS und WhatsApp auf Basis des Kaufverhaltens aus. Gebaut für E-Commerce-Unternehmen, die den Customer Lifetime Value durch datengetriebenes Retention-Marketing maximieren wollen. ### Wichtigste Funktionen Jeder Eintrag bei den wichtigsten Funktionen enthält: - **Titel**: Kurzer Name der Funktion - **Beschreibung**: Ein bis zwei Sätze, die die Funktion erklären - **Bild**: Screenshot oder Diagramm (empfohlen 1600x900 Pixel) Empfohlene Funktionen für die Tajo Brevo-Integration: 1. **Kundensynchronisierung**, synchronisiert Stripe-Kundenprofile automatisch mit vollständiger Kaufhistorie zu Brevo-Kontakten 2. **Ereignisgesteuerte Automation**, löst Brevo-Workflows aus Stripe-Events aus, etwa erfolgreichen Zahlungen, Abo-Änderungen und Rückerstattungen 3. **Produktkatalog-Sync**, hält deinen Brevo-Produktkatalog mit Stripe synchron für personalisierte Kampagneninhalte 4. **Kampagnen über mehrere Kanäle**, nutzt die synchronisierten Daten für zielgerichtete Kampagnen per E-Mail, SMS und WhatsApp 5. **Einblicke im Dashboard**, zeigt Brevo-Engagement-Metriken direkt in der Kundenansicht des Stripe Dashboards ### Angaben zu den Preisen Kommuniziere dein Preismodell eindeutig: - **Kostenlos**: Installation und Nutzung kosten nichts - **Kostenpflichtig**: Nenne Preis und Abrechnungsintervall - **Freemium**: Beschreibe, was kostenlos enthalten ist und wofür bezahlt wird - **Nutzungsbasiert**: Erkläre die Preisstufen oder die Kosten pro Einheit ## Deine App testen Teste deine App vor der Einreichung gründlich: ### Im Sandbox-Modus testen ```bash # Start your app in test mode stripe apps start --mode test # Verify sandbox compatibility stripe apps validate ``` ### Format der Testzugangsdaten Verwende dieses Format, wenn du dem Überprüfungsteam Testzugangsdaten bereitstellst: ``` Test Account Credentials ======================== Platform: Tajo URL: https://app.tajo.io/test Email: reviewer@test.tajo.io Password: [secure test password] Brevo Test API Key: xkeysib-test-xxxxxxxxxxxx Required Setup Steps: 1. Log in to the Tajo test account 2. Navigate to Settings > Integrations > Brevo 3. The Brevo API key is pre-configured 4. Install the Stripe App from the test link provided Expected Behavior: - Customer sync should begin within 60 seconds of installation - Navigate to any Stripe customer to see Brevo contact data - Create a test payment to verify event sync to Brevo ``` ### Checkliste vor der Einreichung Prüfe vor dem Einreichen: - Die App funktioniert im Live- und im Testmodus - Alle Berechtigungen haben klare Zweckbeschreibungen - Fehlerzustände werden sauber abgefangen - Ladezustände werden bei asynchronen Vorgängen angezeigt - Keine fest einprogrammierten Testdaten im Produktions-Build - Die URL der Datenschutzerklärung ist erreichbar und korrekt - Die Support-Kontaktdaten sind gültig - Alle Listing-Bilder erfüllen die Maßvorgaben - Die App-Beschreibung gibt den Funktionsumfang korrekt wieder ## Nach der Einreichung Das Überprüfungsteam von Stripe antwortet in der Regel innerhalb von 5-10 Werktagen. Es kann deine App: - **Genehmigen** und damit zur Veröffentlichung freigeben - **Änderungen anfordern** und dir konkretes Feedback geben - **Ablehnen**, wenn sie die Anforderungen nicht erfüllt Wenn Änderungen angefordert werden, arbeite das gesamte Feedback ab und reiche erneut ein. Jede erneute Einreichung durchläuft den vollständigen Überprüfungszyklus. ## Eine veröffentlichte App aktualisieren So aktualisierst du eine bereits veröffentlichte App: 1. Erhöhe die Version in `stripe-app.json` 2. Lade die neue Version hoch: `stripe apps upload` 3. Reiche das Update zur Überprüfung ein 4. Nach der Genehmigung wird das Update automatisch an alle Nutzer:innen ausgeliefert Tip Kleinere Fehlerbehebungen und Änderungen ohne Funktionsauswirkung können beschleunigt überprüft werden. Größere neue Funktionen oder geänderte Berechtigungen erfordern eine vollständige Überprüfung.