Gérer les produits et les tarifs

Découvrez comment gérer les produits et les tarifs

Vous pouvez créer et mettre à jour vos produits et tarifs dans le Dashboard ou via l’API.

Certains cas d’usage avancés, tels que la création de tarifs variables, nécessitent l’utilisation de l’API. Utilisez l’API si vous avez un grand nombre de produits et de tarifs ou si vous développez une intégration personnalisée avec Elements.

Utilisez le Dashboard pour créer et gérer les produits et les tarifs sans passer par l’écriture de code ou si vous n’avez que quelques produits et tarifs à gérer. Configurez votre modèle tarifaire dans un environnement de test et cliquez sur le bouton Copier en mode production sur la page d’informations du produit.
Utilisez l’API ou l’interface de commande Stripe pour créer et gérer les produits et les tarifs. L’API est une méthode directe pour vos implémentations de production. L’interface de commande Stripe est un outil de développement qui vous permet de développer, tester et gérer votre intégration avec Stripe directement depuis votre terminal.

Les étapes API suivantes utilisent comme exemple un outil de collaboration SaaS fictif (Togethere), dont le produit de base est un tableau de bord de gestion de projet.

Créer un produit

Créer un produit et un tarif

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. Elle apparaît au moment du paiement, sur le portail client et sous forme de devis.
(Facultatif) Ajoutez une Image de votre produit. Utilisez un fichier JPEG, PNG ou WEBP d’une taille inférieure à 2 Mo. L’image apparaît au moment du paiement.
(Facultatif) Si vous utilisez Stripe Tax, sélectionnez un Code de taxe pour votre produit. Consultez la section Codes de taxe pour plus d’informations sur la catégorie appropriée pour votre produit.
(Facultatif) Saisissez un Libellé de relevé bancaire. Ce libellé remplace tout libellé de compte pour les paiements récurrents. Choisissez un élément que vos clients reconnaîtront sur leur relevé bancaire.
(Facultatif) Saisissez un Libellé d’unité. Précise comment vous vendez vos produits. Par exemple, si vous facturez le prix par place, saisissez « place » pour que le poste indique « par place » pour le prix. Les libellés d’unité sont visibles au moment du règlement, sur les factures, les reçus et sur le portail client.

Créer un tarif pour le produit

Pour enregistrer un produit dans le Dashboard, vous devez également lui associer au moins un tarif.

L’éditeur de produits affiche le modèle de tarification forfaitaire par défaut. Vous pouvez créer plusieurs tarifs ou utiliser un modèle tarifaire différent à l’aide des options tarifaires avancées.

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 vendez des biens ou services dans 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. Les clients ne voient pas cette description.
(Facultatif) Cliquez sur Options tarifaires avancées si vous souhaitez créer plusieurs tarifs pour votre produit.
Cliquez sur Ajouter un produit pour enregistrer le produit et le tarif. Vous pourrez modifier les deux ultérieurement.

Modifier un produit

Pour modifier un produit dans le Dashboard :

Accédez à Plus > Catalogue de produits.
Localisez le produit voulu, cliquez sur le menu de débordement () et choisissez Modifier le produit.
Apportez les modifications voulues à votre produit.
Cliquez sur Enregistrer le produit.

Vous pouvez également modifier un produit depuis sa page d’informations en utilisant le menu de débordement () ou en cliquant sur Modifier.

Archiver un produit

Si vous souhaitez désactiver un produit de sorte qu’il ne puisse plus être ajouté à de nouvelles factures ou à de nouveaux abonnements, vous pouvez l’archiver. Lorsque vous archivez un produit, tous les abonnements existants qui utilisent ce produit restent actifs jusqu’à ce qu’ils soient annulés et tous les liens de paiement existants qui utilisent le produit sont désactivés. Vous ne pouvez pas supprimer des produits qui possèdent un tarif associé, mais vous pouvez les archiver.

Pour archiver un produit :

Accédez à Plus > Catalogue de produits.
Localisez le produit voulu, cliquez sur le menu de débordement () et choisissez Archiver le produit.

Pour désarchiver un produit :

Accédez à l’onglet Archivé de la page Catalogue de produits>Aperçu.
Localisez le produit voulu, cliquez sur le menu de débordement () et choisissez Annuler l’archivage du produit.

Vous pouvez également désarchiver un produit depuis sa page d’informations.

Supprimer un produit

