Antidater des abonnements

Vous pouvez antidater un abonnement afin de facturer des clients pour une période déjà écoulée. Cette fonction est souvent utilisée lors d’une migration vers Stripe ou à des fins d’archivage. Le champ backdate_start_date indique la date de début rétroactive de l’abonnement. Vous avez également la possibilité de facturer les clients pour cette période écoulée et de définir la prochaine date de facturation.

Considérations relatives au mode de facturation

Depuis la version 2025-04-30 de l’API, le comportement de l’antidatage dépend du billing_mode de votre abonnement :

Antidater et facturer des utilisateurs

Parfois, les utilisateurs peuvent avoir accès à votre service avant que vous ne créiez un abonnement pour eux, et vous souhaitez leur facturer cet accès.

Une facture est ainsi créée avec les paiements correspondant à la période comprise entre la date de début antidatée et la date actuelle.

Si un abonnement présente la valeur billing_mode=classic, Stripe crée un montant unique au prorata pour la période antidatée, sur la base d’une période imaginaire commençant à partir de la date de début antidatée. Par exemple, si vous avez un cycle de facturation mensuel commençant le premier du mois et que vous définissez backdate_start_date sur le 15 février (dans une année non bissextile), Stripe calcule le prorata sur la base d’un mois imaginaire allant du 15 février au 15 mars. Étant donné que le mois de février comporte 28 jours, le montant au prorata pour les 14 jours allant du 15 février au 1er mars est exactement la moitié du montant d’un paiement mensuel normal.

De même, si vous définissez backdate_start_date sur le 15 janvier, Stripe base le calcul au prorata sur un mois imaginaire allant du 15 janvier au 15 février. Ce mois imaginaire comporte 31 jours, de sorte que le montant au prorata pour les 17 jours du 15 janvier au 1er février est de 17 divisé par 31 (environ 0,548) d’un paiement mensuel normal.

Vous pouvez également afficher le calcul en considérant la date de début antidatée comme date de début d’origine. Le début de la première période de facturation complète devient alors la date de début mise à jour.

Si un abonnement présente la valeur billing_mode=flexible, Stripe génère des postes distincts pour chaque cycle de facturation normal survenu au cours de la période antidatée. Cela signifie que chaque cycle est traité comme si Stripe le facturait normalement pendant cette période.

Antidater sans facturer les utilisateurs

Vous pouvez également antidater un abonnement sans facturer au client la période antidatée, ce qui peut être utile si vous migrez vers Stripe. Pour ce faire, définissez proration_behavior: 'none' lorsque vous créez l’abonnement. Cela permet de définir start_date sur la même valeur que backdate_start_date, mais le client n’est pas facturé pour la période rétroactive.

Antidater et configurer la date de début du cycle de facturation

Vous pouvez combiner backdate_start_date avec billing_cycle_anchor pour antidater un abonnement et fixer le point d’ancrage du cycle de facturation à une date ultérieure. Cela crée un poste prorata sur la prochaine facture pour la période comprise entre la date de début antidatée et le point d’ancrage du cycle de facturation. Vous pouvez utiliser cela si vous migrez vers Stripe et avez besoin de reporter la prochaine date de facturation pour vos abonnements tout en facturant les clients pour le temps écoulé.

Par exemple, supposons que nous sommes le 15 octobre et que vous migrez vers Stripe. Vous avez un abonnement qui a commencé le 1er septembre et la prochaine date de facturation est le 1er novembre. Pour migrer cet abonnement, créez un nouvel abonnement et définissez backdate_start_date sur le 1er septembre et billing_cycle_anchor sur le 1er novembre.

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

Cette opération émet immédiatement une facture pour le montant au prorata couvrant la période comprise entre le 1er septembre et le 1er novembre. La start_date de l’abonnement est également fixée au 1er septembre. Stripe émet la facture suivante le 1er novembre.

Antidater une mise à jour

Pour définir la date d’entrée en vigueur des prorata lors de la mise à jour d’un abonnement, utilisez le paramètre proration_date. Transmettez un horodatage Unix entier compris dans la période actuelle des postes de l’abonnement. Si l’abonnement utilise une planification d’abonnement, assurez-vous que l’horodatage est antérieur à la date de début de la phase suivante de la planification.

Vous ne pouvez fixer la proration_date antérieure à la période en cours que pendant la première période d’un abonnement antidaté. Dans cette situation, la proration_date doit être égale ou postérieure à la subscription[start_date] (date de début antidatée). Dans tous les autres cas, la valeur de proration_date ne peut pas être antérieure à la valeur de current_period_start.