Ajout d’un mode facturation pour permettre un meilleur comportement et une plus grande flexibilité des abonnements
Nouveautés
Nous introduisons un nouveau paramètre billing_
, qui permet un comportement d’abonnement plus flexible. Vous pouvez l’activer en définissant billing_
lorsque vous créez des abonnements, des aperçus de factures, des sessions Checkout, des devis ou des planifications d’abonnement. Le mode par défaut, classic
, préserve le comportement existant. Vous pouvez également migrer des abonnements existants à l’aide du nouvel endpoint de migration en mode facturation.
Nous appellerons désormais le comportement actuel de facturation classic
.
Consultez ci-dessous le récapitulatif des nouveaux comportements liés au mode facturation flexible. En savoir plus sur les différences entre les modes de facturation classique et flexible.
Zone d’impact | Nouveaux comportements |
---|---|
Calcul au prorata | Calcul précis du crédit au prorata. Le mode de facturation flexible utilise systématiquement le montant débité d’origine, en tenant compte avec précision de l’historique des taxes, des remises et des cycles de facturation. Application de la remise proportionnelle pour les calculs au prorata. Nous appliquons les remises proportionnellement à chaque poste d’abonnement lors du calcul au prorata au lieu de les répartir uniformément. Il en résulte davantage de calculs au prorata, en particulier lors de la facturation par poste ou de l’annulation d’articles avec des remises inégalement réparties. |
Tarifs à la consommation | Suppression des postes à montant nul lors de l’ajout de postes facturés à la consommation. Le mode de facturation flexible ne crée pas de postes à montant nul lorsque vous ajoutez des postes à la consommation à un abonnement. Par conséquent, si la facture est vide, nous n’en générons pas. Facturation à la consommation sur la base du tarif au moment où elle est signalée. Le mode de facturation flexible facture l’utilisation sur la base du tarif au moment où vous la signalez. Si le tarif d’un poste facturé à la consommation change au cours d’une période, seule l’utilisation mesurée après le changement de prix est facturée au nouveau tarif. Facture l’utilisation non facturée lors de la suppression de postes facturés à la consommation. Le mode de facturation flexible génère un poste de facture pour l’utilisation non facturée lorsque vous supprimez un poste d’abonnement facturé à la consommation. Cela s’applique aux prélèvements à l’aide de l’API ou lors des transitions de phase de planification. Consolide les factures pour les transitions de phase avec les postes facturés à la consommation. Le mode de facturation flexible génère systématiquement une seule facture lors des cycles d’abonnement, ce qui élimine la nécessité de créer des factures distinctes pour les postes facturés à la consommation supprimés. |
Date de début du cycle de facturation | Élimine les réinitialisations implicites du début du cycle de facturation. Avec le mode de facturation flexible, le billing_ reste inchangé pendant les opérations qui l’ont précédemment réinitialisé, telles que la définition d’une date cancel_ ou le passage à un tarif non nul. |
Annulation programmée | Comportement de calcul au prorata configurable pour cancel_ . Vous pouvez désormais désactiver les calculs au prorata pour une première période d’abonnement tronquée (lorsque vous définissez cancel_ à la création) à l’aide du paramètre proration_ . |
Antidatage | Divise la période antidatée en plusieurs postes de facture. Le mode de facturation flexible crée des postes de facture distincts pour chaque période de facturation dans la plage antidatée. La date de début du cycle de facturation s’aligne automatiquement sur la backdate_ si vous ne la définissez pas explicitement. |
Périodes d’essai | Met à jour la date de début de l’essai pour les essais suivants. Lorsque vous ajoutez une deuxième période d’essai à un abonnement d’essai, le mode de facturation flexible utilise la date de début de l’essai la plus récente. Préserve la date de fin initiale de l’essai lorsque la date d’annulation change. Le mode de facturation flexible préserve la date Standardise la description des postes de la période d’essai. Avec le mode de facturation flexible, les articles facturés à la consommation comme les articles sous licence utilisent un format de description cohérent (« Essai gratuit pour {quantity} x {product name} ») pour une présentation plus uniforme des informations relatives à l’essai. Génère des postes pour les modifications apportées au cours d’une période d’essai. En mode de facturation flexible, les postes qui n’ont pas été modifiés ne sont pas refacturés. Cela garantit que les clients ne sont facturés que pour les réajustements qu’ils effectuent au cours de leur essai. |
Postes de facture en attente | Inclut systématiquement les postes de facture en attente. Tous les postes de facture en attente disponibles sont désormais inclus lors de la génération de factures pour mises à jour. Auparavant, cela dépendait de la raison spécifique de la mise à jour de la facture. |
Le mode de facturation flexible n’est pas compatible avec toutes les fonctionnalités de Stripe Billing. Les fonctionnalités suivantes sont actuellement incompatibles et renvoient un code d’erreur 400
lorsque vous créez et mettez à jour un abonnement en activant le mode flexible :
- Facturation anticipée Version bêta
- Seuils de facturation
- Ancienne facturation à l’usage
- Les anciennes intégrations fiscales tierces utilisant
pay_
(par exemple, Avalara)immediately=false - L’ancien paramètre
max_
occurences retry_
spécifique à l’abonnementsettings
Impact
Par défaut, cette mise à jour n’a aucune incidence sur les abonnements nouveaux ou existants. Vous pouvez activer cette option en définissant billing_
sur les méthodes d’API suivantes :
- Créer un abonnement
- Créer un aperçu de facture
- Créer une session Checkout
- Créer une planification d’abonnement
- Créer un devis
Vous pouvez migrer des abonnements existants du mode classique au mode flexible en transmettant billing_
dans l`endpoint de migration du mode facturation. Le passage au mode de facturation flexible est un processus à sens unique : il n’est plus possible de revenir au mode classique après la migration.