Abonnements présentant des postes à la périodicité différente

You can include multiple subscription items with different prices and billing periods on a single subscription and Stripe automatically handles invoice generation.

Par exemple, si vous proposez un service avec un tarif forfaitaire annuel, plus des frais mensuels à l’utilisation, vous pouvez inclure les deux tarifs en tant que postes du même abonnement. Stripe génère une facture unique et combinée lorsque les intervalles de facturation au niveau des postes s’alignent et sépare les factures lorsque les intervalles diffèrent.

Annuler un abonnement

L’annulation d’un abonnement ou d’une planification à période mixte annule tous les postes d’abonnement, quelle que soit leur période.

Les abonnements ont un comportement unique en matière de relance. Si toutes les tentatives de paiement échouent, Stripe annule l’abonnement entier et le marque comme impayé ou en retard, en fonction des paramètres de relance configurés.

En savoir plus sur l’annulation ou la suppression des abonnements.

Périodes de facturation pour les abonnements présentant des postes à la périodicité différente

Chaque poste d’abonnement possède ses propres current_period_start et current_period_end. Les postes d’abonnement suivent directement leurs périodes de facturation respectives au lieu d’être une période de facturation partagée de niveau supérieur sur la ressource abonnement.

Par exemple, un abonnement créé le 1er janvier avec un poste mensuel, bimensuel et trimestriel comporte les périodes suivantes :

Après le renouvellement le 1er février (subscription.current_period_end), la période actuelle de l’abonnement s’ajuste pour correspondre à la current_period_start la plus récente et à la current_period_end la plus ancienne de tous les postes :

Au bout du troisième cycle :

Essai gratuit

Les dates de la période de facturation au niveau du poste dépendent des dates de fin des essais gratuits, comme pour les abonnements standard. Lorsque l’abonnement présente une date de fin trial_end dans le futur, toutes les dates current_period_end (abonnement et postes) sont définies sur la date trial_end.

Pause à la fin de la période d’essai et reprise

vous pouvez configurer un abonnement à période mixte pour qu’il soit suspendu à la fin de la période d’essai lorsque le moyen de paiement est manquant via le paramètre trial_settings.end_behavior.missing_payment_method comme pour les abonnements ordinaires. vous pouvez reprendre les abonnements suspendus en utilisant Stripe.abonnement.resume, comme pour les abonnements ordinaires. nous prenons uniquement en charge les paramètres proration_behavior : « none » et billing_cycle_anchor avec les abonnements à période mixte.

Pour un abonnement à intervalles mixtes avec un abonnement mensuel et un abonnement bimestriel

• billing_cycle_anchor = 1er janvier
• trial_end = 1er février
• trial_settings.end_behavior.missing_payment_method = « pause »

Dans cet exemple, nous partons du principe que cet abonnement est suspendu le 1er février en raison d’un moyen de paiement manquant, et qu’il reprend le 15 février avec proration_behavior : « none »  :

Alignement des intervalles

Dans les abonnements à intervalles mixtes, la période de tarification de chaque poste (la combinaison de price.recurring.interval et price.recurring.interval_count) doit être un multiple de la période de tarification la plus courte de l’abonnement. Certaines combinaisons de périodes de tarification ne sont pas prises en charge pour les abonnements à intervalles mixtes.

• Exemples de combinaisons de périodes prises en charge :

  • 1 mois, 3 mois
  • 1 mois, 1 an
  • 1 jour, 1 semaine
  • 1 jour, 3 mois
  • 1 jour, 2 ans
  • 2 semaines, 4 semaines
  • 2 mois, 4 mois, 6 mois

• Exemples de combinaisons de périodes non prises en charge :

  • 2 mois, 3 mois
  • 4 mois, 6 mois
  • 1 semaine, 1 mois
  • 2 jours, 1 semaine
  • 5 mois, 1 an

Limitations

Les abonnements à intervalles mixtes sont soumis aux limitations suivantes :

• Le paramètre obsolète cancel_at_period_end ne peut pas détecter la date d’annulation current_period_end du poste d’abonnement à utiliser. Sa valeur par défaut est donc min_period_end. Alternativement :
  • Utilisez le paramètre cancel_at pour annuler un abonnement à une date ultérieure.
  • Utilisez les assistants min_period_end ou max_period_end pour déterminer quel poste déclenche l’annulation de l’abonnement.
• Les abonnements à intervalles mixtes ne permettent pas de calculer avec précision le total des itérations. Utilisez plutôt duration pour spécifier la planification d’abonnement.
• Vous ne pouvez pas appliquer un bon de réduction de rétention sur des abonnements à intervalles mixtes via le portail client.
• À l’heure actuelle, vous ne pouvez pas créer d’abonnements à intervalles mixtes sur Checkout Sessions.