Passer au contenu principal
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.
1

Nom & description

Fournissez un titre clair et une description concise orientée vers la valeur. Markdown est pris en charge dans les descriptions.
Gardez la première phrase orientée vers le client et axée sur les résultats ; elle apparaît de manière proéminente lors du paiement.
Produits
2

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.
Ensuite, définissez les prix :
  • 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.
Changer le prix n’affecte que les nouveaux achats. Les abonnements existants suivent les règles de changement de plan.
3

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.
4

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
Ajoutez ou retirez des avantages au fur et à mesure que votre offre évolue. Les abonnés existants gagnent ou perdent l’accès en conséquence.

​
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). Vous pouvez présenter plusieurs produits côte à côte dans le même paiement et permettre aux clients de passer de l’un à l’autre.
Cela rend les API prévisibles et simplifie les rapports. Chaque produit a un seul modèle de tarification.

​
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, la mise à jour, la récupération, les téléchargements 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échargement d’images.
Un produit peut être un article unique ou un service basé sur un abonnement. Pour créer un nouveau produit, envoyez une POST demande à 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).

Créer une API Produit

Voir la structure détaillée de la demande et de la réponse dans la documentation de l’API Créer un produit.
Pour modifier un produit existant, envoyez une PATCH demande à 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 d’autres détails inchangés.Assurez-vous que le product_id dans l’endpoint correspond à un produit existant.

Mettre à jour l'API Produit

Voir la structure détaillée de la demande et de la réponse dans la documentation de l’API Mettre à jour un produit.
Vous pouvez récupérer une liste de produits stockés dans votre compte en utilisant une GET demande à l’endpoint /products. Cela vous permet de récupérer les détails des produits, y compris les produits actifs et archivés.

Récupérer l'API Produits

Voir la structure détaillée de la demande et de la réponse dans la documentation de l’API Récupérer des produits.
Vous pouvez associer une image à 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échargement d’image à l’endpoint /products/{product_id}/images, puis utilisez l’URL fournie pour télécharger l’image dans les 60 secondes.
L’URL pré-signée expire dans 60 secondes, donc l’image doit être téléchargée dans ce délai.
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é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
Si le téléchargement est réussi, AWS S3 renverra un 200 OK statut, indiquant que l’image a été stockée avec succès.

Télécharger l'API Image Produit

Voir la structure détaillée de la demande et de la réponse dans la documentation de l’API Télécharger l’image du produit.
Si vous ne souhaitez plus afficher ou utiliser un produit, vous pouvez l’archiver en utilisant une POST demande à l’endpoint /products/{product_id}/archive. Cette action masque le produit mais ne le supprime pas définitivement.

Archiver l'API Produit

Voir la structure détaillée de la demande et de la réponse dans la documentation de l’API Archiver un produit.
Si vous devez restaurer un produit archivé, envoyez une POST demande à l’endpoint /products/{product_id}/unarchive. Cela réactivera le produit et le rendra à nouveau disponible à l’utilisation.

Désarchiver l'API Produit

Voir la structure détaillée de la demande et de la réponse dans la documentation de l’API Désarchiver un produit.

​
Meilleures pratiques

  • Commencez par la clarté : Séparez les produits pour chaque option de tarification (Mensuel vs Annuel)
  • Utilisez les essais judicieusement : Associez les essais à l’intégration pour stimuler l’activation
  • Automatisez l’exécution : Utilisez des avantages et des webhooks pour livrer instantanément
  • Taguez avec des métadonnées : Stockez vos ID système pour la réconciliation
Vous êtes prêt à créer des produits et à commencer à vendre - à paiement unique, récurrents ou par utilisation.