Définir la date du cycle de facturation

Lors de la création d’une session Checkout, vous pouvez définir explicitement le début du cycle de facturation d’un abonnement sur une date fixe (par exemple, le 1er du mois suivant). La date de début du cycle détermine la date de la première facture du montant total, c’est-à-dire la date à laquelle les clients sont facturés du montant total de l’abonnement. La date de début du cycle et la fréquence de facturation déterminent également les dates de facturation à venir d’un abonnement. Par exemple, un abonnement mensuel créé le 15 mai avec une date de début du cycle de facturation fixée au 1er juin est facturé le 15 mai, puis tous les 1er de chaque mois.

Pour la période de facturation initiale jusqu’à la date de la première facture du montant total, vous pouvez personnaliser le traitement des calculs au prorata avec le paramètre proration_behavior. Par défaut, proration_behavior est défini sur create_prorations, et les clients reçoivent une facture calculée au prorata. Si proration_behavior est défini sur none, la période précédant la date de la première facture du montant total est gratuite.

Créer une session Checkout avec une date de début du cycle de facturation

Pour configurer un début de cycle de facturation, définissez le paramètre subscription_data.billing_cycle_anchor lorsque vous créez une session Checkout en mode subscription. La date de début du cycle de facturation doit être un horodatage UNIX postérieur à la date du jour et antérieur à la prochaine date de facturation de l’abonnement.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "subscription_data[billing_cycle_anchor]"=1611008505

Si la date de début du cycle de facturation se situe pendant la période active d’une session et qu’un client tente de payer une fois celle-ci passée, Checkout ne calcule pas de montant au prorata pour la période précédant la période de facturation, mais débite au contraire le client pour la totalité de la période (à compter de la date de début du cycle de facturation).

Désactiver les calculs au prorata

Pour désactiver les calculs au prorata, définissez le paramètre subscription_data.proration_behavior sur none lorsque vous créez une session Checkout.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "subscription_data[billing_cycle_anchor]"=1611008505 \
  -d "subscription_data[proration_behavior]"=none

Comme un essai gratuit, la période initiale jusqu’au début du cycle de facturation est gratuite. Contrairement à ce qui se passe avec un essai gratuit, aucune facture de 0 USD n’est générée. Les clients reçoivent une facture avec le montant total de l’abonnement à la date de début du cycle de facturation.

Dans l’objet Checkout Session response, les montants associés aux postes de facture et aux totaux sont toujours de 0 lorsque les calculs au prorata sont désactivés. Par ailleurs, l’état du paiement de la session est défini sur no_payment_required, ce qui indique que le paiement est reporté.