Définir la date de début de cycle de facturation dans Checkout

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_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "line_items[][price]"=
{{PRICE_ID}} \
  -d "line_items[][quantity]"=1 \
  -d "mode"="subscription" \
  -d "success_url"="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "cancel_url"="https://example.com/cancel" \
  -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 aucun lorsque vous créez une session Checkout.

curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "line_items[][price]"=
{{PRICE_ID}} \
  -d "line_items[][quantity]"=1 \
  -d "mode"="subscription" \
  -d "success_url"="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "cancel_url"="https://example.com/cancel" \
  -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é.

Limites actuelles

• Vous ne pouvez pas utiliser des périodes d’essai avec des dates de début du cycle de facturation dans Checkout.
• Les tarifs ponctuels ne peuvent pas être utilisés dans des sessions Checkout lorsque proration_behavior est défini sur aucun.
• Vous ne pouvez pas appliquer de amount_off coupons à des sessions Checkout avec create_prorations comme proration_behavior par défaut.