Publier votre application sur le Stripe App Marketplace

Rendez votre application visible par tous les utilisateurs en la publiant sur le Stripe App Marketplace.

Pour partager votre application avec d’autres personnes, publiez-la sur Stripe App Marketplace. N’importe quel compte Stripe sera alors en mesure de l’installer.

La publication de votre application est soumise à certaines restrictions :

Votre compte doit être activé.
Vous ne pouvez publier qu’une seule application par compte.
Actuellement, pour publier une application sur la place de marché Stripe, vous ne pouvez pas être un compte de plateforme.
À l’heure actuelle, Stripe ne prend en charge que les référencements en anglais. Pour prendre en charge d’autres langues, contactez Stripe.
Les applications publiées doivent être soumises à un processus de vérification. Pour en savoir plus, consultez les exigences du processus d’examen des applications et les instructions de référencement des applications.
Si vous avez besoin de retirer votre application du Stripe App Marketplace ultérieurement, vous devrez contacter Stripe.

Ces restrictions s’appliquent uniquement aux applications partagées publiquement avec les utilisateurs sur le Stripe App Marketplace. Si vous souhaitez restreindre l’accès de votre application aux seuls membres de votre équipe, découvrez plutôt comment charger et installer votre application.

Avant de commencer

Si vous avez déjà installé votre application en mode production, vous devez la désinstaller pour pouvoir publier votre application.
Choisissez un compte Stripe à associer à votre application. Vous ne pouvez publier qu’une seule application par compte.
Pour découvrir comment obtenir l’approbation de votre application pour le référencement, consultez les exigences du processus d’examen des applications.

Mettre à jour le type de distribution

Définissez votre application sur distribution publique.

Command Line
stripe apps set distribution public

Cette commande met à jour le fichier manifeste avec un champ distribution_type défini sur la valeur public.

stripe-app.json
{
  "id": "com.example.app",
  "version": "1.2.3",
  "name": "Example App",
  "icon": "./example_icon_32.png",
  "distribution_type": "public"
}

Ajouter des autorisations

Pour ajouter les autorisations nécessaires à votre application :

Déterminez les objets que votre application appelle sur l’API Stripe. Si vous migrez une extension vers une application, vous devez déterminer les objets que votre extension (et non votre application) appelle sur l’API Stripe pour savoir quelles autorisations inclure.
Consultez la liste des autorisations que vous pouvez ajouter à votre manifeste d’application.
Vous pouvez ajouter une autorisation au tableau permissions du fichier de manifeste d’application stripe-app.json en utilisant la commande suivante :

Command Line
stripe apps grant permission "PERMISSION_NAME" "EXPLANATION"

Renseignez les informations de votre autorisation :

PERMISSION_NAME : nom de l’autorisation que vous souhaitez ajouter. Voir les noms d’autorisation acceptés.
EXPLANATION : explication relative à l’autorisation d’accès. Les utilisateurs voient cette explication lorsqu’ils installent votre application.

Répétez cette étape pour toutes les nouvelles autorisations que vous souhaitez ajouter à votre application.

Votre fichier du manifeste de l'application devrait ressembler à ce qui suit :

Pour supprimer une autorisation, vous pouvez aussi utiliser la CLI :

Command Line
stripe apps revoke permission "PERMISSION_NAME"

Charger en mode test

Pour charger votre application, exécutez la commande suivante dans le répertoire racine de votre projet :

Command Line

stripe apps upload

Stripe valide le manifeste de votre application, puis charge et installe votre application sur votre compte de test Stripe.

Après cette étape :

Tous les membres de l’équipe peuvent accéder à votre application en mode test sur https://dashboard.stripe.com/test/.
Votre application peut enregistrer des clés secrètes en mode test.
Vous pouvez accéder à la clé secrète de signature de votre application afin de la connecter à un back-end.

Envoyer l'application pour vérification

Chargez une nouvelle version de votre application après avoir défini le type de distribution.
Une fois votre mode de distribution choisi, Stripe l’appliquera automatiquement à toutes les versions ultérieures de votre application. Si vous souhaitez modifier le mode de distribution d’une application une fois celle-ci publiée pour tous les utilisateurs de Stripe, contactez notre service d’assistance.
Dans le Dashboard Stripe, accédez à la page Applications, puis sélectionnez votre application pour consulter sa page d’informations.
S’il existe plusieurs versions de votre application, choisissez celle que vous souhaitez publier et cliquez sur Continuer. Si vous ne pouvez pas sélectionner de version, commencez par activer votre compte.
Créez votre fiche d’application en cliquant sur Modifier la fiche et en fournissant une présentation, un descriptif des fonctionnalités, les tarifs et le service d’assistance, ainsi que des liens vers des ressources permettant aux utilisateurs d’évaluer votre application. Au fur et à mesure que vous remplissez la fiche, l’aperçu est mis à jour dans la partie droite du Dashboard.
Pour pouvoir aboutir à une vérification concluante et créer un référencement attrayant, consultez les instructions de référencement des applications.
Cliquez sur Continuer pour fournir les informations suivantes avant l’envoi définitif de votre application :
- Version : s’il existe plusieurs versions de votre application, sélectionnez et vérifiez celle que vous souhaitez soumettre à l’examen.
- URL d’installation Marketplace ; cette option est obligatoire pour les applications OAUTH et disponible de façon facultative pour les applications prenant en charge les liens d’installation. À partir de Stripe App Marketplace, les utilisateurs sont redirigés vers cette URL pour installer votre application.
  Note
  L’URL doit renvoyer vers une page permettant de lancer le processus d’inscription et d’installation de façon claire.
- Identifiants de test : si votre application nécessite une connexion, fournissez au moins un compte de test pour permettre à Stripe de tester et de vérifier votre application. Consultez l’exemple d’identifiants de test.
  Mise en garde
  Stripe ne vous permet pas d’utiliser des comptes réels (plutôt que des comptes de test) pour le processus d’examen des applications.
- Instructions pour les tests : fournissez des scénarios utilisateur pour permettre à Stripe de simuler une installation et une utilisation intentionnelles de votre application par un utilisateur. Pour maximiser vos chances de voir votre application validée, consultez les exemples d’instructions pour les tests.
- E-mails de contact : indiquez l’adresse e-mail de la personne qui recevra sera tenue au courant lors du processus de vérification de l’application et l’adresse e-mail d’une personne chargée de la résolution des incidents de sécurité.
Toutes les modifications apportées à l’application après le début du processus d’examen feront l’objet d’une période de vérification supplémentaire. Afin d’éviter les retards, assurez-vous que toutes les informations sont conformes aux exigences du processus d’examen des applications avant l’envoi définitif de votre application.
Pour lancer le processus d’examen, cliquez sur Envoyer pour vérification.
Une fois que Stripe a examiné et approuvé votre application, vous avez la possibilité de la publier sur le Stripe App Marketplace. Si vous devez y apporter des modifications, vous pouvez annuler la vérification. Stripe supprimera alors votre position dans la file de vérification.
Pour éviter tout retard, assurez-vous que toutes les informations sont exactes et conformes aux exigences de vérification des applications avant la soumission finale. Une fois que votre application est In Review, vous ne pouvez plus retirer votre demande ni la modifier. Une fois que Stripe a examiné et approuvé votre application, vous pouvez la publier sur Stripe App Marketplace.