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
Mesurez la consommation et facturez en fonction de 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.Name & description
Indiquez un titre clair et une description concise axée sur la valeur. Le Markdown est pris en charge dans les descriptions.
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.
- Remise (%) : Remise en ligne optionnelle affichée lors du paiement et sur les factures.
- Pour les abonnements, définissez Répéter tous les (par exemple, 1 mois ou 1 an) et Jours d’essai si nécessaire.
Product media
Téléchargez des images pour mettre en valeur le produit lors du paiement et sur les factures. PNG/JPG/WebP pris en charge jusqu’à 3 Mo. Réorganisez ou remplacez à tout moment.
Automated entitlements (Under Advanced Settings)
Ajoutez une exécution qui s’active automatiquement après le paiement :
- Clés de licence : Émettre et valider des clés uniques
- Téléchargements de fichiers : Accorder un accès sécurisé aux fichiers
- Personnalisé : Déclencher votre propre logique de droits via des webhooks
Variantes et options de tarification
Au lieu de variantes sous un seul produit, créez des produits séparés 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 seul paiement et d’activer le changement de plan dans le Portail Client.
Pourquoi cette approche ?
- Modèles de tarification clairs : Chaque produit a un modèle de tarification unique et bien défini (unique, abonnement, ou basé sur l’utilisation)
- APIs prévisibles : Intégrations plus simples sans logique de variante imbriquée
- Reporting plus facile : Suivre les revenus et les métriques par produit sans agrégation de variantes
- Paiement flexible : Afficher plusieurs produits côte à côte, permettant aux clients de comparer et de choisir
Comment fonctionnent les Collections de Produits
- Créer des produits : Configurez des produits individuels pour chaque plan (par exemple, Starter Mensuel, Starter Annuel, Pro Mensuel, Pro Annuel)
- Regrouper dans une collection : Ajoutez des produits connexes à une Collection de Produits
- Paiement unifié : Les clients voient toutes les options dans un seul paiement et choisissent leur plan préféré
- Changement de plan : Les clients peuvent passer à un produit supérieur ou inférieur dans la même collection via le Portail Client
Product Collections
Regroupez les produits connexes pour des expériences de paiement unifiées et des parcours de montée/descente en charge fluides.
Gestion des produits
Vous pouvez gérer les produits via le tableau de bord ou de manière programmatique via l’API. L’API offre un contrôle total sur la création, les mises à jour, la récupération, les téléversements d’images et l’archivage des produits.Gestion du tableau de bord
- Mettre à jour : Modifiez le nom, la description, les images, le prix, les champs et les avantages à tout moment (le modèle de tarification est immuable).
- Archiver : Masquez un produit des nouveaux achats sans perturber les clients existants. Vous pouvez le désarchiver plus tard.
Gestion de l’API
Les instructions suivantes vous permettent de créer, mettre à jour, gérer et récupérer des produits, y compris le téléversement d’images.Creating a Product
Creating a Product
Un produit peut être un article ponctuel ou un service par abonnement. Pour créer un nouveau produit, envoyez une requête
POST au point de terminaison /products avec des détails tels que le nom, la description, le prix, la devise et le fait qu’il s’agisse d’un produit récurrent.Pour les produits récurrents, définissez recurring: true et spécifiez un billing_cycle (daily, weekly, monthly, yearly).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 au point de terminaison /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 détails inchangés.Assurez-vous que le product_id dans le point de terminaison 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 stockés dans votre compte en envoyant une requête
GET au point de terminaison /products. Cela vous permet d’obtenir les détails des produits, 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 la téléchargeant sur AWS S3 via une URL pré-signée fournie par l’API. Demandez d’abord une URL de téléchargement d’image au point de terminaison
/products/{product_id}/images, puis utilisez l’URL fournie pour télécharger l’image dans les 60 secondes.Une fois que l’API a renvoyé l’URL pré-signée, téléchargez l’image en utilisant la méthode PUT. Cela garantit un accès sécurisé et temporaire à AWS S3 pour le téléchargement de l’image.Bibliothèques prises en charge pour le téléchargement 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 été stockée avec succès.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
POST au point de terminaison /products/{product_id}/archive. 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 au point de terminaison /products/{product_id}/unarchive. Cela réactivera le produit et le rendra à 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 flux de paiement ou d’abonnement à partir des produits et exécutez-les automatiquement via les avantages et les webhooks.
Meilleures pratiques
- Commencer par la clarté : Produits séparés pour chaque option de tarification (Mensuel contre Annuel)
- Utiliser les essais judicieusement : Associez les essais à l’intégration pour favoriser l’activation
- Automatiser l’exécution : Utilisez des avantages et des webhooks pour offrir instantanément
- Taguer avec des métadonnées : Stockez vos identifiants système pour une réconciliation
Vous êtes prêt à créer des produits et à commencer à vendre : ponctuels, récurrents ou à la consommation.
Connexes
Product Analytics
Suivez les revenus, les clients, la rétention, les abonnés et le MRR pour chaque produit individuel.