Eine Erweiterung auf Stripe Apps umstellen

Erweiterungen sind ältere Integrationen, die auf Stripe Connect aufbauen. Über OAuth- und API-Anfragen übertragen sie Stripe-Daten in andere Geschäftstools wie Analyse-Dashboards oder Data Warehouses.

Stripe Apps hat Erweiterungen als bevorzugte Methode zur Integration von Stripe mit anderen Tools seit 2022 ersetzt.

Sie können keine neuen Erweiterungen mehr erstellen. Alle Erwähnungen von Legacy-Erweiterungen wurden aus dem Stripe-Partnerverzeichnis entfernt. Wenn Sie eine ältere Erweiterung besitzen, steigen Sie jetzt auf Stripe Apps um, um die Auffindbarkeit im Stripe App Marketplace sicherzustellen.

Gründe für eine Migration

Stripe Apps ist ein Upgrade gegenüber älteren Erweiterungen. Die Migration bietet folgende Vorteile:

• Bessere Auffindbarkeit mit umfassender Sichtbarkeit im Stripe-Dashboard und im Stripe App Marketplace
• Detailliertere Berechtigungen, damit Sie festlegen können (und Ihre Nutzer/innen verstehen), auf welche Daten und APIs eine App zugreifen kann
• Interaktive Funktionalität mit eingebetteten Komponenten der Nutzeroberfläche im Stripe-Dashboard (damit Nutzer/innen direkt mit Ihrer App interagieren können, ohne Stripe zu verlassen)
• Keine Unterbrechung für Ihre bestehenden Erweiterungsnutzer, wenn sie sich für eine Migration entscheiden

Was passiert, wenn Sie nicht migrieren

Wenn Sie sich dafür entscheiden, Ihre ältere Erweiterung nicht auf eine Stripe-App umzustellen, funktioniert Ihre Erweiterung vorerst weiterhin wie bisher. Ältere Erweiterungen sind offiziell eingestellt, fortlaufender Support kann nicht garantiert werden und neue Funktionen sind für ältere Erweiterungen nicht verfügbar.

Darüber hinaus können neue Nutzer/innen ältere Erweiterungen nicht über das Partnerverzeichnis finden.

Wir empfehlen Ihnen, Ihre ältere Erweiterung so schnell wie möglich auf eine Stripe-App umzustellen.

Stripe Apps und Erweiterungen

Eine App hat dieselbe Funktionsweise wie eine Erweiterung, jedoch mit zwei wichtigen Ergänzungen:

1. Interaktive Funktionalität mithilfe von eingebetteten Komponenten der Nutzeroberfläche im Stripe-Dashboard.

2. Detailliertere Berechtigungen, damit Nutzer/innen besser verstehen, auf welche Daten eine App zugreifen kann.

Der andere Unterschied ist, dass jede/r Nutzer/in Apps aus dem Stripe App Marketplace und nicht aus dem Partnerverzeichnis entdecken kann.

Auswirkungen auf die Nutzer/innen Ihrer Erweiterung

Wenn Sie eine Stripe-App in dem Konto hochladen und veröffentlichen, das die ältere Erweiterung besitzt, können Nutzer/innen Ihrer Erweiterung so zu Ihrer Stripe-App wechseln. Bestehende Nutzer/innen der Erweiterung werden von der Migration nicht unterbrochen.

Nach der Migration Ihrer Erweiterung auf eine Stripe-App sehen Ihre bestehenden Nutzer/innen auf ihrer Seite mit den Erweiterungseinstellungen ein Badge, in dem sie aufgefordert werden, die Berechtigungen für Ihre App erneut zu autorisieren. Ihre Nutzer/innen müssen Berechtigungen akzeptieren, um die migrierte App nutzen zu können. Administratorinnen und Administratoren der Stripe-Konten Ihrer Nutzer/innen wird Folgendes angezeigt:

Für einen reibungslosen Migrationsablauf für Ihre Nutzer/innen migrieren Sie Ihre Erweiterung zu einer App, indem Sie die App in Ihr bestehendes Konto hochladen.

Wenn Sie Ihre bestehenden Nutzer/innen nicht zur Migration auffordern möchten, müssen Sie Ihre Stripe-App hochladen und in einem separaten Stripe-Konto veröffentlichen. Sie können nicht sowohl eine bestehende Erweiterung als auch eine unabhängige Stripe-App auf demselben Stripe-Konto haben.

Auf Stripe Apps umsteigen

Führen Sie die folgenden Schritte aus, um Ihre Erweiterung in eine Stripe-App zu migrieren.

Eine Erweiterung auf eine Stripe-App umstellen

Bevor Sie loslegen

• Während Sie Ihre Stripe-App entwickeln, empfehlen wir Ihnen, Ihre App mit einem separaten oder neuen Stripe-Konto zu testen und hochzuladen. Sie müssen für Ihre App im Testkonto eine andere ID verwenden, da App-IDs global eindeutig sind (zum Beispiel "id": "com.example.myapp" und "id": "com.example.myapp.test").
• Für noch mehr Sicherheit erstellen Sie eine separate Testinstanz Ihres Backends. Vermeiden Sie beim Testen Ihrer Stripe-App Änderungen am Backend-Code Ihrer Live-Erweiterung.
• Nachdem Sie Ihre Stripe-App getestet haben, laden Sie diese (mit Ihrer endgültigen gewünschten App-ID) in dasselbe Stripe-Konto hoch, zu dem auch Ihre Erweiterung gehört, und veröffentlichen Sie Ihre App.

Ihrer App Berechtigungen hinzufügen

Berechtigungen zu Ihrem App-Manifest hinzufügen.

Wenn Sie Hilfe beim Ermitteln der korrekten Berechtigungen benötigen, können Sie nach dem Upload Ihrer App das Tool zur Migration von Berechtigungen auf der Seite „App-Details“ verwenden, um die empfohlenen fehlenden Berechtigungen anzuzeigen. Das Tool prüft die letzten Anfragen für Ihr Konto und analysiert die erforderlichen Berechtigungen für Ihre App.

Sie finden das Migrationstool, indem Sie zu Ihrer App auf der Seite „App-Details“ im Dashboard navigieren. Das Tool ist an mehreren Stellen vorhanden, die unten hervorgehoben werden.

Hervorhebung und Schaltfläche für nicht veröffentlichte Apps

Wird in die Option des Überlaufmenüs verschoben, wenn eine App veröffentlicht wird

Achtung

Wenn ein/e Nutzer/in die neuen Berechtigungen für Ihre Stripe-App autorisiert, werden die uneingeschränkten Lese-/Schreibberechtigungen, die zuvor Ihrer Erweiterung gewährt wurden, überschrieben. Um sicherzustellen, dass Ihre bestehenden Nutzer/innen bei der Migration nicht berechtigungsbedingte Unterbrechungen erfahren, müssen Sie vor der Migration bestehender Nutzer/innen die erforderlichen Berechtigungen in Ihr App-Manifest aufnehmen.