Les produits sont la base de Dodo Payments. Que vous vendiez un téléchargement unique, un abonnement récurrent ou un accès basé sur l’utilisation, vous commencez par créer un produit. Chaque produit définit comment il est tarifé, présenté lors du paiement et exécuté après l’achat.
Unique
Facturez une fois pour un accès à vie ou un seul livrable.
Abonnements
Facturez selon un calendrier avec des essais, une proratisation et des options supplémentaires.
Basé sur l'utilisation
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.Nom & description
Fournissez un titre clair et une description concise orientée vers la valeur. Markdown est pris en charge dans les descriptions.
Modèle de tarification & prix
Sélectionnez le modèle de tarification :
- 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.
Médias du produit
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.
Droits automatisés (Sous Paramètres avancés)
Attachez 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
Collections de Produits
Regroupez des produits connexes pour des expériences de paiement unifiées et des chemins de mise à niveau/abaissement sans faille.
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.Création d'un Produit
Création d'un Produit
Un produit peut être un article unique ou un service basé sur un abonnement. Pour créer un nouveau produit, envoyez une
POST requête à l’endpoint /products avec des détails tels que le nom, la description, le prix, la devise et s’il s’agit d’un produit récurrent.Pour les produits récurrents, définissez recurring: true et spécifiez un billing_cycle (daily, weekly, monthly, yearly).API Créer Produit
Consultez la structure de requête et de réponse détaillée dans la documentation de l’API Créer Produit.
Mise à jour d'un Produit
Mise à jour d'un Produit
Pour modifier un produit existant, envoyez une
PATCH requête à l’endpoint /products/{product_id}. Vous pouvez mettre à jour des propriétés telles que le nom, le prix et la description tout en gardant les autres détails inchangés.Assurez-vous que le product_id dans l’endpoint correspond à un produit existant.API Mettre à jour Produit
Consultez la structure de requête et de réponse détaillée dans la documentation de l’API Mettre à jour Produit.
Récupérer des Produits
Récupérer des Produits
Vous pouvez récupérer une liste de produits stockés dans votre compte en utilisant une
GET requête à l’endpoint /products. Cela vous permet de récupérer les détails des produits, y compris les produits actifs et archivés.API Récupérer Produits
Consultez la structure de requête et de réponse détaillée dans la documentation de l’API Récupérer Produits.
Téléversement d'Images de Produit
Téléversement d'Images de Produit
Vous pouvez associer une image avec un produit en la téléchargeant sur AWS S3 à l’aide d’une URL pré-signée fournie par l’API. Tout d’abord, demandez une URL de téléversement d’image à l’endpoint
/products/{product_id}/images, puis utilisez l’URL fournie pour télécharger l’image dans les 60 secondes.Une fois l’URL pré-signée reçue de l’API, 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éversement de l’image.Bibliothèques supportées pour le téléversement 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.API Téléverser Image Produit
Consultez la structure de requête et de réponse détaillée dans la documentation de l’API Téléverser Image Produit.
Archiver un Produit
Archiver un Produit
Si vous ne souhaitez plus afficher ou utiliser un produit, vous pouvez l’archiver en utilisant une
POST requête à l’endpoint /products/{product_id}/archive. Cette action cache le produit mais ne le supprime pas définitivement.API Archiver Produit
Consultez la structure de requête et de réponse détaillée dans la documentation de l’API Archiver Produit.
Désarchiver un Produit
Désarchiver un Produit
Si vous devez restaurer un produit archivé, envoyez une
POST requête à l’endpoint /products/{product_id}/unarchive. Cela réactivera le produit et le rendra à nouveau disponible à l’utilisation.API Désarchiver Produit
Consultez la structure de requête et de réponse détaillée dans la documentation de l’API Désarchiver Produit.
Paiement & exécution
Paiement & exécution
Créez des flux de paiement ou d’abonnement à partir des produits, et exécutez automatiquement via des avantages et des 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 - unique, récurrent ou par utilisation.