Configuration de la date d'ancrage du cycle de facturation d'un abonnement

Les abonnements étant facturés selon un cycle, il est important de savoir en définir la date de facturation.

Le cycle de facturation d’un abonnement dépend de deux facteurs :

L’intervalle récurrent de son tarif ou de ses tarifs (mensuel, annuel, hebdomadaire, etc.).
Le début du cycle de facturation désigne la date de référence pour les prochains cycles de facturation. Il définit le jour de la semaine pour les cycles hebdomadaires (week), le jour du mois pour les cycles mensuels et annuels (month et year), et le mois de l’année pour les cycles annuels (year). La valeur par défaut est la date de création de l’abonnement ou la date de fin de la période d’essai (le cas échéant). Vous pouvez également définir cette valeur vous-même lors de la création de l’abonnement.

Note

La date d’ancrage du cycle de facturation correspond à un horodatage UNIX exprimé en secondes à compter de la date initiale (epoch) du système.

Voici des exemples d’abonnements mensuels avec différents cycles de facturation :

Un abonnement mensuel dont la date de début du cycle de facturation est le 2 septembre est toujours facturé le 2e jour du mois.
Un abonnement mensuel dont la date de début du cycle de facturation est fixée au 31 janvier est facturé au dernier jour du mois le plus proche de la date de début, c’est-à-dire le 28 février (ou le 29 février les années bissextiles), puis le 31 mars, le 30 avril, etc.
Un abonnement hebdomadaire dont la date de début du cycle de facturation est le vendredi 3 juin est ensuite facturé tous les vendredis.

Les périodes de facturation complètes commencent à la date de la première facture calculée sur une période complète, qui est souvent identique à la date de début du cycle de facturation, et dont l’intervalle est toujours aligné sur celle-ci.

Spécifier la date de début du cycle de facturation pour les nouveaux abonnements

Il existe deux manières de définir la date de début du cycle de facturation pour les nouveaux abonnements :

Utilisez le paramètre billing_cycle_anchor_config pour calculer votre horodatage (abonnements mensuels ou annuels uniquement).
Utilisez le paramètre billing_cycle_anchor pour accepter directement l’horodatage.

Si vous créez un abonnement mensuel ou annuel, nous vous recommandons d’utiliser le paramètre billing_cycle_anchor_config car il prend automatiquement en compte les mois courts et les années bissextiles. Si vous créez un abonnement quotidien ou hebdomadaire, ou si vous préférez définir la date de début de cycle de votre abonnement à l’aide d’un horodatage, utilisez directement le paramètre billing_cycle_anchor.

Utiliser billing_cycle_anchor_config

Pour créer une intégration avec abonnements mensuels ou annuels, utilisez billing_cycle_anchor_config à la création des abonnements pour spécifier le jour du mois auquel débute le cycle de facturation.

Définissez l’attribut day_of_month sur 31 pour créer un abonnement mensuel qui se répète à la fin du mois, quel que soit le nombre de jours dans le mois. Si un mois comporte moins de 31 jours, l’abonnement se renouvelle le dernier jour du mois.

Vous pouvez également spécifier l’attribut month afin de contrôler le mois de début du cycle de facturation pour les abonnements annuels ou durant plusieurs mois.

Pour fixer la date de début du cycle de facturation d’un abonnement annuel au 1er juillet, créez un abonnement annuel en configurant l’attribut month sur 7 et l’attribut day_of_month sur 1.

Pour aligner les périodes de facturation sur un autre abonnement, indiquez la même valeur day_of_month que celle de l’abonnement d’origine, ainsi que les mêmes valeurs hour, minute et second. Si vous omettez les paramètres hour, minute et second, leurs valeurs correspondront à l’heure de création de l’abonnement.

Par exemple, si vous avez un abonnement mensuel existant avec un horodatage billing_cycle_anchor indiquant le jour du mois, l’heure, la minute et le seconde, dont les valeurs sont respectivement 15, 12, 30 et 0, vous pouvez aligner un nouvel abonnement mensuel sur ces valeurs. Pour ce faire, définissez les paramètres day_of_month, hour, minute et second de façon à ce qu’ils correspondent à ces valeurs.

Si vous utilisez le paramètre billing_cycle_anchor_config, la date billing_cycle_anchor peut être postérieure à la prochaine période de facturation. La date de la première facture du montant total est toutefois toujours comprise dans la période de facturation suivant la création de l’abonnement ou la fin d’un essai gratuit.

Par exemple, supposez que vous créez un abonnement bimestriel en février avec renouvellement au dernier jour du mois en définissant le paramètre day_of_month sur 31. La prochaine période de deux mois à compter de février se terminant un 31 correspond à juillet et août, ce qui se traduit par une date de début du cycle de facturation au 31 août. Cependant, la date de la première facture complète pour cet abonnement est toujours en février. On a une période initiale calculée au prorata, de la création de l’abonnement jusqu’au 28 février (ou au 29 s’il s’agit d’une année bissextile), suivie d’une période de facturation complète de deux mois.

