Veröffentlichung im Stripe App Marketplace

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.

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

Schritte zur Veröffentlichung

Schritt 1: Manifest aktualisieren

Setze distribution_type in deiner stripe-app.json auf public:

{
  "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 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:

# 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.

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:

{
  "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": "Subscribe to Stripe events for real-time Brevo sync"
    },
    {
      "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:

stripe apps upload

Anforderungen an das Listing

Dein App-Listing muss alle folgenden Felder enthalten:

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 tatsächlichen 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 in Echtzeit, 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

# 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: [email protected]
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