Pour publier votre application sur le Stripe App Marketplace

Découvrez comment faire approuver votre application sur Stripe App Marketplace.

Utilisez ce guide si vous êtes l’auteur d’une application et souhaitez la rendre publique. Si votre application doit uniquement être disponible pour les membres de votre équipe, découvrez comment charger et installer votre application. Ce guide explique comment accéder au Stripe App Marketplace et comment effectuer le processus de révision des applications pour vérifier que votre application répond aux normes des applications Stripe. Si vous ne souhaitez installer votre application que sur un petit nombre de comptes, consultez la page consacrée aux tests externes.

Exigences et restrictions

Vous devez activer votre compte.
Vous ne pouvez publier qu’une seule application par compte.
Stripe peut uniquement prendre en charge les référencements en anglais.
Contactez Stripe si vous devez supprimer votre application du Stripe App Marketplace.
Votre objectif commercial ne peut pas figurer dans la liste des activités soumises à restriction et interdites de Stripe.

Étapes à suivre pour publier votre application

Mettez à jour votre manifeste
Préparer votre application
Rédiger votre annonce
Submit your app for review (then wait 4 business days)
Publish your app

Nous pouvons vous envoyer un e-mail pour vous demander de modifier votre annonce avant que vous puissiez la publier. Vous devez également soumettre à nouveau et passer à nouveau la vérification si vous apportez des modifications à votre application ou référencement.

Mettre à jour votre manifeste

Définir le type de distribution

Command Line
stripe apps set distribution public

Ceci met à jour votre manifeste :

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

Ajouter les autorisations requises

Ajouter des autorisations à l’aide de :

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

Charger en mode test

Command Line

stripe apps upload

Sélectionnez la version de votre application

Sélectionnez la version de votre application sur la page Applications du Dashboard.

Inclure ui_extension uniquement pour l’interface utilisateur du Dashboard Stripe

Si votre application ne nécessite pas d’interface utilisateur dans le Dashboard Stripe, laissez le champ ui_extension dans stripe-app.json vide :

Command Line
"ui_extension": []

Préparer votre application

Ensuite, créez un processus d’installation pour les installateurs sur d’autres comptes.

Si vous utilisez OAuth tiers, assurez-vous que votre application est entièrement vérifiée et approuvée par tout fournisseur tiers (par exemple, Google, Facebook, LinkedIn) que vous proposez. Si votre application n’est pas vérifiée, vous verrez généralement un message tel que « Google n’a pas vérifié cette application ». Ne demandez pas d’autorisations au-delà de ce dont vous avez besoin auprès de ces fournisseurs.
Si votre application dispose d’un bouton de paiement, acheminez les installateurs de votre application Stripe vers votre plateforme avant d’accéder à Stripe Paiement.
Si votre application comporte un composant d’interface utilisateur, assurez-vous d’utiliser l’interface utilisateur de conception Stripe
Si votre plateforme dispose d’un bouton pour la connexion OAuth à Stripe :

Utilisez le lien d’installation public pour rediriger. Vous trouverez cela dans l’onglet Paramètres (et non dans le lien d’installation du canal), et le chemin d’accès ressemble à https://marketplace.stripe.com/oauth/v2/athorize?client_id=$(clientId)&redirect_uri=$(redirect_uri)&state=$(state). La méthode d’authentification Connect Stripe étant obsolète, utilisez plutôt cette méthode OAuth.
Fournissez un moyen de vous déconnecter de Stripe, qui devient visible lorsque l’installateur connecte l’application à Stripe. Vous pouvez afficher cette option de déconnexion sur la page des paramètres de l’application ou sur une page de votre plateforme (dans la section intégration) où les utilisateurs peuvent déconnecter et réinstaller l’application. En cliquant dessus, vous devez afficher une fenêtre contextuelle avec les boutons Confirmer et Annuler, et renvoyer l’application à un état où l’utilisateur peut se reconnecter à Stripe.

Rédiger votre annonce

Le type d’application détermine la façon dont vous présentez votre référencement d’application. Les deux principaux types d’applications sont celles qui ont une interface utilisateur dans le Dashboard Stripe et celles qui n’en ont pas.

Exemples de types d’applications

Mailchimp est un exemple d’application avec une interface utilisateur dans le Dashboard Stripe. Hubspot est un exemple d’application sans interface utilisateur dans le Dashboard Stripe.

Comment rédiger une liste convaincante

La page de soumission du référencement de l’application comporte trois sections principales :

