Annuler des abonnements

Ce guide explique comment gérer les abonnements des clients à l’aide de l’API Subscription ou du Dashboard.

Si vous souhaitez conserver u abonnement actif, mais cesser temporairement d’encaisser les paiements, vous pouvez suspendre l"encaissement des paiements. Cette opération n’affecte pas l’état de l’abonnement. Nous vous recommandons d’utiliser cette ce dernier pour activer ou désactiver les services auxquels vos clients ont accès.

Les abonnements sont annulés automatiquement au bout de huit tentatives de paiement en échec. Vous pouvez configurer le nombre de tentatives dans les paramètres du cycle de vie de vos abonnements. En savoir plus sur les paramètres de recouvrement des revenus, tels que les Smart Retries et les envois d’e-mails configurables aux clients.

Annuler des abonnements

Vous pouvez annuler les abonnements des clients manuellement via l’API ou le Dashboard. Par défaut, l’annulation prend effet immédiatement et l’abonnement ainsi résilié ne génère plus aucune facture. Une fois annulé, vous ne pouvez plus mettre à jour l’abonnement ou ses métadonnées.

Facturer au prorata selon l’utilisation

Pour annuler un abonnement au cours d’une période de facturation, vous pouvez émettre une facture au prorata en transmettant le paramètre prorate.

Lorsque vous facturez un abonnement annulé au prorata, vous pouvez inclure :

• Les calculs au prorata impayés
• Calcul de la consommation

Si vous ne facturez pas l’abonnement au prorata, l’utilisation calculée est ignorée et le client ne reçoit aucun crédit pour d’éventuels calculs au prorata.

Créez immédiatement une facture finale à l’aide du paramètre invoice_now. Si vous devez des fonds au client après l’annulation, vous pouvez ajouter le montant correspondant à son solde créditeur pour l’appliquer à des factures ultérieures. Pour rembourser votre client, émettez des remboursements, puis remettez le solde de son compte à zéro.

Annuler un abonnement à la fin du cycle de facturation en cours

Pour annuler un abonnement à la fin de la période de facturation en cours, attribuez la valeur true à cancel_at_period_end :

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d cancel_at_period_end=true

Cela permet à l’abonnement de terminer la période déjà payée par le client. Vous pouvez réactiver les abonnements dont l’annulation est programmée en attribuant la valeur false à cancel_at_period_end. Vous pouvez réactiver l’abonnement à tout moment, tant que la période n’est pas terminée.

Annuler après des modifications programmées ou des cycles de facturation futurs

Pour planifier la fin d’un abonnement après un nombre spécifié de cycles de facturation, créez une planification d’abonnement. Définissez la durée de la programmation en spécifiant une ou plusieurs phases et intervalles, et définissez son attribut end_behavior sur cancel.

Avec un comportement de fin d’abonnement de type cancel, les planifications d’abonnement gèrent automatiquement l’attribut cancel_at de l’abonnement. Lorsque la planification est dans sa dernière phase, la date d’annulation de l’abonnement est fixée à la date de fin de la phase, sinon la date d’annulation n’est pas définie pour l’abonnement.

Par conséquent, l’ajout d’une nouvelle phase à une planification qui est actuellement dans sa dernière phase supprime la date d’annulation. Si l’abonnement est dans sa dernière période de facturation au moment de la prolongation ou de la suppression de la date d’annulation, cela peut modifier la date de fin de la période et la date de début du cycle de facturation. Pour en savoir plus, découvrez comment définir une date d’annulation personnalisée.

Configurer l’annulation automatique après un litige

Lorsqu’un client conteste un paiement dans le cadre d’un abonnement, cet abonnement continue son cycle, ce qui risque d’engendrer de nouvelles contestations de paiements. Si vous préférez que l’abonnement soit annulé dans ce cas de figure, vous pouvez configurer ce comportement dans le Dashboard. Comptez environ une heure pour que les modifications soient prises en compte.

Sous Gérer les paiements contestés, sélectionnez l’une des options suivantes.

• Annuler l’abonnement immédiatement sans calcul au prorata : l’abonnement sera annulé immédiatement sans prorata. Il est impossible de réactiver un abonnement annulé. Il faudra donc en créer un nouveau si vous souhaitez continuer facturer le client.

• Annuler l’abonnement à la fin de la période : l’abonnement sera annulé à la fin de la période de facturation en cours et la valeur de l’attribut cancel_at_period_end sera définie sur true. Vous disposerez ainsi d’un peu plus de temps pour tenter de résoudre le litige avant une éventuelle résiliation.

