Gestion des différents modesBêta

Comment adapter votre application pour gérer à la fois le mode production et le mode 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.

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.

Note

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 plus d’informations et d’exemples sur la façon dont le mode d’installation affecte 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.