Migrer une extension vers les applications Stripe
Découvrez pourquoi et comment migrer vos extensions vers Stripe Apps.
Les extensions désignent d’anciennes intégrations conçues sur Stripe Connect. Grâce aux requêtes OAuth et API, elles transfèrent les données Stripe vers d’autres outils métier, comme des tableaux de bord analytiques ou des entrepôts de données.
Stripe Apps a remplacé les extensions comme moyen privilégié d’intégrer Stripe à d’autres outils à partir de 2022.
Vous ne pouvez plus créer de nouvelles extensions. Toute mention des extensions héritées a été supprimée du répertoire des partenaires Stripe. Si vous possédez une ancienne extension, migrez-la vers Stripe Apps dès maintenant pour garantir sa visibilité sur Stripe App Marketplace.
Pourquoi migrer
Stripe Apps est une mise à niveau des anciennes extensions. En effectuant la migration, vous obtenez les éléments 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)
- Expérience ininterrompue pour vos utilisateurs d’extensions qui choisissent d’effectuer la migration
Que se passe-t-il si vous n’effectuez pas la migration
Si vous choisissez de ne pas migrer votre ancienne extension vers une application Stripe, votre extension continuera de fonctionner normalement (pour l’instant). Les anciennes extensions étant officiellement obsolètes, le support continu n’est pas garanti et aucune nouvelle fonctionnalité n’est disponible pour les anciennes extensions.
De plus, les nouveaux utilisateurs ne peuvent pas découvrir les extensions héritées via le répertoire des partenaires.
Nous vous recommandons de migrer votre ancienne extension vers une application Stripe dès que possible.
Stripe Apps et extensions
Une application peut faire tout ce qu’une extension fait, avec deux nouveautés clés :
Fonctionnalité interactive, utilisant des composants d’interface utilisateur intégrés dans le Dashboard Stripe.
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 | Applications Stripe |
|---|---|
| Tous les utilisateurs de Stripe peuvent utiliser votre extension. | Tous les utilisateurs de Stripe peuvent installer votre application. |
| Non accessible dans le répertoire des partenaires Stripe ou Stripe App Marketplace. | Accessible dans Stripe App Marketplace et le Dashboard Stripe. |
| Vos extensions existantes se trouvent dans le Dashboard, dans la section Développeurs > Extensions. | Vos applications se trouvent dans le Dashboard, dans la section Développeurs > Applications. |
| Les extensions se limitent soit à toutes les autorisations de lecture, soit à toutes les autorisations d’écriture. 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. |
| Vous ne pouvez pas créer de nouvelles extensions. | Tout développeur peut s’appuyer sur la plateforme d’applications de Stripe. |
| Une fois que les utilisateurs associent leurs comptes Stripe à votre extension avec OAuth, vous pouvez effectuer des requêtes API en leur nom. | Choisissez parmi plusieurs types d’autorisation pour prendre en charge l’inscription de vos utilisateurs et le flux de demande d’API. |
| Les utilisateurs interagissent avec votre ancienne extension 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
Lorsque vous chargez et publiez une application Stripe sur le compte qui possède l’ancienne extension, cela permet au processus de migration pour les utilisateurs de votre extension de basculer vers votre application Stripe. Le processus de migration ne perturbe pas les utilisateurs existants de l’extension.
Après la migration de votre extension vers une application Stripe, vos utilisateurs existants verront un badge sur leur page de paramètres de l’extension les invitant à réautoriser les autorisations pour votre application. Vos utilisateurs doivent accepter les autorisations pour commencer à utiliser votre application migrée. Les administrateurs des comptes Stripe de vos utilisateurs verront ce qui suit :
Afin que le processus de migration soit fluide pour vos utilisateurs, migrez votre extension vers une application en chargeant l’application sur votre compte existant.
Si vous ne souhaitez pas inviter vos utilisateurs existants à effectuer la migration, vous devez charger et publier votre application Stripe sur un compte Stripe distinct. Vous ne pouvez pas avoir à la fois une extension existante et une application Stripe non liée sur le même compte Stripe.
Migrer vers les applications Stripe
Suivez les étapes ci-dessous pour migrer votre extension vers une application Stripe.
Migrer une extension vers une application Stripe
Avant de commencer
- Pendant que vous développez votre application Stripe, nous vous recommandons de la tester 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.etexample. myapp" "id": "com.).example. myapp. test" - Pour ajouter un niveau de sécurité supplémentaire, créez une instance de test distincte de votre back-end. Lorsque vous testez votre application Stripe, évitez d’apporter des modifications au code back-end qui sous-tend votre extension en mode production.
- Après avoir testé votre application Stripe, chargez-la (avec l’ID final souhaité) sur le compte Stripe qui possède votre extension, puis publiez votre application.
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 l’un des types d’authentification API disponibles. Pour la plupart des anciennes extensions, les options platform ou oauth offrent un remplacement instantané de l’intégration Stripe existante nécessitant uniquement des changements minimes.
Ajouter des autorisations à votre application
Ajouter des autorisations au manifeste de votre application.
Si vous avez besoin d’aide pour identifier les autorisations appropriées, après avoir chargé votre application, 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. L’outil existe à plusieurs endroits mis en évidence ci-dessous.
Légende et bouton pour les applications non publiées
Transféré dans l’option du menu de débordement lors de la publication de l’application
Avertissement
Lorsqu’un utilisateur autorise les nouvelles autorisations pour votre application Stripe, cela remplace les autorisations illimitées en lecture/écriture précédemment accordées à votre extension. Pour vous assurer que vos utilisateurs existants ne subissent pas d’interruptions liées aux autorisations lors de la migration, 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 sur Stripe.
Publier votre application
Soumettez votre application pour vérification et publiez-la sur le Stripe App Marketplace.
Pour mettre toutes les chances de votre côté, suivez les conseils de Stripe ci-dessous :
Remarque
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 ancienne extension et avoir effectué l’étape de vérification des applications.
- Les nouveaux utilisateurs peuvent continuer à s’inscrire sur votre ancienne extension avec Connect OAuth à partir de votre site Web.
Remarque
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.