Vous ne pouvez supprimer que des produits auxquels aucun tarif n’est associé. Vous pouvez également archiver un produit.

Lorsqu’un produit est associé à un tarif, vous devez au préalable supprimer ou archiver le tarif si vous souhaitez supprimer le produit. Vous pouvez également archiver un produit. Stripe conserve un registre du tarif et du produit dans l’historique des transactions.

Pour supprimer définitivement un produit :

Accédez à Plus > Catalogue de produits.
Localisez le produit voulu, cliquez sur le menu de débordement () et choisissez Supprimer le produit.

Créer un tarif

Vous pouvez créer un ou plusieurs tarifs pour un produit. Par exemple, Togethere peut proposer un abonnement « de base » à 10 USD par mois, 100 USD par an, ou encore un achat unique d’un montant de 9 EUR.

Remarque

Une fois que vous avez créé un tarif, vous pouvez uniquement mettre à jour ses champs metadata, nickname et active.

Pour créer un tarif dans le Dashboard, vous devez d’abord créer un produit. Ensuite, vous pouvez créer un tarif :

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 vendez des biens ou services dans 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. Les clients ne voient pas cette description.
Cliquez sur Créer un tarif pour enregistrer le tarif. Vous pourrez le modifier ultérieurement.

Définir un tarif par défaut

Le tarif par défaut d’un produit est le tarif le plus courant que vous souhaitez proposer à vos clients. Par exemple, un produit peut avoir des tarifs différents pour des soldes saisonniers, mais son tarif par défaut est le tarif standard (hors soldes) auquel vous le vendez. Si votre produit n’a qu’un seul tarif, celui-ci sera son tarif par défaut. Le tarif par défaut est défini par un objet Price actif.

Pour remplacer le tarif par défaut de votre produit dans le Dashboard :

Accédez à Plus > Catalogue de produits.
Localisez le produit voulu, cliquez sur le menu de débordement () et choisissez Modifier le produit.
Dans la section Informations tarifaires, recherchez le tarif que vous souhaitez définir comme nouveau tarif par défaut, puis cliquez sur Définir comme tarif par défaut.
Cliquez sur Enregistrer le produit.

Pour créer un nouveau tarif et le définir comme tarif par défaut dans le Dashboard :

Accédez à Plus > Catalogue de produits.
Trouvez le produit que vous souhaitez modifier et cliquez dessus afin d’ouvrir la page d’information sur le produit.
Dans la section Tarifs, cliquez sur le bouton Ajouter un autre tarif.
Saisissez les informations tarifaires et sélectionnez Définir comme tarif par défaut. En savoir plus sur les champs disponibles lorsque vous créez un tarif.
Cliquez sur Ajouter un tarif.

Créer un tarif en série

Pour créer un tarif en ligne, transmettez price_data au lieu de price.id lorsque vous créez un paiement ponctuel ou un abonnement. Par exemple, pour qu’un client souscrive un abonnement mensuel avec un tarif en ligne :

This creates a monthly recurring price of 50 USD for the basic service offering. You can’t update or reuse inline prices after you create them. By default, prices created with price_data are effectively archived (they’re marked as active=false). You can also use price_data with Checkout Sessions, Payment Links, Invoice Items, and Subscription Schedules.

Créer des tarifs multidevises

Vous pouvez créer des tarifs multidevises dans l’API ou le Dashboard.

Pour créer un objet Price multidevise dans le Dashboard :

Accédez au Catalogue de produits et sélectionnez un produit.
Cliquez sur Modifier le produit.
Cliquez sur + Ajouter un tarif pour créer un tarif. La devise par défaut est la première devise de votre tarif. Tous vos tarifs doivent avoir la même devise par défaut.
Pour ajouter une nouvelle option de devise à votre tarif, cliquez sur + Ajouter un tarif par devise. Recherchez et sélectionnez la devise dans la liste des devises prises en charge.
- Stripe suggère un taux de change basé sur le cours des devises à 12 h 00, heure de l’Est, mais vous pouvez choisir le vôtre. Pour les devises sujettes à de fortes fluctuations, nous vous recommandons de vous accorder plus de marge.
Pour enregistrer le nouveau tarif, cliquez sur Suivant > Mettre à jour le produit.

Les bons de réduction, les codes promotionnels et les frais de livraison prennent également en charge les tarifs multidevises, au même titre que les tarifs.

Afficher des tarifs multidevises

