Gérer votre configuration de facturation à la consommation

Après avoir créé votre modèle de facturation à la consommation, vous avez la possibilité de modifier certaines composantes de votre configuration de facturation. Par exemple, vous pouvez mettre à jour le tarif d’un poste d’abonnement au cours d’un cycle de facturation, antidater un abonnement pour comptabiliser l’utilisation dans la prochaine facture ou annuler des abonnements facturés à la consommation.

Mettre à jour les tarifs en cours de cycle

Vous pouvez mettre à jour le prix d’un poste d’abonnement au cours d’un cycle de facturation.

Avec les abonnements de type billing_mode=flexible, nous créons un poste de facture qui facture la consommation précédemment enregistrée lorsque vous supprimez un tarif à l’usage d’un abonnement.

Par exemple, imaginons que vous ayez un abonnement mensuel et que vous passiez du tarif A au tarif B le 16 janvier. Le 16 janvier, nous créons un poste de facture correspondant à la quantité consommée entre le 1er janvier et le 16 janvier. Au renouvellement de l’abonnement le 1er février, nous facturons au tarif B pour la période allant du 16 janvier au 1er février.

Les proration_behavior que vous spécifiez lors de la suppression d’un tarif à l’usage ont une incidence sur ces postes de facture. Si vous souhaitez supprimer un tarif à l’usage sans le facturer, définissez proration_behavior sur none.

Avec les abonnements billing_mode=classic, les limitations suivantes s’appliquent lors du passage d’un tarif facturé à l’usage à un autre.

Sur les prochaines factures, nous ne reflétons que l’utilisation qui a lieu après la mise à jour. Par exemple, imaginons que vous ayez un abonnement mensuel et que vous passiez du tarif A au tarif B le 16 janvier. À la fin du mois, la facture comptabilise l’utilisation du 16 au 31 janvier au tarif B. L’utilisation du 1er au 16 janvier n’est pas facturée.

Il existe une exception si vous utilisez des seuils de facturation et qu’une facture seuil a déjà été générée à l’ancien tarif. Par exemple, supposons que vous génériez une facture seuil le 10 janvier avec le tarif A. Vous facturez tout de même cette facture seuil au client. À la fin du mois, la facture comptabilise l’utilisation du 16 au 31 janvier au tarif B. La facture seuil antérieure ne compense aucune utilisation pour cette facture de fin de mois.

Des restrictions similaires s’appliquent si vous ajoutez un nouveau poste d’abonnement avec une tarification à la consommation au cours du cycle d’abonnement. Par exemple, supposons que vous ajoutez un nouveau poste d’abonnement au tarif C le 16 janvier. La facture générée à la fin du mois comptabilise l’utilisation du 16 au 31 janvier au tarif C pour ce poste d’abonnement.

Pour capturer l’utilisation précédemment communiquée lors d’un changement de tarif, choisissez l’une des options suivantes :

• Communiquez à nouveau l’utilisation agrégée pour la capturer dans le cycle sur le nouveau tarif.
• Réinitialisez le paramètre billing_cycle_anchor sur now, en appliquant l’ancien tarif à l’usage précédemment enregistré.

Pour mettre à jour le tarif d’un poste d’abonnement :

curl https://api.stripe.com/v1/subscription_items/{{SUBSCRIPTION_ITEM_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d price={{NEW_PRICE_ID}}

Pour supprimer un poste d’abonnement :

curl -X DELETE https://api.stripe.com/v1/subscription_items/{{SUBSCRIPTION_ITEM_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Après la suppression, la facture ne reflète pas l’utilisation de ce poste.

Créer un abonnement antidaté

Vous pouvez enregistrer l’utilisation d’un client avant même de créer lui créer un abonnement. Après avoir enregistré l’utilisation d’un client, utilisez le paramètre backdate_start_date pour créer un abonnement avant la génération du premier rapport.

Avec les abonnements billing_mode=flexible, la première facture d’abonnement inclut cette utilisation antidatée.

Avec les abonnements billing_mode=classic, la prochaine facture d’abonnement, générée au renouvellement du cycle, inclut cette utilisation antidatée.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]"={{PRICE_ID}} \
  -d backdate_start_date=1710000000

Annuler des abonnements facturés à la consommation

Avec la facturation à la consommation, le montant que le client paie varie en fonction de la quantité consommée durant le cycle de facturation. Si la modification du cycle de facturation provoque la fin anticipée d’un intervalle d’abonnement, vous facturez le client pour l’utilisation cumulée au cours du cycle de facturation écourté.

Vous ne pouvez pas réactiver les abonnements annulés. Vous pouvez toutefois collecter les informations de facturation actualisées de votre client, mettre à jour son moyen de paiement par défaut et créer un nouvel abonnement à partir du dossier client existant.

Si vous utilisez cancel_at_period_end pour planifier l’annulation d’un abonnement, vous pouvez réactiver l’abonnement à tout moment jusqu’à la fin de la période. Pour ce faire, définissez cancel_at_period_end sur false.

Pour les abonnements annulés à la fin de la période, la facture finale au terme du cycle inclut l’utilisation mesurée du dernier cycle de facturation.