# Migrer une extension Connect vers Stripe Apps Découvrez pourquoi et comment migrer vos extensions Connect vers Stripe Apps. Les [extensions Connect](https://docs.stripe.com/building-extensions.md) sont des intégrations existantes qui reposent sur Stripe Connect. Elles importent des données Stripe via OAuth et des requêtes API dans d’autres outils professionnels, comme des dashboards d’analyse ou des data warehouses. [Stripe Apps](https://stripe.com/apps) a remplacé les extensions Connect comme méthode privilégiée pour intégrer Stripe à d’autres outils à partir de 2022. Il n’est plus possible de créer de nouvelles extensions Connect. Toute mention des extensions Connect existantes a été supprimée du [répertoire des partenaires Stripe](https://stripe.partners/). Si vous êtes propriétaire d’une extension Connect existante, migrez dès maintenant vers Stripe Apps pour garantir votre visibilité sur [Stripe App Marketplace](https://marketplace.stripe.com/). ## Pourquoi migrer Stripe Apps constitue une amélioration par rapport aux extensions Connect existantes. La migration vous apporte les avantages suivants : - Un meilleur référencement et une visibilité renforcée dans le Dashboard Stripe et le Stripe App Marketplace - Des autorisations plus granulaires, afin que vous puissiez définir (et que vos utilisateurs puissent comprendre) les données et API auxquelles une application peut accéder. - Fonctionnalités interactives, avec des composants d’interface utilisateur intégrés au Dashboard Stripe (afin que les utilisateurs puissent interagir directement avec votre application, sans quitter Stripe) - Aucune interruption pour vos utilisateurs d’extensions Connect existantes s’ils choisissent de migrer ### Que se passe-t-il si vous n’effectuez pas la migration Si vous choisissez de ne pas migrer votre extension Connect existante vers une *application Stripe* (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), votre extension Connect continuera pour l’instant de fonctionner comme aujourd’hui. Les extensions Connect existantes sont officiellement obsolètes, leur prise en charge continue n’est pas garantie et les nouvelles fonctionnalités ne sont pas disponibles pour ces extensions. De plus, les nouveaux utilisateurs ne peuvent pas découvrir les extensions Connect existantes via le [répertoire des partenaires](https://stripe.partners). Nous vous recommandons de migrer votre extension Connect existante vers une *application Stripe* (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) dès que possible. ## Stripe Apps vs. extensions Connect Une application peut faire tout ce que fait une extension Connect et propose également deux fonctionnalités supplémentaires : 1. Fonctionnalité interactive, utilisant des composants d’interface utilisateur intégrés dans le Dashboard Stripe. 2. Des autorisations plus granulaires pour permettre à vos utilisateurs de comprendre les données auxquelles une application peut accéder. L’autre différence est que tous les utilisateurs peuvent découvrir des applications depuis le Stripe App Marketplace au lieu du répertoire de partenaires. | Extensions Connect | Applications Stripe | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | N’importe quel utilisateur Stripe peut utiliser votre extension Connect. | Tous les utilisateurs de Stripe peuvent installer votre application. | | Non accessible dans le [répertoire des partenaires Stripe](https://stripe.partners) ou [Stripe App Marketplace](https://marketplace.stripe.com). | Accessible dans [Stripe App Marketplace](https://marketplace.stripe.com) et le Dashboard Stripe. | | Vous pouvez retrouver vos extensions Connect existantes dans le Dashboard, sous **Developers** > **Extensions**. | Vos applications se trouvent dans le Dashboard, dans la section **Développeurs** > **[Applications](https://dashboard.stripe.com/apps)**. | | Les extensions Connect sont limitées à des autorisations en lecture seule ou en écriture seule. Les autorisations granulaires ne sont pas prises en charge. | Vous pouvez demander un ensemble d’autorisations granulaires aux utilisateurs au moment de l’installation d’une application, ce qui augmente la sécurité et la confiance des utilisateurs. | | Il n’est pas possible de créer de nouvelles extensions Connect. | Tout développeur peut s’appuyer sur la plateforme d’applications de Stripe. | | Après que les utilisateurs ont connecté leurs comptes Stripe à votre extension Connect via OAuth, vous pouvez effectuer des requêtes API en leur nom. | Choisissez parmi [plusieurs types d’autorisation](https://docs.stripe.com/stripe-apps/api-authentication.md) pour prendre en charge l’inscription de vos utilisateurs et le flux de demande d’API. | | Les utilisateurs interagissent avec votre extension Connect existante en installant des outils supplémentaires et en quittant Stripe. | Les utilisateurs peuvent interagir avec votre application directement dans le Dashboard Stripe. | | Il est impossible d’étendre l’interface utilisateur de Stripe. | Vous pouvez développer votre application directement dans le Dashboard Stripe. | ## Impact sur les utilisateurs de votre extension Connect Lorsque vous chargez et publiez une application Stripe sur le compte propriétaire de l’extension Connect existante, le processus de migration est activé pour les utilisateurs de votre extension Connect qui souhaitent passer à votre application Stripe. Ce processus ne perturbe pas les utilisateurs existants de l’extension Connect. Après avoir migré votre extension Connect vers une application Stripe, vos utilisateurs existants verront un badge sur leur page de [paramètres de l’extension](https://dashboard.stripe.com/test/extensions) les invitant à approuver une nouvelle fois les autorisations pour votre application. Vos utilisateurs doivent accepter ces autorisations pour commencer à utiliser votre application migrée. Les administrateurs des comptes Stripe de vos utilisateurs verront les éléments suivants : ![Exemple d'autorisations d'applications migrées](https://b.stripecdn.com/docs-statics-srv/assets/migrated-app-permissions-diagram.8ed2661a5c4c75477ccd9aa77f02cd13.png) Pour assurer une migration fluide à vos utilisateurs, migrez votre extension Connect vers une application en téléchargeant l’application sur votre compte existant. Si vous ne souhaitez pas inviter vos utilisateurs existants à migrer, vous devez télécharger et publier votre application Stripe sur un compte Stripe distinct. Il n’est pas possible d’avoir à la fois une extension Connect existante et une application Stripe indépendante sur le même compte Stripe. ## Migrer vers les applications Stripe Suivez les étapes ci-dessous pour migrer votre extension Connect vers une application Stripe. ![Étapes pour migrer une extension Connect vers une application Stripe](https://b.stripecdn.com/docs-statics-srv/assets/migrate_to_stripe_app_diagram.a741f6bfbd91e5840e123d581733bca9.png) Migration d’une extension Connect vers une application Stripe ## Before you begin - Pendant que vous développez votre application Stripe, nous vous recommandons de la [tester](https://docs.stripe.com/stripe-apps/test-app.md) et de la charger sur un compte Stripe distinct ou nouveau. Vous devez utiliser un ID différent pour votre application dans le compte de test, car les ID d’application sont globalement uniques (par exemple `"id": "com.example.myapp"` et `"id": "com.example.myapp.test"`). - Pour ajouter une couche de sécurité supplémentaire, créez une instance de test distincte de votre back-end. Lors des tests de votre application Stripe, évitez de modifier le code du back-end qui alimente votre extension Connect en mode production. - Après avoir testé votre application Stripe, téléchargez l’application (avec l’identifiant d’application final souhaité) sur le compte Stripe sur lequel se trouve votre extension Connect, puis [publiez votre application](https://docs.stripe.com/stripe-apps/publish-app.md). ## Créer un manifeste de l'application [Créez un manifeste d’application en créant une application Stripe](https://docs.stripe.com/stripe-apps/create-app.md). ## Optional: Ajouter une fonctionnalité interactive Si vous le souhaitez, vous pouvez ajouter des fonctionnalités interactives au Dashboard Stripe avec des composants d’interface utilisateur : 1. [Créer des composants d’interface utilisateur dans votre application Stripe](https://docs.stripe.com/stripe-apps/build-ui.md). 2. [Développez un back-end auto-hébergé et authentifiez des utilisateurs à votre back-end](https://docs.stripe.com/stripe-apps/build-backend.md). ## Choisir un type d'authentification Pour effectuer des appels à l’API depuis votre back-end au nom des utilisateurs qui installent votre application, vous devez choisir parmi les [types d’authentification API](https://docs.stripe.com/stripe-apps/api-authentication.md) disponibles. La plupart des extensions Connect existantes peuvent être remplacées directement par les options `platform` ou `oauth` pour leur intégration Stripe existante, avec un minimum de modifications. ## Ajouter des autorisations à votre application [Ajouter des autorisations](https://docs.stripe.com/stripe-apps/reference/permissions.md) au manifeste de votre application. Si vous avez besoin d’aide pour identifier les autorisations appropriées, après avoir [chargé votre application](https://docs.stripe.com/stripe-apps/upload-install-app.md), vous pouvez utiliser l’outil de migration des autorisations sur la page Informations sur l’application pour afficher les autorisations manquantes recommandées. L’outil examine les requêtes récentes sur votre compte et analyse les autorisations nécessaires pour votre application. Vous trouverez l’outil de migration en accédant à votre application sur la page Informations sur l’application du [Dashboard](https://dashboard.stripe.com/apps). L’outil existe à plusieurs endroits mis en évidence ci-dessous. ![Point d’entrée de l’outil de migration des autorisations pour les applications non publiées](https://b.stripecdn.com/docs-statics-srv/assets/permission_tool_entry_point_unpublished.400af30ac4fb84772931a492e8b7edbe.png) Légende et bouton pour les applications non publiées ![Point d’entrée de l’outil de migration des autorisations pour les applications publiées](https://b.stripecdn.com/docs-statics-srv/assets/permission_tool_entry_point_published.1c4da81be36b34728ab23812763573ab.png) Transféré dans l’option du menu de débordement lors de la publication de l’application > Lorsqu’un utilisateur approuve les nouvelles autorisations pour votre application Stripe, cela écrase les autorisations de lecture/écriture illimitées précédemment accordées à votre extension Connect. Pour éviter toute interruption liée aux autorisations lors de la migration de vos utilisateurs existants, vous devez inclure les autorisations nécessaires dans le manifeste de votre application avant de migrer les utilisateurs existants. ## Charger votre application Utilisez l’interface de ligne de commande pour [charger votre application](https://docs.stripe.com/stripe-apps/upload-install-app.md) sur Stripe. ## Publier votre application [Soumettez votre application pour vérification et publiez-la sur le Stripe App Marketplace](https://docs.stripe.com/stripe-apps/publish-app.md). Pour mettre toutes les chances de votre côté, suivez les conseils de Stripe ci-dessous : - [Exigences de vérification des applications](https://docs.stripe.com/stripe-apps/review-requirements.md) - [Guide de publication des applications](https://docs.stripe.com/stripe-apps/publish-app.md) > Lorsque vous fournissez des identifiants de test, assurez-vous que le compte de test a accès au flux d’installation de l’application. Votre application doit **être approuvée** lors de la vérification des applications pour pouvoir être publiée sur Stripe App Marketplace. ## Inscrire des utilisateurs Après la migration, vos utilisateurs existants doivent réautoriser les autorisations de l’application dans le Dashboard pour pouvoir utiliser votre application Stripe. Il y a deux façons d’inscrire de *nouveaux* utilisateurs à votre application Stripe : - Vous pouvez publier votre application sur Stripe App Marketplace après avoir migré votre extension Connect existante et obtenu la validation de la vérification de l’application. - Les nouveaux utilisateurs peuvent continuer à s’inscrire à votre extension Connect existante via Connect OAuth depuis votre site web. > Pour éviter d’inscrire de nouveaux utilisateurs avec OAuth après avoir terminé la migration, vous pouvez supprimer vos rappels OAuth et rediriger les nouveaux utilisateurs vers la page de votre application sur le Stripe App Marketplace en modifiant le bouton **Connexion avec Stripe** de votre site web. ## See also - [Applications Stripe](https://docs.stripe.com/stripe-apps.md) - [Exemples d’application](https://docs.stripe.com/stripe-apps/sample-apps.md)