Gérer différents modesVersion bêta publique

Découvrez comment adapter votre application pour gérer le mode production, le mode test et un environnement de test.

Lors de l’installation, les utilisateurs peuvent choisir dans quel mode installer votre application.

L'emplacement de l'option de sélection du mode lors du flux d'installation Stripe App

Option Essayez-la en mode test

Sur l’App Marketplace, les utilisateurs potentiels voient s’afficher l’option Try in test mode pour les encourager à essayer une application.

L'emplacement de l'appel à l'action « Essayez-la en mode test » sur l'App Marketplace

Mise en garde

Si votre application utilise le type d’accès API OAuth ou une url d’installation externe, l’option Try in test mode ne s’affichera pas sur l’App Marketplace.

Raccourci pour installer l’autre mode

Si un utilisateur a un mode installé, vous pouvez installer l’autre mode directement depuis le Dashboard Stripe.

L'emplacement du bouton dans le Dashboard Stripe pour installer l'application dans l'autre mode

Webhooks

Si votre application est configurée pour écouter les événements de vos comptes d’utilisateurs installés, elle nécessite une configuration supplémentaire pour s’assurer que vous pouvez gérer l’installation de votre application en mode test (ou dans des environnements de test).

Si un utilisateur installe votre application en mode production uniquement, tous les événements applicables en mode production sont envoyés à vos endpoints de webhook en mode production. Si un utilisateur installe votre application en mode test uniquement, tous les événements applicables en mode test sont envoyés à vos endpoints de webhook en mode test. Si un utilisateur installe votre application à la fois en mode production et en mode test, les événements en mode test sont envoyés à vos endpoints de webhook en mode test et en mode production, et les événements en mode production sont envoyés uniquement à vos endpoints de webhook en mode production. Si un utilisateur installe votre application dans un environnement de test, Stripe envoie exclusivement les événements aux endpoints de webhook de l’environnement de test.

Remarque

Nous vous recommandons de configurer les endpoints de webhooks en mode production et en mode test pour vous assurer que les deux modes sont correctement pris en charge. Consultez la rubrique Comportement des événements pour en savoir plus sur l’effet du mode d’installation sur le comportement des événements.

Liens vers OAuth en mode test

Les applications OAuth lancent l’installation de l’application à partir de leur plateforme. Le développeur est responsable de la mise en place d’un lien d’installation en mode test si vous souhaitez une prise en charge en mode test. Le Dashboard Stripe fournit un lien d’installation OAuth en mode test.

L'emplacement des liens OAuth publics dans le Dashboard Stripe

La documentation Stripe Apps OAuth contient plus d’informations sur la création de liens d’installation OAuth.