Utiliser billing_cycle_anchor

Vous pouvez créer un abonnement avec un début de cycle de facturation spécifique à l’aide de l’API Subscriptions ou de Checkout.

Appelez l’API Create Subscription, en définissant un horodatage pour billing_cycle_anchor.

Configurer le comportement des calculs au prorata

Quel que soit le paramètre d’API utilisé, Stripe crée automatiquement une facture au prorata pour la période qui va de la date de création de l’abonnement à la date de la première facture complète.

Si vous ne souhaitez pas facturer immédiatement un client pour la période comprise entre la création de l’abonnement et la date de la première facture du montant total, vous pouvez :

Désactivez le calcul au prorata en définissant proration_behavior sur none afin de rendre gratuite la période initiale allant jusqu’à la date de la première facture du montant total. Aucune facture n’est donc générée avant le premier cycle de facturation.
Associez une période d’essai au billing_cycle_anchor en définissant trial_end sur un horodatage représentant la date de fin de l’essai gratuit. Selon la durée de l’essai gratuit et le nombre de jours avant la date de la première facture du montant total, cette option peut générer une facture au prorata à l’issue de la période d’essai. Par exemple, prenons un essai gratuit d’une durée de 7 jours et un cycle de facturation mensuel débutant le 1er du mois. Si le client s’abonne le 15, nous générons une facture au prorata le 22 pour la période comprise entre le 22 et le 1er, puis nous facturons le montant total le 1er de chaque mois suivant. Si un client s’abonne le 28, l’essai gratuit se prolonge au-delà du 1er, générant une facture au prorata jusqu’au mois suivant.

Modifier le cycle de facturation des abonnements existants

Utilisez l’API Subscriptions ou le Dashboard pour modifier la date de facturation d’un abonnement existant à l’aide de l’une des options suivantes :

Réinitialiser la date de début du cycle de facturation sur la date du jour.
Ajoutez un essai gratuit pour définir automatiquement la date de début du cycle de facturation sur la fin de la période d’essai. Généralement, les périodes d’essai commencent lorsque vous créez un abonnement, mais vous pouvez également les appliquer à des abonnements existants, ce qui vous permet de créditer le solde du client pour les jours restants du cycle précédent déjà payés.
Si tous les prix sont à zéro, l’ajout d’un ou plusieurs prix payés réinitialise immédiatement la période de facturation. Voir le guide Passer à un abonnement supérieur ou inférieur pour plus de détails sur ce scénario.

Réinitialiser le cycle de facturation sur la date du jour

Lorsque vous réinitialisez le cycle de facturation, Stripe envoie immédiatement une facture. Activez le calcul au prorata pour créditer le client des jours déjà payés de la période précédente. La désactivation du calcul au prorata peut entraîner une surfacturation de votre client.

Appelez l’API Update Subscription, en définissant billing_cycle_anchor sur now et proration_behavior sur create_prorations pour éviter que le client ne soit facturé deux fois pour les jours déjà payés du cycle précédent.

Ajouter une période d’essai pour modifier le cycle de facturation

En ajoutant une période d’essai sans calcul au prorata à un abonnement existant, vous pouvez configurer le cycle de facturation à la date de votre choix.

En règle générale, si vous utilisez la période d’essai pour modifier le cycle de facturation sans émettre de facture au prorata, il convient de désactiver le calcul au prorata. En effet, la durée de la période d’essai tient compte de la partie déjà payée lors du cycle de facturation précédent.

Par exemple, imaginons qu’un client possède un abonnement actif dont la facturation est prévue le 23 juillet et que vous ajoutiez une période d’essai se terminant 1er août :

Le client reçoit une facture de 0 USD le 15 juillet.
Le client n’est pas facturé le 23 juillet.
Le client est facturé le 1er août, puis le 1er septembre, et ainsi de suite.
Le client a déjà payé jusqu’au 23 juillet dans le cycle précédent, de sorte que la période « gratuite » n’est pas réellement gratuite.
La période comprise entre le 23 et le 31 juillet n’est pas facturée.
Le nouveau cycle facturé le 1er août est un cycle complet au tarif normal.

Appelez l’API Update Subscription, en définissant trial_end sur un horodatage Unix représentant la date de fin de la période d’essai (également la nouvelle date de début du cycle de facturation) et proration_behavior sur none.

Facturation à la consommation

Avec la facturation à la consommation, le tarif payé par le client varie en fonction de sa consommation durant le cycle de facturation. Si la modification du cycle de facturation provoque la fin anticipée d’un intervalle d’abonnement, vous facturez le client pour l’utilisation cumulée au cours du cycle de facturation écourté.

Seuils

Outre le cycle régulier, vous pouvez configurer les abonnements de manière à ce qu’ils soient facturés lorsque le montant dû atteint un seuil.

Si vous avez un abonnement configuré pour facturer de cette manière, vous pouvez le configurer pour réinitialiser le cycle d’abonnement lorsque le seuil est atteint.

Voir seuils de facturation pour en savoir plus.