Migrer une extension vers les applications Stripe

Les extensions sont d’anciennes applications créées sur Stripe auxquelles les utilisateurs peuvent accéder dans le répertoire des partenaires. Elles utilisent des requêtes OAuth et des requêtes à l’API pour intégrer les données de paiement à d’autres outils professionnels, 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. Stripe redirigera les utilisateurs depuis le répertoire des partenaires vers Stripe App Marketplace où ils pourront découvrir les applications.

À compter du 24 mai 2022, vous ne pourrez plus créer de nouvelles extensions. Le 31 août 2022, Stripe supprimera toute mention des extensions du répertoire des partenaires. Si vous possédez une extension, effectuez la migration vers Stripe Apps dès maintenant pour garantir sa visibilité.

Pourquoi migrer

Les applications Stripe sont une mise à niveau des extensions actuelles. La migration vous permet de bénéficier des 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)
• 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 extension vers une application Stripe, elle continuera à fonctionner normalement, sans impacter l’utilisateur jusqu’en 2024. Nous continuerons à prendre en charge les extensions dans notre back-end jusqu’à fin 2024. Cependant, les nouveaux utilisateurs n’auront plus accès aux extensions dans le répertoire des partenaires à compter du 31 août 2022.

Stripe Apps et extensions

Une application peut faire tout ce qu’une extension fait, avec deux nouveautés clés :

1. Fonctionnalités interactives, à l’aide de composants d’interface utilisateur intégrés au Dashboard Stripe
2. Des autorisations plus granulaires pour permettre à vos utilisateurs de comprendre les autorisations d’accès d’une application.

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.

Impact sur les utilisateurs de votre extension

Après la migration de votre extension, vos utilisateurs existants verront un badge sur leur page de paramètres de l’extension les invitant à s’authentifier à nouveau. Vos utilisateurs doivent accepter les autorisations avant de commencer à utiliser votre application migrée. S’ils choisissent de ne pas les accepter, ils peuvent continuer à utiliser leur extension sans interruption jusqu’à 2024.

La migration vous permet de conserver le code de votre extension existante sur le compte Stripe que vous utilisez déjà. Vous ne pouvez pas avoir à la fois une extension existante et une application Stripe sur le même compte Stripe. Si vous choisissez la d’effectuer la migration, vous devez migrer en utilisant le compte Stripe lié à votre extension. L’utilisation du même compte Stripe permet également d’assurer la continuité de l’expérience utilisateur : les utilisateurs n’ont qu’à accepter une invite dans le Dashboard de Stripe pour basculer d’une extension à votre nouvelle application.

Si vous ne souhaitez pas migrer votre extension, mais que vous souhaitez quand même créer une application, vous serez confronté à plusieurs restrictions :

• Vous devez créer un autre compte Stripe pour publier l’application.
• L’application doit avoir un objectif unique et différent du service de votre extension existante.

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

• Pour protéger les utilisateurs de votre extension durant le développement de votre application Stripe, testez et chargez votre application avec un compte Stripe distinct ou nouveau afin d’isoler complètement les utilisateurs de l’application de ceux de votre extension.
• 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.
• Une fois que vous avez entièrement testé votre application Stripe, chargez-la sur le compte Stripe lié à votre extension pour soumettre votre application au processus de vérification.

{
  "id": "evt_4N3D3hQkJAnM4L",
  "livemode": true,
  "object": "event",
  "type": "account.application.authorized",
  "account": "acct_rGBIT3k8JRrYwV",
  "pending_webhooks": 2,
  "created": 1349654313,
  "data": {...}
}

Ajouter des autorisations et charger votre application

Ajoutez des autorisations au manifeste de votre application et chargez votre application. Les administrateurs de vos comptes connectés doivent accepter ces autorisations pour migrer vers votre application.

Avertissement

Le modèle d’autorisations pour les applications Stripe remplacera les autorisations globales que les utilisateurs devaient précédemment accepter pour autoriser une extension. Pour vous assurer que vos utilisateurs existants ne subissent pas d’interruptions liées aux autorisations, vous devez identifier les objets que votre extension (et non votre application) appelle sur l’API Stripe pour savoir quelles autorisations ajouter à votre application.

Le processus de migration entre l’administrateur de votre compte connecté, Stripe et votre extension se déroule comme suit :

Une fois que votre application a passé le processus d’examen et que vous l’avez publiée, les utilisateurs de votre extension doivent accepter des autorisations dans les paramètres de leur Dashboard pour consulter et utiliser l’application migrée. Si vous ajoutez des extensions d’interface utilisateur, vos utilisateurs seront redirigés vers le Stripe App Marketplace (et non vers le Dashboard) pour accepter les modifications.