Pour que votre client voie le tarif dans la devise souhaitée, vous pouvez récupérer le tarif multidevise et afficher le champ currency_options.<currency>.unit_amount. La réponse de l’API ne comportera pas currency_options par défaut. Pour l’inclure dans la réponse, développez le champ currency_options :

Remarque

Pour améliorer la latence et éviter les problèmes de limitation du débit, mettez le tarif en cache au lieu de le récupérer à chaque fois qu’un client visite votre site.

Utiliser des tarifs multidevises

Chaque achat utilise l’une des devises prises en charge par l’objet Price, en fonction de la manière dont vous utilisez celui-ci dans votre intégration.

Checkout détermine automatiquement la devise locale du client à partir de son adresse IP, à condition que le tarif prenne en charge cette devise. Si la devise locale du client n’est pas prise en charge, Checkout utilise la devise par défaut pour le tarif.

Si une session Checkout utilise plusieurs tarifs, bons de réduction, codes de promotion ou frais de livraison, ils doivent tous prendre en charge la devise locale du client, faute de quoi la session Checkout utilise la devise par défaut. Ils doivent tous avoir la même devise par défaut, faute de quoi Stripe renvoie une erreur lorsque vous créez la session Checkout.

Vous avez également la possibilité d’exploiter le paramètre currency pour indiquer explicitement à Checkout la devise à utiliser.

Pour en savoir plus, consultez la page concernant la configuration de tarifs de devises saisis manuellement dans Checkout.

Passer d’un tarif à une seule devise à un tarif multidevises

Si vous disposez déjà d’un tarif dans une devise, vous pouvez lui ajouter rétroactivement plusieurs devises dans le Dashboard.

Si vous utilisez Checkout ou Payment Links, les tarifs multidevises prennent effet automatiquement. Si Stripe détecte que le tarif prend en charge la devise locale du client, elle utilise automatiquement cette devise. Si vous utilisez plusieurs tarifs, bons de réduction, codes promotionnels ou frais de livraison dans le cadre d’un même achat, ils doivent tous prendre en charge la devise locale du client, et avoir la même devise par défaut.

Si vous créez directement des abonnements, les tarifs multidevises ne prennent effet que lorsque vous commencez à transmettre le paramètre currency. Si vous ne transmettez pas le paramètre currency, l’abonnement utilise toujours la devise par défaut du tarif.

Clés de recherche

La plupart des entreprises affichent les informations relatives aux tarifs sur leur site Web. Si ces tarifs sont codés en dur et que vous voulez les modifier, le processus est souvent manuel et requiert le déploiement d’un nouveau code. Afin de mieux gérer ces cas de figure, vous pouvez appliquer l’attribut lookup_key à l’objet Price. La clé de recherche vous permet d’effectuer les opérations suivantes :

Présenter des tarifs différents dans votre front-end.
Utiliser le tarif obtenu pour facturer les clients.

Vous pouvez transmettre un attribut lookup_key lorsque vous créez un tarif :

Au lieu de coder en dur un texte de type 10 USD par mois sur votre page des tarifs et d’utiliser un ID de tarif sur votre back-end, vous pouvez interroger le tarif à l’aide de la clé standard_monthly, puis l’afficher dans votre front-end :

Remarque

Afin d’améliorer les performances, vous pouvez ajouter un niveau de cache pour ne recharger le tarif que de temps en temps.

Lorsqu’un client clique sur le bouton d’inscription ou de paiement, vous transmettez le tarif de la requête GET ci-dessus à l’API Subscriptions.

Maintenant que vous pouvez présenter des tarifs différents, imaginons que vous vouliez commencer à facturer aux nouveaux utilisateurs la somme de 20 USD par mois au lieu de 10 USD. Pour ce faire, il vous suffit de créer un nouveau tarif et de transférer la clé de recherche à ce nouveau tarif en utilisant transfer_lookup_key=true :

Arrondis

Les arrondis sont effectués au niveau du poste de vos factures. Par exemple, si vous créez un tarif avec unit_amount_decimal = 0.05 et un abonnement mensuel pour ce [tarif] avec quantity = 30, les arrondis sont effectués après que la quantité est multipliée par le montant avec décimale. Dans ce cas, le montant calculé pour le poste serait de 0.05 * 30 = 1.5, montant qui est ensuite arrondi à 2 centimes. Si vous avez plusieurs postes, chacun sera arrondi avant de calculer le montant total de la facture. Cela garantit que les clients sont toujours débités d’un montant en sous-unités entier, puisque les montants avec décimale s’appliquent uniquement pour la tarification.

