Les abonnements vous permettent de vendre un accès continu avec des renouvellements automatisés. Utilisez des cycles de facturation flexibles, des essais gratuits, des modifications de plan et des extensions pour adapter les prix à chaque client.
Upgrade & Downgrade
Contrôlez les modifications de plan avec la proratisation et les mises à jour de quantité.
On‑Demand Subscriptions
Autorisez un mandat maintenant et facturez plus tard avec des montants personnalisés.
Customer Portal
Permettez aux clients de gérer les plans, la facturation et les annulations.
Subscription Webhooks
Réagissez aux événements du cycle de vie tels que créé, renouvelé et annulé.
Qu’est-ce que les Abonnements ?
Les abonnements sont des produits récurrents que les clients achètent selon un calendrier. Ils sont idéaux pour :- Licences SaaS : Applications, API ou accès à des plateformes
- Adhésions : Communautés, programmes ou clubs
- Contenu numérique : Cours, médias ou contenu premium
- Plans de support : SLA, packages de réussite ou maintenance
Avantages Clés
- Revenus prévisibles : Facturation récurrente avec renouvellements automatisés
- Cycles flexibles : Mensuels, annuels, intervalles personnalisés et essais
- Agilité des plans : Prorata pour les mises à niveau et rétrogradations
- Options supplémentaires et sièges : Attachez des mises à niveau optionnelles et quantifiables
- Paiement sans friction : Paiement hébergé et portail client
- Orienté développeur : API claires pour la création, les changements et le suivi d’utilisation
Création d’Abonnements
Créez des produits d’abonnement dans votre tableau de bord Dodo Payments, puis vendez-les via le paiement ou votre API. Séparer les produits des abonnements actifs vous permet de versionner les prix, d’attacher des options supplémentaires et de suivre les performances de manière indépendante.Création de produit d’abonnement
Configurez les champs dans le tableau de bord pour définir comment votre abonnement se vend, se renouvelle et se facture. Les sections ci-dessous correspondent directement à ce que vous voyez dans le formulaire de création.Détails du produit
- Nom du produit (obligatoire) : Le nom affiché dans le paiement, le portail client et les factures.
- Description du produit (obligatoire) : Une déclaration de valeur claire qui apparaît dans le paiement et les factures.
- Image du produit (obligatoire) : PNG/JPG/WebP jusqu’à 3 Mo. Utilisé dans le paiement et les factures.
- Marque : Associez le produit à une marque spécifique pour le thème et les e-mails.
- Catégorie fiscale (obligatoire) : Choisissez la catégorie (par exemple, SaaS) pour déterminer les règles fiscales.
Tarification
- Type de tarification : Choisissez Abonnement (ce guide). Les alternatives sont Paiement unique et Facturation basée sur l’utilisation.
- Prix (obligatoire) : Prix de base récurrent avec devise.
- Remise applicable (%) : Pourcentage de remise optionnel appliqué au prix de base ; reflété dans le processus de paiement et les factures.
- Répéter le paiement tous les (obligatoire) : Intervalle pour les renouvellements, par exemple, tous les 1 mois. Sélectionnez la cadence (mois ou années) et la quantité.
- Période d’abonnement (obligatoire) : Durée totale pendant laquelle l’abonnement reste actif (par exemple, 10 ans). Après cette période, les renouvellements s’arrêtent à moins d’être prolongés.
- Jours de période d’essai (obligatoire) : Définissez la durée de l’essai en jours. Utilisez 0 pour désactiver les essais. Le premier prélèvement se produit automatiquement à la fin de l’essai.
- Sélectionner un add-on : Attachez jusqu’à 10 add-ons que les clients peuvent acheter en plus du plan de base.
Les extensions sont idéales pour des extras quantifiables comme des sièges ou du stockage. Vous pouvez contrôler les quantités autorisées et le comportement de proratisation lorsque les clients les modifient.
Paramètres avancés
- Tarification incluant les taxes : Affichez les prix incluant les taxes applicables. Le calcul final des taxes varie toujours selon l’emplacement du client.
- Générer des clés de licence : Émettez une clé unique à chaque client après achat. Consultez le guide des Clés de licence.
- Livraison de produit numérique : Livrez des fichiers ou du contenu automatiquement après achat. En savoir plus dans Livraison de produit numérique.
- Métadonnées : Attachez des paires clé-valeur personnalisées pour le marquage interne ou les intégrations client. Consultez Métadonnées.
Essais d’Abonnement
Les essais permettent aux clients d’accéder aux abonnements sans paiement immédiat. Le premier prélèvement se produit automatiquement à la fin de l’essai.Configuration des Essais
Définissez Trial Period Days dans la section tarification du produit (utilisez0 pour désactiver). Vous pouvez outrepasser cela lors de la création d’abonnements :
Détection de l’État d’Essai
Pour déterminer si un abonnement est en période d’essai, récupérez la liste des paiements pour l’abonnement. S’il y a exactement un paiement d’un montant de 0, l’abonnement est en période d’essai :Mise à Jour de la Période d’Essai
Prolongez la période d’essai en mettant à journext_billing_date :
Changements de Plan d’Abonnement
Les changements de plan vous permettent de mettre à niveau ou de rétrograder des abonnements, d’ajuster les quantités ou de migrer vers différents produits. Chaque changement déclenche un prélèvement immédiat basé sur le mode de prorata que vous sélectionnez.Product Collections
Regroupez les produits liés dans des collections pour permettre des parcours de montée/descente en gamme fluides dans le Portail client.
Modes de proratisation
Choisissez comment les clients sont facturés lors d’un changement de plan :Comparaison rapide des trois modes de proratisation :
prorated_immediately | difference_immediately | full_immediately | |
|---|---|---|---|
| Montée en gamme | Facturation proratisée pour les jours restants | Différence de prix intégrale facturée | Montant total du nouveau plan facturé |
| Descente en gamme | Crédit proratisé pour les jours restants | Différence de prix intégrale sous forme de crédit | Aucun crédit, facturation complète |
| Cycle de facturation | Reste inchangé | Reste inchangé | Réinitialisé à aujourd’hui |
| Idéal pour | Facturation équitable basée sur le temps | Changements de niveau simples | Réinitialiser le cycle de facturation |
prorated_immediately
Facture le montant proratisé en fonction du temps restant dans le cycle de facturation actuel. Idéal pour une facturation équitable qui tient compte du temps non utilisé.
difference_immediately
Facture immédiatement la différence de prix (upgrade) ou ajoute un crédit pour les prochains renouvellements (downgrade). Idéal pour des scénarios de montée/descente en gamme simples.
Les crédits issus de rétrogradations utilisant
difference_immediately sont liés à l’abonnement et s’appliquent automatiquement aux renouvellements futurs. Ils sont distincts des droits Credit-Based Billing.difference_immediately, la valeur inutilisée devient un crédit lié à l’abonnement qui compense automatiquement les renouvellements futurs :
full_immediately
Facture immédiatement le montant total du nouveau plan, en ignorant le temps restant. Idéal pour réinitialiser les cycles de facturation.
Example: Prorated upgrade calculation
Example: Prorated upgrade calculation
Scénario : Un client sur Basic (30 /mois) le jour 16 d’un cycle de 30 jours en utilisant Renouvellement suivant à la date de facturation initiale : 80,00 $/mois.
prorated_immediately.Example: Downgrade credit calculation
Example: Downgrade credit calculation
Scénario : Un client sur Pro (80 /mois) en utilisant Le crédit de 60 $ s’applique automatiquement aux renouvellements futurs :
difference_immediately.- Renouvellement 1 : 20 (crédit) = **0,00 de crédit restants)
- Renouvellement 2 : 20 (crédit) = **0,00 de crédit restants)
- Renouvellement 3 : 20 (crédit) = 0,00 $ (crédit épuisé)
- Renouvellement 4 : 20,00 $ (prix total)
En savoir plus sur la gestion des crédits dans le Guide de montée/descente en gamme.
Modifier les plans avec des extensions
Modifiez les extensions lors des changements de plan. Les extensions sont incluses dans les calculs de proratisation :Les changements de plan déclenchent des prélèvements immédiats. En cas d’échec, l’abonnement peut passer en état
on_hold. Suivez les modifications via les événements webhook subscription.plan_changed.Prévisualisation des changements de plan
Avant de valider un changement de plan, prévisualisez le montant exact et l’abonnement résultant :Preview Change Plan API
Prévisualisez les changements de plan avant de les valider.
États de l’abonnement
Les abonnements peuvent passer par différents états au cours de leur cycle de vie :active: L’abonnement est actif et se renouvelle automatiquementon_hold: L’abonnement est mis en pause à cause d’un paiement échoué. Une mise à jour du moyen de paiement est nécessaire pour réactivercancelled: L’abonnement est annulé et ne se renouvellera pasexpired: L’abonnement a atteint sa date de finpending: L’abonnement est en cours de création ou de traitement
État en pause
Un abonnement passe en étaton_hold lorsque :
- Un paiement de renouvellement échoue (fonds insuffisants, carte expirée, etc.)
- La facturation d’un changement de plan échoue
- L’autorisation du moyen de paiement échoue
Réactiver depuis l’état en pause
Pour réactiver un abonnement en étaton_hold, mettez à jour le moyen de paiement. Cela permet automatiquement :
- Crée un prélèvement pour le solde restant
- Génère une facture
- Traite le paiement avec le nouveau moyen de paiement
- Réactive l’abonnement vers l’état
activeaprès paiement réussi
Après avoir mis à jour avec succès le moyen de paiement d’un abonnement
on_hold, vous recevrez les événements webhook payment.succeeded suivis de subscription.active.Gestion de l’API
Create subscriptions
Create subscriptions
Utilisez
POST /subscriptions pour créer des abonnements de manière programmatique à partir de produits, avec essais et extensions optionnels.API Reference
Consultez l’API de création d’abonnement.
Changements de plan avec prorata
Mettez à niveau ou baissez un abonnement et contrôlez le comportement de prorata :Update subscriptions
Update subscriptions
Utilisez
PATCH /subscriptions/{id} pour mettre à jour les quantités, annuler à la prochaine date de facturation ou modifier les métadonnées.API Reference
Découvrez comment mettre à jour les détails d’un abonnement.
Annuler à la fin de la période
Planifiez une annulation sans résiliation immédiate de l’accès :Change plans (proration)
Change plans (proration)
Changez le produit actif et les quantités avec des contrôles de proratisation.
API Reference
Passez en revue les options de changement de plan.
Abonnements à la demande
Créez un abonnement à la demande et facturez plus tard si nécessaire :On‑demand charges
On‑demand charges
Pour les abonnements à la demande, facturez des montants spécifiques sur demande.
API Reference
Facturez un abonnement à la demande.
Mettre à jour le mode de paiement pour un abonnement actif
Mettez à jour le mode de paiement pour un abonnement actif :List and retrieve
List and retrieve
Utilisez
GET /subscriptions pour lister tous les abonnements et GET /subscriptions/{id} pour en récupérer un.API Reference
Parcourez les API de listing et de récupération.
Réactiver un abonnement depuis l’état en attente
Réactivez un abonnement qui a été mis en attente en raison d’un paiement échoué :Usage history
Usage history
Récupérez l’usage enregistré pour les modèles tarifaires mesurés ou hybrides.
API Reference
Consultez l’API d’historique d’usage.
Abonnements avec mandats conformes à la RBI
Update payment method
Update payment method
Mettez à jour le moyen de paiement d’un abonnement. Pour les abonnements actifs, cela met à jour le moyen de paiement pour les futurs renouvellements. Pour ceux en état
on_hold, cela réactive l’abonnement en créant un prélèvement pour les sommes dues restantes.API Reference
Apprenez à mettre à jour les moyens de paiement et à réactiver les abonnements.
Limites de mandat
Cas d’usage courants
- SaaS et API : accès par niveaux avec extensions pour les sièges ou l’usage
- Contenu et médias : accès mensuel avec essais introductifs
- Plans de support B2B : contrats annuels avec extensions de support premium
- Outils et plugins : clés de licence et versions publiées
Exemples d’intégration
Sessions de paiement (abonnements)
Lors de la création de sessions de paiement, incluez votre produit d’abonnement et les extensions optionnelles :Changements de plan avec proratisation
Mettez à niveau ou réglez à la baisse un abonnement et contrôlez le comportement de proratisation :Annuler à la prochaine date de facturation
Programmez une annulation prenant effet à la fin de la période de facturation en cours :Abonnements à la demande
Créez un abonnement à la demande et facturez plus tard selon les besoins :Mettre à jour le moyen de paiement pour un abonnement actif
Mettez à jour le moyen de paiement d’un abonnement actif :Réactiver un abonnement en pause
Réactivez un abonnement mis en pause à cause d’un paiement échoué :Abonnements avec mandats conformes à la RBI
Les abonnements UPI et par carte indienne fonctionnent sous la réglementation de la RBI (Reserve Bank of India) avec des exigences de mandat spécifiques :Limites des mandats
Le type et le montant du mandat dépendent du prélèvement récurrent de votre abonnement :- Montants inférieurs à 15 000 Rs : Nous créons un mandat à la demande pour 15 000 INR. Le montant de l’abonnement est prélevé périodiquement selon votre fréquence d’abonnement, jusqu’à la limite du mandat.
- Montants de 15 000 Rs ou plus : Nous créons un mandat d’abonnement (ou un mandat à la demande) pour le montant exact de l’abonnement.
Considérations pour les montées et descentes de gamme
Important : Lors des montées ou descentes en gamme, tenez compte avec soin des limites de mandat :- Si une montée ou descente en gamme entraîne un montant de prélèvement supérieur à 15 000 Rs et dépassant la limite de paiement à la demande existante, la transaction peut échouer.
- Dans ce cas, le client peut devoir mettre à jour son moyen de paiement ou modifier à nouveau l’abonnement pour établir un nouveau mandat avec la limite appropriée.
Autorisation pour les prélèvements de gros montant
Pour les prélèvements d’abonnement de 15 000 Rs ou plus :- Leur banque demandera au client d’autoriser la transaction.
- Si le client n’autorise pas la transaction, celle-ci échouera et l’abonnement sera mis en pause.
Délai de traitement de 48 heures
Chronologie de traitement : Les prélèvements récurrents sur cartes indiennes et abonnements UPI suivent un schéma de traitement spécifique :- Les prélèvements sont initiés à la date prévue selon votre fréquence d’abonnement.
- La déduction effective du compte du client n’intervient qu’après 48 heures à partir de l’initiation du paiement.
- Cette fenêtre de 48 heures peut s’étendre jusqu’à 2 à 3 heures supplémentaires selon les réponses des API bancaires.
Fenêtre d’annulation du mandat
Pendant la fenêtre de traitement de 48 heures :- Les clients peuvent annuler le mandat via leurs applications bancaires.
- Si un client annule le mandat pendant cette période, l’abonnement restera actif (il s’agit d’un cas particulier spécifique aux abonnements AutoPay par carte indienne et UPI).
- Toutefois, la déduction effective peut échouer, et dans ce cas, nous mettrons l’abonnement en pause.
- Retarder l’activation des avantages jusqu’à la confirmation du paiement
- Mettre en place des périodes de grâce ou un accès temporaire
- Surveiller l’état des abonnements pour détecter les annulations de mandat
- Gérer les états d’abonnement en pause dans la logique de votre application
Bonnes pratiques
- Commencez par des niveaux clairs : 2 à 3 plans avec des différences évidentes
- Communiquez les tarifs : affichez les totaux, la proratisation et le prochain renouvellement
- Utilisez les essais avec discernement : transformez avec un onboarding, pas juste du temps
- Exploitez les extensions : gardez les plans de base simples et proposez des extras en upsell
- Testez les changements : validez les changements de plan et la proratisation en mode test
Les abonnements constituent une base flexible pour les revenus récurrents. Commencez simplement, testez à fond, et itérez en fonction de l’adoption, du churn et des métriques d’expansion.