La première section énonce clairement la principale proposition de valeur de votre application et le principal problème qu’elle résout pour les utilisateurs de Stripe.
Les deuxième et troisième sections fournissent plus de détails sur les principaux cas d’usage de votre application et expliquent comment votre application répond à chacun d’eux.

Champs obligatoires

Contenu	Spécifications	Instructions	Exemple
Nom	35 caractères maximum. Ne doit pas contenir les mots ou noms suivants : « Stripe », « application », « gratuit » ou « payant ».	S’affiche à côté du logo de votre application sur la place de marché ainsi que sur la page de référencement de votre application. Doit être le même nom chargé dans `stripe-app`. Il ne peut pas contenir les mots « Stripe », « application », « RAK », « Générateur », « Clé API », « Authentificateur », « gratuit » ou « payant ».	EmailWorld
Icône logo	L’image doit être au format .PNG ou .JPG, en haute définition (au moins 300 × 300 pixels), de forme carrée (format d’image 1:1) et d’une taille inférieure à 10 Mo. Doit être le même logo que celui utilisé dans le manifeste de l’application.	S’affiche à côté du nom de votre application sur la place de marché ainsi que sur la page de référencement de votre application.
Créée par	80 caractères maximum.	Nom de la personne ou de l’organisation qui a créé l’application et en assure la maintenance.	EmailWorld, Inc.
Catégorie	Sélectionnez la catégorie qui décrit le mieux votre application.	Si Stripe estime qu’une autre catégorie est plus appropriée, nous ajusterons votre sélection et vous en informerons à l’occasion de la révision de votre application.	Assistance Ventes
Sous-titre	80 caractères maximum.	S’affiche à côté du nom de votre application sur la place de marché ainsi que sur la page de référencement de votre application. Cette phrase concise résume la valeur de votre application. Évitez le bourrage de mots-clés, le jargon marketing et l’hyperbole.	Consultez et modifiez l’historique d’assistance d’un client depuis le Dashboard Stripe.
À propos de	1 000 caractères maximum.	Veuillez décrire brièvement l’activité de votre entreprise, les clients auxquels vos produits sont destinés et l’intérêt que ces produits présentent. Une description idéale est une ou deux phrases qui présentent votre produit principal ou votre entreprise en général, suivies d’une brève description de votre application Stripe. Évitez les hyperboles, le jargon marketing, le bourrage de mots-clés ou les affirmations non vérifiables. Par exemple : « La meilleure solution d’assistance au monde. »_	EmailWorld est un service d’envoi d’e-mails destiné aux entreprises d’e-commerce en croissance. L’application EmailWorld intègre nos fonctionnalités de messagerie Avancées à Stripe pour vous permettre de toucher votre public en quelques clics.
Compatible avec	Renseigné automatiquement	Le manifeste de votre application renseigne automatiquement cet élément, ce qui permet aux utilisateurs de savoir avec quelles parties du Dashboard Stripe fonctionne votre volet des applications.	Paiements Clients
Fonctionnalités	Ajoutez jusqu’à trois fonctionnalités clés qui mettent en évidence des cas d’utilisation spécifiques de votre application.	Chaque fonctionnalité explique comment l’application interagit avec Stripe et l’améliore. Utilisez des titres clairs et axés sur la valeur et des captures d’écran de haute qualité qui n’affichent pas de données client réelles. Assurez-vous que les images sont de haute qualité et correctement rognées, et ne décrivez pas votre entreprise dans son ensemble.
Titre	80 caractères maximum.	Apparaît à côté du visuel et de la description de votre fonctionnalité clé. Voici une phrase concise résumant le cas d’usage de votre application, en langage clair.	Recevez des informations sur les e-mails envoyés aux clients Stripe.
Description	300 caractères maximum.	Une description du fonctionnement de la fonctionnalité et de ses avantages pour une personne qui l’utilise. Décrivez les limitations éventuelles. Incluez éventuellement une brève description de l’entreprise.	Affichez l’activité des e-mails, tels que les ouvertures et les clics, en relation avec vos clients Stripe. Cela vous permet d’évaluer dans quelle mesure vos campagnes génèrent des ventes sans avoir à passer d’un onglet à l’autre.
Image	Haute résolution, d’une largeur minimale de 1600 pixels (aucune hauteur minimale), en PNG ou en JPG, et ne doit pas dépasser 10 Mo.	Utilisez le kit d’outils de l’interface utilisateur Figma pour concevoir et exporter une image de fonctionnalité de haute qualité. Affichez votre application dans le Dashboard Stripe. N’utilisez pas de captures d’écran montrant des données client réelles ou des captures d’écran de votre application pendant que vous testez.
Tarifs		Indiquez aux utilisateurs si votre application est gratuite ou abonnement payant. Les tarifs doivent être indiqués sans frais cachés et conformes aux prix hors marché. N’annoncez pas votre service comme gratuit, puis demandez aux utilisateurs de payer après avoir installé l’application.	Gratuit Essai gratuit disponible Nécessite un abonnement payant
Page tarifaire	Obligatoire si votre application nécessite un abonnement payant.	Fournissez un lien vers une page qui explique votre modèle tarifaire à un utilisateur.
Canal de support	1 à 2 canaux sur lesquels les utilisateurs peuvent vous contacter.	Fournissez également une estimation du temps de réponse.	`help@helptable.com` `helptable.com/support`
Pays d’établissement		Sélectionnez chaque lieu dans lequel votre entreprise dispose d’un siège.	États-Unis
Langues prises en charge		L’anglais est présélectionné et obligatoire. Stripe prend uniquement en charge l’anglais. Si vous souhaitez prendre en charge d’autres langues, contactez Stripe.	Anglais
Politique de confidentialité		Veuillez indiquer un lien vers votre Politique de confidentialité. URL permettant aux utilisateurs de lire la politique de confidentialité de votre entreprise et de votre application.	`emailworld.com/privacy-policy`
Conditions d’utilisation du service	Optional	Veuillez fournir un lien vers vos Conditions d’utilisation du service. Fournissez un lien vers les conditions d’utilisation de votre service, à savoir l’URL d’une page où les utilisateurs peuvent lire les conditions d’utilisation de votre entreprise et de votre application.
Site internet de l’entreprise	Optional	Spécifiez un lien vers le site web de votre entreprise. Votre site Web doit clairement représenter l’objet et l’identité de votre entreprise.
Page de la FAQ	Optional	Spécifiez un lien vers la page FAQ de votre application.
Documentation technique	Optional	Fournissez un lien vers la page de documentation technique de votre application. La documentation doit tout expliquer, de l’installation de votre application Stripe à la manière de tirer le meilleur parti de ses fonctionnalités.
Autorisations	Renseigné automatiquement	Le manifeste de votre application renseigne automatiquement cette information. Il permet aux utilisateurs de savoir quelles autorisations l’application nécessite.
Points forts des fonctionnalités		Mettez en avant 1 à 3 fonctionnalités clés de votre application de sorte que les utilisateurs soient immédiatement en mesure de comprendre ce qu’elle permet de faire. Indiquez la valeur de la fonctionnalité en utilisant un langage simple dans le titre de la fonctionnalité. Par exemple, « Résoudre les tickets de Stripe ». Utilisez des visuels de haute qualité qui ne montrent pas les données réelles des clients.
Conseils pour les tests		Doit couvrir toutes les fonctionnalités clés de l’environnement de production. N’oubliez pas d’inclure le flux d’inscription. Pour accélérer la vérification de l’application, joignez des enregistrements d’écran des flux plus complexes, en annotant les liens vidéo dans la vidéo si nécessaire.	Exemple de scénario de test
Identifiants de test des comptes de test		Incluez un ou plusieurs ensembles d’identifiants de test que Stripe peut utiliser pour installer et utiliser votre application. Incluez des identifiants pour l’accès établi sur le rôle le plus élevé dans votre application. Par exemple : « administrateur ». Assurez-vous que les liens de test que vous fournissez pour la vérifier de l’application se connectent à Stripe via l’installation de l’application, et non via Connect Onboarding. Fournissez des étapes détaillées sur la façon de connecter votre application à Stripe. Désactivez l’authentification multifacteur ou fournissez des instructions aux vérifier pour qu’ils la réussissent. Si vos comptes de test ont besoin de données spécifiques pour utiliser votre application (par exemple, un fichier CSV), vous devez l’inclure avec le compte. Si votre application est spécifique à une région ou présente des restrictions géographiques, fournissez des détails sur les régions prendre en charge et fournissez des identifiants de test pour un compte Stripe avec la dernière version de votre application installée. Stripe ne vous permet pas d’utiliser des comptes réels (sans test) pour le processus de vérifier de l’application. Si vous avez besoin d’autres moyens de nous donner accès à un compte spécifique à des fins de test, contactez le service de support Stripe pour obtenir de l’aide.	Exemples d’identifiants de test

