Définir le type de distribution

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 :

stripe apps grant permission "PERMISSION_NAME" "EXPLANATION"

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 nécessite un tiroir d’applications Stripe ou une interface utilisateur de page (type de fonctionnalité =ui_extension), mettez en œuvre les écrans de l’interface utilisateur et ajoutez les vues ui_extension appropriées dans le manifeste de l’application. Reportez-vous à la section Composants de l’interface utilisateur des applications Stripe.
• Si votre application est uniquement une intégration de données (type de fonctionnalité = data_integration) et ne nécessite pas d’interface utilisateur, n’incluez pas le contenu du tiroir d’applications. Laissez plutôt les vues ui_extension vides dans le fichier stripe-app.json.

"ui_extension": []

Pour en savoir plus sur le manifeste de l’application, un index de tous les champs, types et descriptions, voirRéférence du manifeste de l’application.

Erreurs courantes lors de la création du manifeste de l’application

1. Le champ manifeste de l’applicationallowed_redirect_uris ne doit pas contenir d’URL localhost ou factices. Ces entrées représentent un risque de sécurité important et peuvent permettre des redirections non autorisées. Si vous avez ajouté des URL localhost ou factices pour les tests, supprimez-les avant de télécharger votre application.
2. Le nom de l’application doit être le même pour la liste de l’application et le fichier manifeste de l’application.
3. Assurez-vous d’inclure le chemin de l’image du logo de l’application dans le manifeste de l’application. Le logo spécifié dans le manifeste doit correspondre au logo que vous téléchargez dans la liste des applications.
4. Mettez à jour la valeur sandbox_install_compatible à true pour permettre l’installation de l’application dans un compte en mode environnement de test Stripe. Cela vous aidera à tester toutes les fonctionnalités liées aux abonnements à l’application ou au paiement à l’aide du compte en mode environnement de test Stripe.

Charger votre application

stripe apps upload

Consultez les détails de l’application sur Dashboard Stripe > Développeurs > section Applications.

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

• Sélectionnez la méthode d’authentification API adéquate établie sur votre application et ses exigences de cas d’usage.
• 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 pour le plan d’abonnement, dirigez alors les utilisateurs depuis votre application Stripe vers votre plateforme avant de naviguer vers Stripe Checkout.
  • Par exemple : un bouton ou un lien dans la page de configuration de l’application ou dans l’interface utilisateur du tiroir d’applications, intitulé « Passer à un abonnement payant », renvoie d’abord vers votre propre site web où l’utilisateur peut obtenir des informations sur le coût et les détails de l’abonnement, puis lancer le processus de paiement.
• Si votre application comporte un composant d’interface utilisateur, assurez-vous d’utiliser l’interface utilisateur de conception Stripe
• Si vous utilisez OAuth 2.0 pour authentifier la demande de connexion avec Stripe :
  • Lorsque vous soumettez une application OAuth pour examen, vous devez utiliser le lien d’installation public pour rediriger. Vous le trouverez 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/authorize?client_id=$(clientId)&redirect_uri=$(redirect_uri)&state=$(state). Stripe a abandonné la méthode d’authentification Connect Stripe, utilisez donc cette méthode OAuth à la place.
  • URL de test externe : cette URL est uniquement destinée aux tests locaux et à des fins d’implémentation. Elle n’est pas valable pour les applications publiées. Après avoir terminé votre implémentation et vos tests, vous devez remplacer cela par l’URL d’installation publique (détaillée ci-dessous).
  • URL d’installation publique : lors de la soumission de votre formulaire d’inscription pour vérification, vous devez utiliser l’URL d’installation publique en mode live. Cette URL est inaccessible au public et application développeur tant que votre formulaire d’inscription n’est pas publié à Stripe App Marketplace. Cependant, l’équipe chargée de l’examen des applications Stripe peut accéder à cette URL et installer votre application pour l’examiner.

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

Exemple d’identifiants de test

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

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.

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.