C’est la seule modification possible sur un abonnement existant. Il n’y a pas de changement
de prix, ni d’ajout ou de retrait de ligne : pour cela, annulez et recréez.
Autorisé sur un abonnement active ou trialing seulement.
Ce qui se passe
La quantité est mise à jour immédiatement : le prochain cycle est facturé sur la nouvelle
quantité. Ce qui se passe pour le cycle en cours dépend de l’état :
La facture de prorata n’est jamais prélevée automatiquement. Elle est créée open, sans
numéro, sans envoi d’e-mail et sans lien de paiement, et aucune demande de paiement ne part.
Elle apparaît dans GET /v1/subscriptions/{id}/invoices. Si vous voulez encaisser le prorata,
c’est à vous de le facturer par un autre moyen ; si vous ne le voulez pas, ignorez-la.
Une baisse en cours de période ne crédite rien. Le message de réponse annonce un crédit
« sur la prochaine facture » ; ce crédit n’est pas implémenté. Le client paie le cycle en cours
sur l’ancienne quantité, et le suivant sur la nouvelle.
La réponse
prorationAmount et prorationInvoice sont absents quand aucun prorata ne s’applique.
prorationAmount est négatif sur une baisse (sans prorationInvoice).
Simuler avant de modifier
GET /v1/subscriptions/{id}/upcoming-invoice?subscription_item_id=si_...&quantity=3 rend
l’aperçu du prorata sans rien écrire. Voir Factures.
Aucun événement
Ce changement n’émet aucun webhook — ni subscription.updated, ni invoice.*. Il est
consigné dans l’historique interne de l’abonnement (events[] du détail, type
quantity_updated).
Erreurs
