Activer la prise en charge de l'environnement de test pour votre application publiqueVersion bêta à destination des développeurs

stripe plugin upgrade apps

Un environnement de test est un environnement isolé poure effectuer des tests. Utilisez votre environnement de test pour tester les fonctionnalités Stripe de votre compte et expérimenter sans affecter votre intégration en mode production. Les utilisateurs peuvent installer des applications dans un environnement de test pour évaluer leurs caractéristiques et fonctionnalités.

Environnements de test gérés

Un environnement de test géré est un type unique d’environnement de test que Stripe crée automatiquement dans votre compte pour prendre en charge votre application publique Stripe.

• Stripe crée automatiquement un environnement de test géré la première fois que vous chargez une application publique.

• Lorsqu’un utilisateur installe votre application dans son environnement de test, il établit une connexion à votre environnement de test géré.

• Vous pouvez déboguer et surveiller les événements à partir des installations de l’environnement de test utilisateur dans votre environnement de test géré.

• Les modifications apportées à un environnement de test géré n’affectent pas les utilisateurs qui installent votre application en mode production ou mode test.

• Vous ne pouvez pas supprimer un environnement de test géré.

Créer un environnement de test géré

Stripe crée automatiquement un environnement de test géré pour vous la première fois que vous chargez une application publique Stripe sur votre compte.

Pour les applications publiques chargées avant le 3 février 2025, Stripea crée automatiquement un environnement de test géré dans votre compte.

Activer la prise en charge de l’environnement de test pour votre application

Par défaut, les utilisateurs ne peuvent pas installer votre application publique dans un environnement de test sans travail supplémentaire.

Comme en mode test, vous pouvez activer les installations en environnement de test en actualisant le manifeste de l’application . Une fois que vous avez activé la prise en charge de l’environnement de test, soumettez votre application pour examen. La prise en charge de l’environnement de test des applications est vérifiée dans le cadre du processus d’examen des applications.

Étapes à suivre pour activer les installations en environnement de test pour votre application publique

1. Mettez à jour le manifeste de l’application pour qu’il prenne en charge les installations en environnement de test.

2. (Facultatif) Créez des hooks d’événement spécifiques à l’environnement de test à l’intérieur de votre environnement de test géré. Mettez à jour la logique côté serveur pour écouter ces nouveaux endpoints.

3. (Facultatif) Mettez à jour la logique côté serveur pour utiliser les clés d’API de votre environnement de test géré lorsque vous effectuez des appels d’API Stripe pour l’installation d’un environnement de test

4. Chargez une nouvelle version de votre application sur votre compte principal (et non dans votre environnement de test géré).

5. À partir de votre compte principal, créez un lien de test externe pour la version compatible avec les environnements de test que vous venez de télécharger.

6. Créez et ouvrez un environnement de test pour tester votre application mise à jour.

7. Dans une fenêtre de navigateur, accédez au lien de test externe que vous avez créé précédemment pour installer votre application.

8. Vérifiez que votre application fonctionne comme prévu en l’installant dans un environnement de test.

9. Soumettez votre nouvelle version pour examen par la marketplace.

Mettre à jour le manifeste de l’application

Pour prendre en charge l’installation de votre application dans un environnement de test, déclarez la prise en charge de l’environnement de test dans le manifeste de l’application à l’aide de l’attribut sandbox_install_compatible.

L’exemple de code suivant déclare la prise en charge de l’environnement de test :

{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "distribution_type": "public",
  "sandbox_install_compatible": true
}

Comprendre les connexions d’environnement de test

Lorsqu’un utilisateur installe votre application publique dans son environnement de test, une connexion est établie à votre environnement de test géré. Ce comportement diffère de celui observé lorsque votre application est installée en mode production ou mode test.

• Lorsqu’un utilisateur installe une application dans un environnement de test, une connexion est établie à votre environnement de test géré.

• Lorsqu’un utilisateur installe une application en mode production, une connexion est établie avec votre mode production et votre mode test.

• Lorsqu’un utilisateur installe une application en mode test, une connexion est établie avec votre mode test.

Événements de webhook

Si votre application écoute les événements des installations de vos utilisateurs, il existe une configuration supplémentaire pour gérer les applications installées dans des environnements de test.

• À l’intérieur de votre environnement de test géré, créez de nouveaux webhooks pour les événements en environnement de test.

• Si un utilisateur installe votre application dans un environnement de test, Stripe envoie tous les événements applicables uniquement aux endpoints de votre environnement de test géré.

• Mettez à jour votre logique côté serveur pour gérer des événements spécifiques à l’environnement de test.

Clés API

Votre environnement de test géré dispose de son propre jeu de clés API permettant d’effectuer des appels pour les installations en environnement de test. Lorsque vous répondez à des webhooks ou à des événements spécifiques à l’environnement de test, vous devez utiliser les clés de cet environnement de test géré.

Vous pouvez trouver les clés API appropriées pour les installations en environnement de test dans votre environnement de test géré.

Liens OAuth pour l’environnement de test

Les applications dans les environnements de test ne prennent actuellement pas en charge le test des applications OAuth. Si votre application utilise une clé API limitée ou l’authentification par plateforme, aucune modification n’est requise.

Tester votre application dans un environnement de test

Une fois que vous avez mis à jour votre application pour gérer les installations en environnement de test, vous pouvez tester votre application dans votre propre environnement de test.

1. Depuis votre compte principal, créez un lien de test externe pour la version activée dans l’environnement de test que vous venez de charger.

2. Créez un nouvel environnement de test pour tester votre application mise à jour, puis ouvrez-le.

3. Dans une nouvelle fenêtre de navigateur, accédez au lien de test externe que vous avez créé précédemment pour installer votre application.

4. Testez que votre application fonctionne comme prévu une fois installée dans un environnement de test.

Validation des clés d’API de l’environnement de test et du comportement du webhook

Vous pouvez utiliser Workbench pour vérifier que l’installation de votre environnement de test fonctionne correctement.

• À l’intérieur de votre environnement de test, effectuez quelques exemples d’actions.

• Ensuite, à l’intérieur de votre environnement de test géré, ouvrez Workbench.

Utilisez Workbench pour inspecter le comportement de votre application, notamment pour consulter les logs API et filtrer les événements. Si vous avez correctement mis à jour votre application, vous pouvez voir tous les appels d’API et les événements de webhook pour vos exemples d’actions.

Si les événements ou les réponses attendus ne s’affichent pas, vérifiez que vous êtes bien dans votre environnement de test géré. Vérifiez également que vous avez configuré les endpoints de webhook spécifiques à l’environnement de test et que votre application utilise les clés d’API appropriées pour cet environnement.

Envoyer votre application pour vérification

Une fois que vous avez activé la prise en charge de l’environnement de test et que vous avez validé que votre application fonctionne comme prévu dans cet environnement, vous pouvez soumettre votre application pour examen. La prise en charge de l’environnement de test des applications est vérifiée dans le cadre du processus d’examen des applications et répertoriée sur la page d’informations de votre liste d’applications.