Pour les abonnements gérés par des planifications, l’abonnement est d’abord détaché du calendrier avant d’être résilié. Le reste des modifications planifiées ne s’appliquera donc pas.

Gérer les postes de facture lors de l’annulation d’un abonnement

Votre client sera susceptible d’être facturé pour d’éventuels postes de facture en attente sur un abonnement dans les cas suivants :

• L’annulation de l’abonnement implique une facture finale
• Votre client a un autre abonnement actif

Pour éviter de facturer des postes de facture en attente à votre client, vous devez les supprimer manuellement.

De même, toute utilisation enregistrée pendant la période de facturation sera facturée à la fin de cette période. Pour ne pas effectuer de paiement final de l’utilisation, utilisez le paramètre clear_usage afin de modifier l’abonnement et de supprimer le tarif à la consommation.

Si vous avez paramétré l’annulation automatique de l’abonnement à la fin de la période, tout paiement au prorata en attente sera maintenu et encaissé à la fin de la période. Si vous annulez l’abonnement avant la fin de la période, les postes de facture seront conservés et ne seront pas traités, sauf si vous générez une facture spécifiquement pour eux.

Lorsque vous annulez un abonnement, la propriété auto_advance de toutes les factures à l’état open ou draft de cet abonnement reçoit la valeur false. Cela suspend le recouvrement automatique de ces factures et empêche l’envoi d’e-mails de rappel automatiques. Vous conservez cependant la possibilité d’encaisser des paiements ou d’envoyer des e-mails manuellement.

Identifier les événements d’annulation

Stripe envoie les événements suivants pour les abonnements annulés.

Mettre fin à une annulation en attente

Vous pouvez annuler une résiliation programmée via l’API Update Subscription ou dans le Dashboard. Il est impossible de réactiver un abonnement résilié.

Définir une date de résiliation personnalisée

Le paramètre cancel_at permet d’annuler un abonnement à une date ultérieure.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d cancel_at=1723766400

Si la résiliation doit se produire avant la fin de la période de facturation, le paramètre current_period_end de l’abonnement est modifié de façon à correspondre à la date cancel_at. Cela crée un calcul au prorata associé à la modification de la période en cours, sauf si votre modification désactive les calculs au prorata.

Si la résiliation doit se produire dans plus d’une période de facturation, le cycle de l’abonnement demeure identique jusqu’à ce que l’abonnement arrive dans la période qui contient la date cancel_at. La valeur current_period_end du renouvellement est ensuite raccourcie de manière à correspondre à la date cancel_at.

Par exemple, votre client souscrit un abonnement de 120 USD par an, avec renouvellement au 1er janvier 2024. Il configure l’abonnement pour qu’il soit annulé le 1er juillet 2024. Le sous-total de la facture finale au 1er janvier s’élève à 60 USD et la current_period_end est fixée au 1er juillet.

La modification, l’ajout ou la suppression d’une date de résiliation programmée dans la période en cours met à jour l’attribut current_period_end et crée un calcul au prorata. Dans l’exemple ci-dessus, vous effectuez une modification le 15 février, pour programmer la résiliation au 1er octobre. La date de fin de la période en cours devient le 1er octobre et Stripe crée un calcul au prorata de 30 USD pour le trimestre supplémentaire. Si vous souhaitez facturer immédiatement les éléments au prorata, plutôt que dans la facture finale du 1er octobre, transmettez un attribut proration_behavior de always_invoice lors de votre modification ou créez une facture ponctuelle séparément.

La propriété de début du cycle de facturation de l’abonnement peut changer si elle a suivi la date d’annulation précédente. Au cours de la première période, Stripe conserve toute date de début que vous avez définie initialement sur l’abonnement. Lorsque la première période est terminée, ou si vous n’avez pas indiqué de date de début personnalisée lors de la création de l’abonnement, la date de début est réinitialisée au début de la période en cours.

L’ajout d’une date d’annulation ou l’avancement d’une date par rapport à la date actuelle avance le début du cycle de facturation pour qu’il corresponde à la nouvelle date d’annulation. Dans l’exemple ci-dessus, le 15 février, vous modifiez la date d’annulation au 1er avril. La fin de la période et le début du cycle de facturation passent au 1er avril, et Stripe crée un calcul au prorata d’un montant de -30 USD afin de créditer votre client pour le temps non utilisé du 1er avril au 1er juillet.