Démarrer avec les produits et tarifs
Commencez à modéliser votre activité sur Stripe avec les produits et les tarifs.
Les produits et les tarifs sont des ressources au cœur de plusieurs intégrations Stripe, dont Checkout Sessions, Payment Links, Subscriptions et Invoices.
Tout d’abord, assurez-vous de bien comprendre les objectifs de votre projet d’intégration et prenez vos décisions de conception avant de commencer à créer l’intégration. Par exemple, si vous créez une intégration d’abonnements, consultez la page Conception d’une intégration pour en savoir plus sur les décisions de conception et les modèles tarifaires afin de savoir comment adapter Stripe à votre modèle économique.
Ensuite, décidez si vous souhaitez créer de nouveaux produits et tarifs dans Stripe, ou importer un catalogue de produits existant à partir d’un autre système dans Stripe. Créez des produits et des tarifs dans le Dashboard si votre catalogue de produits est peu fourni ou si vous ne voulez pas utiliser de code. Si votre catalogue de produits est très volumineux, utilisez l’API Products pour l’importer par programmation.
Vous êtes responsable du traitement des commandes de produits physiques ou numériques.
Plusieurs produits et tarifs
Vous pouvez créer autant de produit que nécessaire pour refléter votre catalogue de produits. Vous pouvez également créer plusieurs tarifs pour chaque produit. Plutôt que plusieurs tarifs, vous pouvez dans certains cas (cela dépend de plusieurs facteurs) avoir besoin de créer plusieurs produits. Cependant, généralement :
Créez plusieurs tarifs pour un seul produit si vous appliquez différents indices tarifaires à un même article. Par exemple, si vous proposez une grille tarifaire d’abonnements mensuels et annuels, créez un produit pour la grille, un produit pour le tarif mensuel et un produit pour le tarif annuel. Ce principe est illustré dans l’exemple de modèle tarifaire fixe Good, better, best. Si vous commercialisez le même article avec différentes devises, au lieu de créer plusieurs tarifs, créez un seul tarif multidevise.)
Vous créez plusieurs produits si les postes nécessitent une mise en service ou une exécution différente dans votre application. Dans le modèle Good, better, best, par exemple, vous allez créer différents modèles pour chaque niveau de la grille tarifaire. De la même manière, si vous avez différentes versions d’un produit, par exemple, plusieurs tailles et couleurs pour un T-shirt, vous allez créer un produit pour chaque version.
Mode test
Vous pouvez copier des produits du mode test vers le mode production pour éviter d’avoir à les recréer. Les tarifs associés aux produits sont également copiés. Dans l’affichage des informations produit du Dashboard, cliquez sur Copier en mode production dans le coin supérieur droit.
Vous ne pouvez copier les produits de test vers le mode production qu’une seule fois. Si vous effectuez des mises à jour du produit de test après la copie, le produit du mode production ne reflétera pas ces changements.
Créer des produits et des tarifs
La façon la plus simple de créer de nouveaux produits et tarifs est d’utiliser le Dashboard. Si vous souhaitez utiliser les API, consultez le guide consacré à la gestion des produits et des tarifs ; cette section décrit uniquement la procédure à effectuer dans le Dashboard.
Créer un produit
Pour créer un produit dans le Dashboard :
- Accédez à Plus > Catalogue de produits.
- Cliquez sur +Ajouter un produit.
- Indiquez le Nom de votre produit.
- (Facultatif) Ajoutez une Description. La description apparaît lors du règlement, sur le portail client et dans les devis.
- (Optional) Add an Image of your product. Use a JPEG, PNG, or WEBP file that’s smaller than 2MB. The image appears at checkout.
- (Facultatif) Si vous utilisez Stripe Tax, sélectionnez un Code de taxe pour votre produit. Pour plus d’informations sur le code approprié pour votre produit, reportez-vous à notre description des catégories de taxe disponibles.
- (Facultatif) Indiquez un Libellé de relevé bancaire. Ce libellé prévaudra sur tout libellé de compte pour les paiements récurrents. Choisissez un libellé que vos clients reconnaîtront facilement sur leur relevé bancaire.
- (Facultatif) Indiquez un Libellé d’unité reflétant la façon dont vous facturez votre produit. Par exemple, si vous facturez par utilisateur, entrez « utilisateur » pour que le poste indique « par utilisateur » pour le tarif. Les libellés d’unité s’affichent lors du paiement, sur les factures, les reçus et sur le portail client.
Pour enregistrer un produit dans le Dashboard, vous devez également lui associer au moins un tarif. Vous pouvez également créer plusieurs tarifs pour un même produit. Consultez Créer un tarif pour en savoir plus.
Créer un tarif
Pour créer un tarif dans le Dashboard, vous devez d’abord créer un produit. Vous pouvez créer plusieurs tarifs pour un même produit.
Sélectionnez un Modèle tarifaire. Pour plus de détails sur les modèles tarifaires récurrents, reportez-vous à notre guide des modèles tarifaires.
- Tarification forfaitaire : facture chaque unité au même tarif. Si vous utilisez cette option, sélectionnez Ponctuel ou Récurrent.
- Tarification forfaitaire : facture au forfait ou par groupe d’unités, par exemple 25 USD par tranche de 5 unités. Par défaut, les achats sont arrondis à l’unité supérieure, de sorte qu’un client achetant 8 unités paiera dans cet exemple 50 USD.
- Tarification progressive : utilise différents niveaux tarifaires, lesquels peuvent entraîner l’application d’un tarif différent pour certaines unités de la commande. Par exemple, vous pouvez facturer 10 USD l’unité les 100 premières unités, puis 5 USD l’unité les 50 suivantes. Si vous utilisez cette option, sélectionnez la devise du tarif et renseignez votre grille.
- Tarification au volume : facture chaque unité à un tarif identique déterminé par le nombre total d’unités vendues. Par exemple, vous pouvez facturer 10 USD l’unité pour un volume de 50 unités, et 7 USD l’unité pour 100 unités. Si vous utilisez cette option, sélectionnez la devise du tarif et renseignez votre grille.
- Tarification définie par le client : laissez le payeur décider du montant à acquitter pour votre produit, service ou cause. L’option Tarification définie par le client n’est compatible qu’avec Checkout et Payment Links.
- Tarification à l’usage : facturez vos clients en fonction de la consommation qu’ils font de votre service pendant le cycle de facturation.
(Facultatif) Si vous effectuez des ventes en plusieurs devises, cliquez sur Ajouter une autre devise pour définir le montant à facturer dans chaque devise.
Sélectionnez une Période de facturation pour établir une facturation récurrente. Si aucune des options de la liste déroulante ne vous convient, vous pouvez créer une période personnalisée.
Indiquez si vous souhaitez Inclure les taxes dans le tarif. En savoir plus sur les taxes et abonnements.
(Facultatif) Saisissez une Description du tarif. Cette description ne sera pas visible par vos clients.
- Cliquez sur Créer un tarif pour enregistrer le tarif. Vous pourrez le modifier ultérieurement.
Importer des produits et des tarifs
Si votre catalogue de produits est très volumineux, utilisez l’API Products pour l’importer par programmation. Si vous importez votre catalogue de produits dans Stripe, vous pouvez utiliser n’importe quelle source de données de départ, par exemple un système de gestion de produits ou un fichier CSV.
Utilisez l’API Products pour créer un produit dans Stripe pour chacun des produits de votre système. Pour mapper des produits dans votre système à des produits dans Stripe, affectez chaque produit que vous importez à un id unique. Pour chaque produit, utilisez l’API Prices pour ajouter le tarif correspondant. Pensez à enregistrer l’id du tarif que vous venez de créer. Vous devrez transmettre cet id lorsque vous utiliserez les produits et tarifs dans votre intégration.
Vérifiez l’importation en consultant le Dashboard ou en listant tous les produits dans l’API.
Suppression de tarifs
Pendant la phase de développement, vous devrez peut-être exécuter ce script plusieurs fois pour les tests. Si vous utilisez le même ID de produit, vous obtiendrez une erreur indiquant qu’un produit portant cet ID existe déjà. Si vous n’avez pas encore utilisé le produit, vous pouvez le supprimer à l’aide du Dashboard Stripe :
Accédez au Dashboard Produits et trouvez votre produit.
Dans la section Tarifs, cliquez sur le menu déroulant () en regard du tarif, et sélectionnez Supprimer le tarif.
Cliquez sur le menu déroulant () en haut de la page et sélectionnez Supprimer le produit.
Synchroniser les produits et les tarifs
Vous devrez probablement réaliser plusieurs imports. Vous pouvez créer un script pour tester votre import et, si vous le souhaitez, synchroniser votre source de données d’origine avec Stripe. Pour rendre votre script idempotent et résilient vis-à-vis des erreurs, vous pouvez sans risque essayer de créer le produit d’abord, puis le mettre à jour s’il existe déjà.
Pour synchroniser votre catalogue de produits avec Stripe, utilisez des webhooks ou d’autres mécanismes afin de déclencher des mises à jour de produit dans Stripe. Pour mettre à jour un produit de manière programmatique, utilisez la procédure suivante.
Tout d’abord, recherchez le tarif existant associé au produit avec l’API List all prices pour vous assurer que le tarif correspond toujours à votre source de données. Chaque produit doit avoir un seul et unique tarif actif.
Ensuite, vérifiez si le montant avec décimale a changé. Le champ unit_ affiche le montant unitaire en centimes.
Si le montant ne correspond pas, vous devez créer un nouveau tarif. Lorsque vous créez un nouveau tarif, spécifiez l’ID product du produit d’origine, la devise currency et le tarif actualisé unit_.
Enfin, mettez à jour l’ancien tarif pour le marquer comme active=false.
Utiliser des produits et des tarifs
Maintenant que vous avez des produits et des tarifs dans Stripe, vous pouvez les utiliser dans une intégration.