Les produits sont la base de Dodo Payments. Que vous vendiez un téléchargement ponctuel, un abonnement récurrent ou un accès à la consommation, vous commencez par créer un produit. Chaque produit définit son tarif, sa présentation lors du paiement et son exécution après l’achat.
One‑Time
Facturez une seule fois pour un accès à vie ou un livrable unique.
Subscriptions
Facturez selon un calendrier avec essais, prorata et options supplémentaires.
Usage‑Based
Consommation du compteur et facture selon l’utilisation réelle.
Créer un produit
Vous pouvez créer des produits depuis le tableau de bord ou via l’API. Choisissez le modèle de tarification à l’avance : Unique, Abonnement ou Basé sur l’utilisation, puis configurez les détails. Le modèle de tarification ne peut pas être changé par la suite ; créez un nouveau produit si vous avez besoin d’un modèle différent.1
Name & description
Indiquez un titre clair et une description concise axée sur la valeur. Le Markdown est pris en charge dans les descriptions.
2
Pricing model & price
Select the pricing model:
- Unique : Prix fixe payé une fois.
- Abonnement : Prix récurrent avec intervalle et essai optionnel.
- Basé sur l’utilisation : Prix dérivé d’événements mesurés.
- Prix : Montant de base et devise. Vous pouvez définir le prix de base dans n’importe quelle devise que Dodo Payments peut facturer, et pas uniquement en USD. Utilisez le sélecteur de devises avec recherche pour trouver une devise ; USD, GBP, EUR et INR sont épinglées en haut de la liste.
- Remise (%) : Remise facultative affichée directement lors du checkout et sur les factures.
- Pour les abonnements, définissez Répéter tous les (par exemple, 1 mois ou 1 an), les jours d’essai et un montant d’essai facultatif pour un essai payant. Le prix de l’abonnement doit être d’au moins 1 $ (ou l’équivalent dans la devise choisie) ; les montants inférieurs à ce minimum ne sont pas pris en charge et l’abonnement ne fonctionnera pas.
Les clients dont la devise diffère de votre devise de base sont toujours facturés via Adaptive Currency. Vous pouvez donc créer vos prix dans la devise qui correspond le mieux à votre marché, sans modifier la manière dont les acheteurs sont facturés.
3
Product media
Importez des images pour mettre le produit en valeur lors du checkout et sur les factures. PNG/JPG/WebP pris en charge, jusqu’à 3 Mo. Réorganisez ou remplacez-les à tout moment.
4
Automated entitlements (Under Advanced Settings)
Associez un fulfillment qui s’active automatiquement après le paiement :
- Clés de licence : Émettez et validez des clés uniques
- Téléchargements de fichiers : Accordez un accès sécurisé aux fichiers
- Personnalisé : Déclenchez votre propre logique d’attribution via des webhooks
Variantes et options de tarification
Au lieu de créer des variantes sous un même produit, créez des produits distincts pour chaque option de tarification (par exemple, Mensuel et Annuel). Regroupez-les ensuite dans une Collection de produits afin de présenter toutes les options dans un checkout unique et d’activer le changement de forfait dans le Customer Portal.
Pourquoi cette approche ?
- Modèles de tarification clairs : Chaque produit possède un modèle de tarification unique et clairement défini (paiement unique, abonnement ou tarification à l’usage)
- API prévisibles : Intégrations plus simples, sans logique de variantes imbriquées
- Rapports simplifiés : Suivez les revenus et les métriques par produit, sans agrégation des variantes
- Checkout flexible : Affichez plusieurs produits côte à côte pour permettre aux clients de les comparer et de faire leur choix
Fonctionnement des Collections de produits
- Créez des produits : Configurez des produits individuels pour chaque forfait (par exemple, Starter Mensuel, Starter Annuel, Pro Mensuel, Pro Annuel)
- Regroupez-les dans une collection : Ajoutez les produits associés à une Collection de produits
- Checkout unifié : Les clients voient toutes les options dans un checkout unique et sélectionnent leur forfait préféré
- Changement de forfait : Les clients peuvent passer à un forfait supérieur ou inférieur entre les produits d’une même collection via le Customer Portal
Product Collections
Regroupez les produits associés pour proposer des expériences de checkout unifiées et des parcours fluides de changement vers un forfait supérieur ou inférieur.
Gestion des produits
Vous pouvez gérer les produits via le dashboard ou par programmation via l’API. L’API offre un contrôle complet sur la création, la mise à jour, la récupération, l’importation d’images et l’archivage des produits.Gestion via le dashboard
- Mettre à jour : Modifiez à tout moment le nom, la description, les images, le prix, les champs et les avantages (le modèle de tarification est immuable).
- Archiver : Masquez un produit des nouveaux achats sans perturber les clients existants. Vous pourrez le désarchiver ultérieurement.
- Brouillons : Un produit en cours de création est enregistré comme brouillon afin que vous puissiez y revenir plus tard. Les brouillons sont conservés séparément pour le mode test et le mode live ; un produit inachevé dans un mode ne sera donc jamais transféré dans l’autre. Utilisez Effacer le brouillon pour le supprimer et recommencer.
Gestion via l’API
Les instructions suivantes vous permettent de créer, mettre à jour, gérer et récupérer des produits, notamment en important des images.Creating a Product
Creating a Product
Un produit peut être un article à paiement unique ou un service basé sur un abonnement. Pour créer un nouveau produit, envoyez une requête
POST à l’endpoint /products avec des informations telles que le nom, la description, le prix, la devise et le caractère récurrent ou non du produit.Pour les produits récurrents, définissez l’objet price sur un prix récurrent (type: recurring_price) et indiquez payment_frequency_interval et subscription_period_interval (Day, Week, Month ou Year), ainsi que leurs nombres correspondants.Create Product API
Consultez la structure détaillée de la requête et de la réponse dans la documentation de l’API Create Product.
Updating a Product
Updating a Product
Pour modifier un produit existant, envoyez une requête
PATCH à l’endpoint /products/{product_id}. Vous pouvez mettre à jour des propriétés telles que le nom, le prix et la description tout en conservant les autres informations inchangées.Vérifiez que le product_id dans l’endpoint correspond à un produit existant.Update Product API
Consultez la structure détaillée de la requête et de la réponse dans la documentation de l’API Update Product.
Retrieving Products
Retrieving Products
Vous pouvez récupérer la liste des produits enregistrés dans votre compte en envoyant une requête
GET à l’endpoint /products. Vous pourrez ainsi récupérer les détails des produits, y compris ceux qui sont actifs et archivés.Retrieve Products API
Consultez la structure détaillée de la requête et de la réponse dans la documentation de l’API Retrieve Products.
Uploading Product Images
Uploading Product Images
Vous pouvez associer une image à un produit en l’importation vers AWS S3 à l’aide d’une URL pré-signée fournie par l’API. Demandez d’abord une URL d’importation d’image à l’endpoint
/products/{product_id}/images, puis utilisez l’URL fournie pour importer l’image dans un délai de 60 secondes.Une fois l’URL pré-signée reçue de l’API, importez l’image à l’aide de la méthode PUT. Cela garantit un accès sécurisé et temporaire à AWS S3 pour importer l’image.Bibliothèques prises en charge pour l’importation vers S3 :- Node.js :
axios,node-fetch - Python :
requests,boto3 - Go :
net/http - PHP :
GuzzleHttp - Ruby :
rest-client
200 OK, indiquant que l’image a bien été enregistrée.Upload Product Image API
Consultez la structure détaillée de la requête et de la réponse dans la documentation de l’API Upload Product Image.
Archiving a Product
Archiving a Product
Si vous ne souhaitez plus afficher ou utiliser un produit, vous pouvez l’archiver en envoyant une requête
DELETE à l’endpoint /products/{id}. Cette action masque le produit, mais ne le supprime pas définitivement.Archive Product API
Consultez la structure détaillée de la requête et de la réponse dans la documentation de l’API Archive Product.
Unarchiving a Product
Unarchiving a Product
Si vous devez restaurer un produit archivé, envoyez une requête
POST à l’endpoint /products/{product_id}/unarchive. Le produit sera réactivé et de nouveau disponible.Unarchive Product API
Consultez la structure détaillée de la requête et de la réponse dans la documentation de l’API Unarchive Product.
Checkout & fulfillment
Checkout & fulfillment
Créez des parcours de paiement ou d’abonnement à partir de produits, puis automatisez leur fulfillment via les avantages et les webhooks.
Checkout Sessions
Créez des sessions de checkout pour les achats ponctuels ou les abonnements.
Payment Webhooks
Réagissez aux événements du cycle de vie des paiements.
Subscription Webhooks
Gérez les événements de création, de renouvellement et d’annulation d’un abonnement.
Bonnes pratiques
- Commencez par la clarté : Séparez les produits pour chaque option de tarification (Mensuel ou Annuel)
- Utilisez les essais de manière réfléchie : Associez les essais à l’onboarding pour favoriser l’activation
- Automatisez le fulfillment : Utilisez les avantages et les webhooks pour une livraison instantanée
- Ajoutez des métadonnées : Enregistrez les identifiants de votre système pour le rapprochement
Vous êtes prêt à créer des produits et à commencer à vendre — en paiement unique, de manière récurrente ou à l’usage.
Articles associés
Product Analytics
Suivez les revenus, les clients, la rétention, les abonnés et le MRR pour chaque produit.
Localized Pricing
Définissez des prix fixes par devise ou par pays pour un produit, au lieu de vous appuyer sur les taux de change en temps réel.