Exemple d’identifiants de test

Nom du compte de test	Nom d’utilisateur	Mot de passe
Google Sheets	`teststripeapps@stripe.com`	`teststripeapps`
Stripe	`teststripeapps@stripe.com`	`teststripeapps`

Exemple de scénario utilisateur pour une application test comme Stripe avec Google Sheets

Scénario utilisateur	Instructions étape par étape
Connexion en tant qu’utilisateur	Installez l’application depuis le Stripe App Marketplace. Ouvrez l’application. Cliquez sur le bouton Connexion. Saisissez les identifiants de test Google (fournis ci-dessous). Donnez à l’application un accès à votre compte Google. Revenez au Dashboard Stripe connecté à l’application. Après avoir effectué ces étapes, vous pouvez utiliser un service de Google Sheets dans votre application dans le Dashboard.
Exporter des données de Stripe vers Google Sheets	Accédez à la page Paiements ou Clients du Dashboard. Ouvrez l’application dans le Dashboard. Cliquez sur le bouton du tiroir d’applications pour exporter des données. Sélectionnez un dossier (facultatif). Enregistrez les données. Les données sont désormais disponibles au format CSV dans votre compte Google Drive.

Scénario utilisateur

Instructions étape par étape

Connexion en tant qu’utilisateur

Installez l’application depuis le Stripe App Marketplace.
Ouvrez l’application.
Cliquez sur le bouton Connexion.
Saisissez les identifiants de test Google (fournis ci-dessous).
Donnez à l’application un accès à votre compte Google.
Revenez au Dashboard Stripe connecté à l’application. Après avoir effectué ces étapes, vous pouvez utiliser un service de Google Sheets dans votre application dans le Dashboard.

