Calculs au prorata

The most complex aspect of changing existing subscriptions are prorations, where the customer is charged a percentage of a subscription’s cost to reflect partial use. This page explains how prorations work with subscriptions and how to manage prorations for your customers.

Fonctionnement des prorata

Par exemple, la mise à niveau ou le retour à un abonnement inférieur peuvent entraîner des paiements au prorata. Si un client met à niveau son plan, en passant de 10 USD par mois à 20 USD par mois, un montant au prorata correspondant au temps passé sur chaque option sera facturé. Si la modification s’est produite au milieu du cycle de facturation, le client est facturé 5 USD supplémentaires : -5 USD pour la période non consommée facturée au tarif initial et 10 USD pour la période restante facturée au nouveau tarif.

Le calcul au prorata permet de facturer les clients de manière précise, mais un calcul au prorata peut entraîner des montants de paiement différents de ceux attendus. Les résultats négatifs ne sont pas automatiquement remboursés et les résultats positifs ne sont pas facturés immédiatement, bien qu’il soit possible d’effectuer ces deux actions manuellement.

Vous pouvez prévisualiser un calcul au prorata pour afficher le montant avant d’appliquer les modifications.

Calculs au prorata et réductions

Any adjustments from discounts are reflected in the proration invoice item’s amount. Additional discounts at the invoice item level or invoice line item level don’t apply to prorations because they have discountable=false.

This behavior is different from non-prorations, which show discount adjustments in discount_amounts.

Déclencheurs de prorata

Les scénarios suivants entraînent par défaut un calcul au prorata :

• Remplacement du prix par un autre avec un coût de base différent
• Remplacement du prix par un autre avec un intervalle de facturation différent
• Ajout d’une période d’essai à un abonnement actif
• Modification de la quantité
• Les abonnements sous licence (par utilisateur) (car ils sont facturés au début de chaque période de facturation)

Création manuelle de vos calculs au prorata

Pour calculer vos propres prorata en dehors de Stripe et les ajouter à l’abonnement, transmettez add_invoice_items avec des unit_amount négatifs (égaux au montant calculé au prorata) aux endpoints suivants :

• CreateSubscription
• UpdateSubscription
• CreateSubscriptionSchedule
• UpdateSubscriptionSchedule

Moment d’application des prorata

Les calculs au prorata s’appliquent uniquement aux paiements qui ont lieu en amont du cycle de facturation. La facturation à l’usage n’est pas soumise au calcul au prorata.

Le montant au prorata est calculé dès que l’API met à jour l’abonnement. Le début et la fin de la période de facturation en cours sont utilisés pour calculer le coût de l’abonnement avant et après la modification.

Taxes et calculs au prorata

Pour en savoir plus sur le fonctionnement des taxes avec les calculs au prorata, veuillez consulter la page Collecter des taxes pour les paiements récurrents.

Prévisualiser un calcul au prorata

Vous pouvez récupérer une facture à venir pour prévisualiser les modifications apportées à un abonnement. Cette API ne modifie pas l’abonnement, elle renvoie la facture à venir uniquement en fonction des paramètres que vous transmettez. La modification de price ou de quantity entraîne un calcul au prorata. Cet exemple modifie le price et définit une date pour le paiement au prorata.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

# Set proration date to this moment:
proration_date = Time.now.to_i

subscription = Stripe::Subscription.retrieve('sub_49ty4767H20z6a')

# See what the next invoice would look like with a price switch
# and proration set:
items = [{
  id: subscription.items.data[0].id,
  price: 'price_CBb6IXqvTLXp3f', # Switch to new price
}]

invoice = Stripe::Invoice.upcoming({
  customer: 'cus_4fdAW5ftNQow1a',
  subscription: 'sub_49ty4767H20z6a',
  subscription_items: items,
  subscription_proration_date: proration_date,
})

Vous pouvez développer l’exemple de réponse ci-dessous pour afficher :

• Le crédit pour la période non consommée facturée au tarif précédent aux lignes 36-38.
• Le coût pour la période écoulée au nouveau tarif aux lignes 107-109.
• Le nouveau sous-total et total de la facture aux lignes 276-279.

{
  "account_country": "US",
  "account_name": "Test account",
  "amount_due": 3627,
  "amount_paid": 0,
  "amount_remaining": 3627,
  "application_fee_amount": null,
  "attempt_count": 0,
  "attempted": false,
  "billing_reason": "upcoming",

Utilisez ces informations pour confirmer les modifications avec le client avant de modifier l’abonnement. Puisque Stripe facture au prorata le second élément, le montant au prorata peut changer entre le moment de l’aperçu et le moment de la mise à jour. Pour éviter cela, transmettez une subscription_proration_date dans la facture lorsque vous prévisualisez une modification. Lorsque vous mettez à jour l’abonnement, transmettez la même date avec le paramètre proration_date dans un abonnement, afin que le montant au prorata soit calculé au même moment.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

subscription = Stripe::Subscription.update(
  'sub_49ty4767H20z6a',
  {
    items: [
      {
        id: subscription.items.data[0].id,
        price: 'price_CBb6IXqvTLXp3f',
      },
    ],
    proration_date: proration_date,
  }
)

Désactiver les calculs au prorata

La tarification au prorata est contrôlée par le paramètre proration_behavior, défini par défaut sur create_prorations.

Pour désactiver les calculs au prorata par requête, définissez le paramètre proration_behavior sur none. Il n’existe aucun paramètre qui désactive tous les calculs au prorata futurs pour un abonnement. Pour désactiver les calculs au prorata indéfiniment, définissez proration_behavior sur none pour chaque requête générant des calculs au prorata :

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "items[0][id]"="si_1AkFf6LlRB0eXbMtRFjYiJ0J" \
  -d "items[0][price]"="price_CBb6IXqvTLXp3f" \
  -d "proration_behavior"="none"

Lorsque les calculs au prorata sont désactivés, les clients doivent payer le montant total au nouveau tarif lorsque la facture suivante est générée.