# Umsteigen von einer Connect-Erweiterung auf Stripe App Erfahren Sie, warum und wie Sie Ihre Connect-Erweiterungen zu Stripe Apps migrieren können. [Connect-Erweiterungen](https://docs.stripe.com/building-extensions.md) sind veraltete Integrationen, die auf Stripe Connect basieren. Über OAuth und API-Anfragen übertragen sie Stripe-Daten in andere Business-Tools, wie z. B. Analyse-Dashboards oder Data-Warehouses. [Stripe Apps](https://stripe.com/apps) haben Connect-Erweiterungen seit 2022 als bevorzugte Methode zur Integration von Stripe mit anderen Tools abgelöst. Sie können keine neuen Connect-Erweiterungen mehr erstellen. Alle Erwähnungen von veralteten Connect-Erweiterungen wurden aus dem [Stripe Partner Directory](https://stripe.partners/) entfernt. Wenn Sie eine veraltete Connect-Erweiterung besitzen, migrieren Sie jetzt zu Stripe Apps, um die Auffindbarkeit im [Stripe App Marketplace](https://marketplace.stripe.com/) sicherzustellen. ## Gründe für eine Migration Stripe Apps ist ein Upgrade von veralteten Connect-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 Nutzer/innen von Connection-Erweiterungen, wenn sie sich für eine Migration entscheiden ### Was passiert, wenn Sie nicht migrieren Wenn Sie sich entscheiden, Ihre veraltete Connect-Erweiterung nicht zu einer *Stripe App* (An app that you can build on top of Stripe to customize the functionality of the Stripe Dashboard UI, leverage Stripe user data, store data on Stripe, and more) zu migrieren, funktioniert Ihre Connect-Erweiterung vorerst weiterhin wie bisher. Veraltete Connect-Erweiterungen sind offiziell nicht mehr empfohlen, ein fortlaufender Support ist nicht garantiert, und neue Funktionen stehen veralteten Connect-Erweiterungen nicht zur Verfügung. Außerdem können neue Nutzer/innen veraltete Connect-Erweiterungen nicht über das [Partner Directory](https://stripe.partners) entdecken. Wir empfehlen Ihnen, Ihre veraltete Connect-Erweiterung so schnell wie möglich zu einer *Stripe App* (An app that you can build on top of Stripe to customize the functionality of the Stripe Dashboard UI, leverage Stripe user data, store data on Stripe, and more) zu migrieren. ## Stripe Apps vs. Connect-Erweiterungen Eine App kann alles, was eine Connect-Erweiterung kann, mit zwei wesentlichen Ergänzungen: 1. Interaktive Funktionalität mithilfe von eingebetteten Komponenten der Nutzeroberfläche im Stripe-Dashboard. 1. 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. | Connect-Erweiterungen | Stripe Apps | | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Jede Stripe-Nutzerin und jeder Stripe-Nutzer kann Ihre Connect-Erweiterung verwenden. | Jede/r Stripe-Nutzer/in kann Ihre App installieren. | | Nicht im [Stripe-Partnerverzeichnis](https://stripe.partners) oder im [Stripe App Marketplace](https://marketplace.stripe.com) auffindbar. | Im [Stripe App Marketplace](https://marketplace.stripe.com) und Stripe-Dashboard auffindbar. | | Ihre bestehenden Connect-Erweiterungen finden Sie im Dashboard unter **Entwickler/innen** > **Erweiterungen**. | Ihre Anwendungen finden Sie im Dashboard im **Entwicklerbereich** > **[Apps](https://dashboard.stripe.com/apps)**. | | Connect-Erweiterungen sind entweder auf alle Lese- oder alle Schreibberechtigungen beschränkt. Detaillierte Berechtigungen werden nicht unterstützt. | Sie können im Rahmen der App-Installation eine Reihe detaillierter Berechtigungen von Nutzerinnen und Nutzern anfordern, was die Sicherheit und das Vertrauen der Nutzer/innen erhöht. | | Sie können keine neuen Connect-Erweiterungen erstellen. | Alle Entwickler/innen können auf der App-Plattform von Stripe aufbauen. | | Sobald Nutzer/innen ihr Stripe-Konto mit Ihrer Connect-Erweiterung via OAuth verknüpft haben, können Sie in ihrem Namen API-Anfragen stellen. | Wählen Sie aus [mehreren Autorisierungstypen](https://docs.stripe.com/stripe-apps/api-authentication.md), um das Onboarding Ihrer Nutzer/innen und den API-Anfrageablauf zu unterstützen. | | Nutzer/innen interagieren mit Ihrer veralteten Connect-Erweiterung, indem sie zusätzliche Tools installieren und Stripe verlassen. | Nutzer/innen interagieren direkt im Stripe-Dashboard mit Ihrer App. | | Keine Möglichkeit, die Stripe Benutzeroberfläche zu erweitern. | Sie können direkt im Stripe-Dashboard entwickeln. | ## Auswirkungen auf die Nutzer/innen Ihrer Connect-Erweiterung Wenn Sie eine Stripe App in das Konto hochladen und veröffentlichen, dem die veraltete Connect-Erweiterung gehört, wird damit der Migrationsprozess für Nutzer/innen Ihrer Connect-Erweiterung ermöglicht, damit diese zu Ihrer Stripe App wechseln können. Der Migrationsprozess beeinträchtigt bestehende Nutzer/innen der Connect-Erweiterung nicht. Nachdem Sie Ihre Connect-Erweiterung zu einer Stripe App migriert haben, wird Ihren bestehenden Nutzer/innen auf der Seite [Erweiterungseinstellungen](https://dashboard.stripe.com/test/extensions) ein Badge angezeigt, das sie auffordert, die Berechtigungen für Ihre App erneut zu autorisieren. Ihre Nutzer/innen müssen die Berechtigungen akzeptieren, um Ihre migrierte App nutzen zu können. Administratoren der Stripe-Konten Ihrer Nutzer/innen sehen Folgendes: ![Beispiel für migrierte App-Berechtigungen](https://b.stripecdn.com/docs-statics-srv/assets/migrated-app-permissions-diagram.8ed2661a5c4c75477ccd9aa77f02cd13.png) Um einen reibungslosen Migrationsprozess für Ihre Nutzer/innen zu gewährleisten, migrieren Sie Ihre Connect-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 in einem separaten Stripe-Konto hochladen und veröffentlichen. Sie können nicht gleichzeitig eine bestehende Connect-Erweiterung und eine nicht damit verbundene Stripe App im selben Stripe-Konto haben. ## Auf Stripe Apps umsteigen Führen Sie die folgenden Schritte aus, um Ihre Connect-Erweiterung in eine Stripe App zu migrieren. ![Schritte zur Migration einer Connect-Erweiterung zu einer Stripe App](https://b.stripecdn.com/docs-statics-srv/assets/migrate_to_stripe_app_diagram.a741f6bfbd91e5840e123d581733bca9.png) Connect-Erweiterung zu einer Stripe App migrieren ## Before you begin - Während Sie Ihre Stripe-App entwickeln, empfehlen wir Ihnen, Ihre App mit einem separaten oder neuen Stripe-Konto zu [testen](https://docs.stripe.com/stripe-apps/test-app.md) 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-Connect-Erweiterung. - Nachdem Sie Ihre Stripe App getestet haben, laden Sie die App (mit Ihrer endgültigen gewünschten App-ID) in dasselbe Stripe-Konto hoch, dem Ihre Connect-Erweiterung gehört, und [veröffentlichen Sie Ihre App](https://docs.stripe.com/stripe-apps/publish-app.md). ## App-Manifest erstellen [App-Manifest mit einer Stripe-App erstellen](https://docs.stripe.com/stripe-apps/create-app.md). ## Optional: Interaktive Funktionen hinzufügen Optional können Sie interaktive Funktionen im Stripe-Dashboard durch Komponenten der Nutzeroberfläche hinzufügen: 1. [UI-Komponenten in Ihre Stripe-App aufnehmen](https://docs.stripe.com/stripe-apps/build-ui.md). 1. [Erstellen Sie ein selbstgehostetes Backend und authentifizieren Sie Nutzer/innen bei Ihrem Backend](https://docs.stripe.com/stripe-apps/build-backend.md). ## Authentifizierungstyp auswählen Um API-Aufrufe von Ihrem Backend im Namen von Nutzerinnen und Nutzern durchzuführen, die Ihre App installieren, müssen Sie aus den verfügbaren [API-Authentifizierungstypen](https://docs.stripe.com/stripe-apps/api-authentication.md) auswählen. Die meisten veraltetem Connect-Erweiterungen stellen fest, dass entweder die Option `platform` oder `oauth` einen direkten Ersatz für ihre bestehende Stripe-Integration bietet, mit minimalen erforderlichen Änderungen. ## Ihrer App Berechtigungen hinzufügen [Berechtigungen](https://docs.stripe.com/stripe-apps/reference/permissions.md) zu Ihrem App-Manifest hinzufügen. Wenn Sie Hilfe beim Ermitteln der korrekten Berechtigungen benötigen, können Sie nach dem [Upload Ihrer App](https://docs.stripe.com/stripe-apps/upload-install-app.md) 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](https://dashboard.stripe.com/apps) navigieren. Das Tool ist an mehreren Stellen vorhanden, die unten hervorgehoben werden. ![Einstiegspunkt für das Migrationstool für Berechtigungen für nicht veröffentlichte Apps](https://b.stripecdn.com/docs-statics-srv/assets/permission_tool_entry_point_unpublished.400af30ac4fb84772931a492e8b7edbe.png) Hervorhebung und Schaltfläche für nicht veröffentlichte Apps ![Einstiegspunkt für das Migrationstool für Berechtigungen für veröffentlichte Apps](https://b.stripecdn.com/docs-statics-srv/assets/permission_tool_entry_point_published.1c4da81be36b34728ab23812763573ab.png) Wird in die Option des Überlaufmenüs verschoben, wenn eine App veröffentlicht wird > Wenn eine Nutzerin oder ein Nutzer die neuen Berechtigungen für Ihre Stripe App autorisiert, werden damit die zuvor Ihrer Connect-Erweiterung erteilten uneingeschränkten Lese-/Schreibberechtigungen überschrieben. Um sicherzustellen, dass Ihre bestehenden Nutzer/innen bei der Migration keine berechtigungsbedingten Unterbrechungen erleben, müssen Sie die erforderlichen Berechtigungen vor der Migration bestehender Nutzer/innen in Ihr App-Manifest aufnehmen. ## App hochladen Verwenden Sie die CLI, um [Ihre App](https://docs.stripe.com/stripe-apps/upload-install-app.md) bei Stripe hochzuladen. ## Ihre App veröffentlichen [Übermitteln Sie Ihre App zur Überprüfung und veröffentlichen Sie sie auf dem Stripe-App-Marktplatz](https://docs.stripe.com/stripe-apps/publish-app.md). Um Ihre Chancen zu erhöhen, die App-Prüfung zu bestehen, befolgen Sie die Stripe-Vorgaben: - [Anforderungen für die App-Überprüfung](https://docs.stripe.com/stripe-apps/review-requirements.md) - [App-Veröffentlichungsanleitung](https://docs.stripe.com/stripe-apps/publish-app.md) > Wenn Sie Testanmeldedaten angeben, stellen Sie sicher, dass das Testkonto Zugriff auf den Installationsablauf der App hat. Ihre App **muss die App-Überprüfung bestehen**, damit sie im Stripe App Marketplace gelistet werden kann. ## Onboarding von Nutzer/innen Nach der Migration müssen Ihre bestehenden Nutzer/innen die Berechtigungen der App im Dashboard erneut autorisieren, um Ihre Stripe-App verwenden zu können. Es gibt zwei Möglichkeiten für das Onboarding *neuer* Nutzer/innen in Ihre Stripe-App: - Sie können Ihre App im Stripe App Marketplace veröffentlichen, nachdem Sie Ihre veraltete Connect-Erweiterung migriert und die App-Überprüfung bestanden haben. - Neue Nutzer/innen können sich weiterhin über Connect OAuth von Ihrer Website aus zum Onboarding Ihrer veralteten Connect-Erweiterung einladen lassen. > Um das Onboarding neuer Nutzer/innen mit OAuth nach Abschluss der Migration zu vermeiden, können Sie Ihre OAuth-Rückrufe entfernen und neue Nutzer/innen zu Ihrer App-Liste im Stripe App Marketplace umleiten, indem Sie die Schaltfläche **Mit Stripe verbinden** Ihrer Website ändern. ## See also - [Stripe Apps](https://docs.stripe.com/stripe-apps.md) - [Beispiel-Apps](https://docs.stripe.com/stripe-apps/sample-apps.md)