Les taxes hors taxes sont ajoutées au montant de chaque poste, en fonction du taux de taxe. Si vous activez les taxes automatiques, les taxes hors taxes sont appliquées et arrondies sur le total de la facture, y compris sur les réductions au niveau de la facture. Si vous utilisez les taxes manuelles, que ce soit au niveau du poste ou de la facture, vous pouvez choisir la manière d’appliquer l’arrondi. Utilisez la page des paramètres de facturation dans le Dashboard pour appliquer et arrondir les taxes pour chaque poste, ou appliquez et arrondissez les taxes sur le sous-total de la facture.

Modifier un tarif

Vous avez la possibilité d’utiliser le Dashboard ou l’API pour mettre à jour certaines propriétés d’un tarif. Par exemple, vous pouvez choisir si le tarif est actif ou non, ou bien modifier ses métadonnées.

Notez que vous ne pouvez pas modifier le montant d’un tarif dans l’API. À la place, nous vous recommandons de créer un tarif pour le nouveau montant, de basculer sur l’ID du nouveau tarif, puis de rendre inactif l’ancien tarif.

Pour modifier un tarif dans le Dashboard :

Accédez à Plus > Catalogue de produits.
Recherchez le produit correspondant au tarif que vous souhaitez modifier et cliquez dessus.
Localisez le tarif voulu, cliquez sur le menu de débordement () et choisissez Modifier le tarif.
Modifiez votre tarif comme vous l’entendez. Vous pouvez au besoin ajouter un autre tarif à ce stade.
Cliquez sur Enregistrer.

Archiver un tarif

Si vous souhaitez désactiver un tarif de sorte qu’il ne puisse plus être ajouté à de nouvelles factures ou à de nouveaux abonnements, vous pouvez l’archiver. Lorsque vous archivez un tarif, tous les abonnements existants qui utilisent ce tarif restent actifs jusqu’à ce qu’ils soient annulés et tous les liens de paiement existants qui utilisent le produit sont désactivés.

Pour archiver un tarif à l’aide du Dashboard :

Accédez à Plus > Catalogue de produits.
Localisez le produit que vous souhaitez modifier, puis cliquez sur le menu de débordement ().
Sur la page d’informations du produit, localisez le tarif voulu, puis cliquez sur son menu de débordement () et choisissez Archiver le tarif.

Pour désarchiver un tarif :

Accédez à Plus > Catalogue de produits.
Localisez le produit que vous souhaitez modifier, puis cliquez sur le menu de débordement ().
Sur la page d’informations du produit, localisez le tarif voulu, puis cliquez sur son menu de débordement () et choisissez Annuler l’archivage du tarif.

Supprimer un tarif

Vous ne pouvez supprimer que des tarifs que vous n’avez jamais utilisés. Sinon, vous pouvez les archiver.

Pour supprimer de manière définitive un tarif du Dashboard :

Accédez à Plus > Catalogue de produits.
Localisez le produit que vous souhaitez modifier, puis cliquez sur le menu de débordement ().
Sur la page d’informations du produit, localisez le tarif voulu, puis cliquez sur son menu de débordement () et choisissez Supprimer le tarif.

Afficher les informations tarifaires

Une fois vos produits et tarifs créés, vous pouvez intégrer une grille tarifaire à votre site Web pour présenter les tarifs à vos clients. Lorsque vos clients choisissent une option d’abonnement, ils sont directement redirigés vers la page de paiement. Configurez, personnalisez et modifiez directement votre grille via le Dashboard sans avoir à écrire la moindre ligne code.

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.

Supprimer les tarifs importés

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_amount_decimal 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_amount.

Mettez à jour l’ancien tarif pour le marquer comme active=false.

Utiliser des produits et des tarifs dans votre intégration

Vous pouvez utiliser des produits et des tarifs dans plusieurs chemins d’intégration Stripe différents.

Spécifiez l’ID de tarif lorsque vous créez une session Checkout.

Si vous utilisez des tarifs ponctuels, découvrez comment créer une session Checkout lorsqu’un paiement est accepté.
Si vous créez des objets Subscription, découvrez comment créer une session Checkout lors de la création d’une intégration d’abonnements.

Tests

Vous pouvez copier des produits d’un environnement de test vers le mode production pour éviter d’avoir à les recréer. Les tarifs associés aux produits sont également copiés. Sur la page d’informations du 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.