Exporter des données de Stripe vers Google Sheets

Accédez à la page Paiements ou Clients du Dashboard.
Ouvrez l’application dans le Dashboard.
Cliquez sur le bouton du tiroir d’applications pour exporter des données.
Sélectionnez un dossier (facultatif).
Enregistrez les données. Les données sont désormais disponibles au format CSV dans votre compte Google Drive.

Submit App for review

Consultez la page Exigences de vérification des applications pour connaître les exigences de qualité des soumissions.

À titre de référence, les problèmes les plus courants que nous voyons à la révision sont les suivants :

S’il s’agit d’une nouvelle soumission avec une mise à jour de l’application, assurez-vous que vos directives de test couvrent tout ce que les nouveaux utilisateurs pourraient voir.
Vérifiez que vos autorisations dans le manifeste contiennent des descriptions complètes et des justifications détaillées pour émettre des autorisations.
Vérifiez que les liens, tels que allowed_redirect_uris dans stripe-app.json ne sont pas rompus ou que les URL d’hôte local ne sont pas rompues.
Vérifiez la qualité de l’image et la conformité à l’image de marque.
Vérifiez tous les flux d’authentification et fournissez des instructions claires après l’installation :
Vérifiez que les identifiants de test sont corrects et ne nécessitent pas d’authentification à deux facteurs.
Supprimez les clés API codées en dur de l’application.
Testez les fonctionnalités dans un environnement de test et en mode production, avec différents rôles d’utilisateur.
Pour les applications OAuth : Vérifiez que vous fournissez le lien public dans l’onglet Paramètres, et non le lien d’authentification dans l’onglet Test externe.
Pour les applications avec une interface utilisateur : Vérifiez que les images des fonctionnalités clés montrent l’interface de l’application dans le Dashboard Stripe.
Pour les applications utilisant paiement : Vérifiez que les liens de paiement acheminent d’abord les utilisateurs via votre page de paiement externe, et non directement vers Stripe paiement.

Après avoir cliqué sur Envoyer dans le formulaire d’inscription, vous recevrez un e-mail sous 4 jours ouvrables contenant une approbation ou un commentaire.

Décision et publication de l'examen de l'application

Si nous rejetons votre application, vous recevez des commentaires détaillés qui vous aideront à passer la vérification lors de la prochaine soumission.

Après avoir reçu l’e-mail d’approbation, accédez à la page Applications du Dashboard Stripe. Ensuite, vous pouvez prévisualiser votre annonce en cliquant sur Vérifier et publier. Si vous souhaitez apporter d’autres modifications sans publier, cliquez sur Annuler et modifier pour modifier et soumettre à nouveau votre application pour une autre vérification.

Pour publier votre application sur le Stripe App Marketplace, cliquez sur Publier. Publier votre application signifie :

Tous les utilisateurs peuvent découvrir votre application dans le Stripe App Marketplace.
Tout utilisateur de compte Stripe peut installer et utiliser votre application.
Vous pouvez consulter les analyses de l’application dès 24 heures après sa publication.

Voir aussi

Exigences qualitatives de vérification des applications