Antidater des abonnements
Vous pouvez antidater un abonnement et facturer les clients pour une période déjà écoulée. Cette fonction est souvent utilisée lors de la migration vers Stripe ou à des fins d’archivage. Le champ backdate_start_date
indique la date à laquelle l’abonnement est antidaté. Vous pouvez, à titre facultatif, facturer les clients pour la période écoulée en question et définir la prochaine date de facturation.
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.
Cela crée une facture avec un montant calculé au prorata pour la période entre la date de début antidatée et la date actuelle. Le montant au prorata est calculé sur la base d’un intervalle imaginé qui commence à la date de début antidatée. Par exemple, si la période de facturation est mensuelle et commence le premier du mois, et que vous définissez la backdate_start_date
sur le 15 février (dans une année non bissextile), le calcul au prorata est basé sur un mois allant du 15 février au 15 mars. Étant donné que ce mois imaginé dure 28 jours, le montant calculé au prorata pour les 14 jours allant du 15 février au 1er mars correspond exactement à la moitié du montant d’un paiement mensuel normal.
De même, si vous définissez backdate_start_date
sur le 15 janvier, le calcul au prorata est basé sur un mois imaginaire allant du 15 janvier au 15 février. Ce mois étant de 31 jours, le montant au prorata pour les 17 jours du 15 janvier au 1er février est de 17/31 (ou 0,548) d’un paiement mensuel normal.
Une autre façon d’envisager le calcul consiste à considérer la date de début antidatée comme date de début d’origine et le début de la première période de facturation complète comme nouvelle date de début.
Antidater sans facturer les utilisateurs
Vous pouvez également antidater un abonnement sans facturer le client pour la période antidatée, ce qui est utile si vous migrez vers Stripe. Pour ce faire, transmettez proration_behavior: 'none'
lors de la création de l’abonnement. Cela définit start_date
sur la même valeur que backdate_start_date
, mais ne facture pas le client pour la période antidatée.
Antidater et configurer la date de début du cycle de facturation
Vous pouvez combiner backdate_start_date
et billing_cycle_anchor
pour antidater un abonnement et définir la date de début du cycle de facturation sur une date future. Vous créez ainsi un poste au prorata pour la période comprise entre la date de début antidatée et la date de début du cycle de facturation pour la prochaine facture. Cette fonctionnalité est utile si vous migrez vers Stripe et que vous devez reporter la prochaine date de facturation pour vos abonnements tout en facturant les clients pour la période écoulée.
Par exemple, imaginons que nous sommes le 15 octobre et que vous migrez vers Stripe. Votre abonnement a débuté 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.
Cette option émet immédiatement une facture d’un montant calculé au prorata pour la période comprise entre le 1er septembre et le 1er novembre. Elle définit également la start_date
de l’abonnement sur le 1er septembre. Stripe émet la prochaine facture le 1er novembre.
Antidater une mise à jour
Pour définir la date d’entrée en vigueur du calcul au prorata lors de la mise à jour d’un abonnement, utilisez le paramètre proration_date
. Transmettez un horodatage Unix entier dans la période actuelle de l’abonnement. Si l’abonnement est adossé à une planification d’abonnement, assurez-vous que l’horodatage est antérieur à la date de début de la phase suivante de la planification d’abonnement.
Vous pouvez définir une proration_date
antérieure à la période actuelle uniquement pendant la première période d’un abonnement antidaté. Dans ce cas, la proration_date
peut être égale ou postérieure à la subscription[start_date]
(date de début antidatée). Dans tous les autres cas, la proration_date
ne peut pas être antérieure à la current_period_start
.