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.

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 comptant 31 jours, le montant au prorata pour les 17 jours du 15 janvier au 1er février est de 17 divisé par 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 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. Indiquez un horodatage Unix entier compris dans la période actuelle du poste d’abonnement. Si l’abonnement est couvert par 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 ne pouvez fixer une proration_date antérieure à la période en cours que pendant la première période d’un abonnement antidaté. Dans ce cas, la proration_date peut être égale ou postérieure à la date 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.