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

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.

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.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "billing_cycle_anchor_config[day_of_month]"=31

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.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "billing_cycle_anchor_config[month]"=7 \
  -d "billing_cycle_anchor_config[day_of_month]"=1

Vous pouvez spécifier le mois, le jour, l’heure, la minute et la seconde exacts pour la date de début du cycle de facturation à l’aide de l’option billing_cycle_anchor_config. Si vous n’indiquez pas l’heure, la minute et la seconde, les valeurs par défaut utilisées sont celles de l’heure de création de l’abonnement.

La date de début du cycle de facturation est exprimée en temps universel coordonné (UTC). Par exemple, si vous créez un abonnement en définissant billing_cycle_anchor_config sur 17 h (EST) sans spécifier l’heure, l’heure est enregistrée dans le système à 22 h UTC.

billing_cycle_anchor_config ne permet pas de définir une date antidatée comme date de début du cycle de facturation.

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.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "billing_cycle_anchor_config[day_of_month]"=15 \
  -d "billing_cycle_anchor_config[hour]"=12 \
  -d "billing_cycle_anchor_config[minute]"=30 \
  -d "billing_cycle_anchor_config[second]"=0

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.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d billing_cycle_anchor=1611008505

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.

Dans ces scénarios, la date de votre cycle de facturation change. Toutefois, si vous créez ou mettez à jour un abonnement avec billing_mode=flexible, la date de début du cycle de facturation reste inchangée. En savoir plus sur la configuration du mode de facturation flexible et ses limitations.

• Si tous les tarifs sont nuls, l’ajout d’un ou plusieurs tarifs payés réinitialise immédiatement la période de facturation. Pour en savoir plus, consultez le [guide des modifications tarifaires des abonnements](/billing/subscriptions/ change-price#handling-zero-amount-prices-and-quantities).
• billing_cycle_anchor se réinitialise à la date cancel_at lorsque cancel_at est défini sur une date antérieure au prochain cycle d’abonnement.
• Le billing_cycle_anchor se réinitialise à l’heure actuelle lorsque vous passez à un tarif avec un recurring.interval différent.

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

Pour réinitialiser la date de début du cycle de facturation, effectuez une requête de mise à jour en définissant billing_cycle_anchor sur now. La date de début du cycle de facturation est définie sur l’heure de la requête de mise à jour. Lorsque vous réinitialisez la date de début du 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.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d billing_cycle_anchor=now \
  -d proration_behavior=create_prorations

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.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d trial_end=1611008505 \
  -d proration_behavior=none

Facturation à la consommation

Avec la facturation à la consommation, le tarif payé par le client varie en fonction de sa consommation au cours du cycle de facturation. Lorsque 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

En plus du cycle standard, vous pouvez configurer les abonnements de manière à facturer le client dès que le montant 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.