# Annuler des abonnements Annulez les abonnements immédiatement, à la fin d’une période de facturation ou à une date personnalisée, et gérez les prorata et les factures finales. Les clients peuvent également gérer leurs abonnements, factures et informations de facturation via la [page d’annulation du portail client](https://docs.stripe.com/customer-management/cancellation-page.md) hébergée par Stripe. Ce guide explique comment gérer les abonnements des clients à l’aide de l’[API Subscription](https://docs.stripe.com/api.md#cancel_subscription) ou du [Dashboard](https://dashboard.stripe.com/test/subscriptions). Si vous souhaitez conserver u abonnement actif, mais cesser temporairement d’encaisser les paiements, vous pouvez [suspendre l"encaissement des paiements](https://docs.stripe.com/billing/subscriptions/pause-payment.md). Cette opération n’affecte pas l’[état de l’abonnement](https://docs.stripe.com/billing/subscriptions/overview.md#subscription-statuses). Nous vous recommandons d’utiliser cette ce dernier pour activer ou désactiver les services auxquels vos clients ont accès. Les *Subscriptions* s’annulent automatiquement après jusqu’à huit tentatives infructueuses de facture du client. Vous pouvez configurer le nombre de tentatives dans les [paramètres d’abonnement](https://dashboard.stripe.com/settings/billing/automatic) de votre Dashboard. En savoir plus sur les paramètres de recouvrement de revenus, tels que les [Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md#smart-retries) et les [e-mails client](https://docs.stripe.com/billing/revenue-recovery/customer-emails.md#configure-emails) configurables. ## Annuler des abonnements Vous pouvez annuler les abonnements des clients manuellement avec la [méthode Cancel a Subscription](https://docs.stripe.com/api/subscriptions/cancel.md) ou dans le [Dashboard](https://dashboard.stripe.com/test/subscriptions). Par défaut, l’annulation prend effet immédiatement et les *factures* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) ne sont plus générées pour les abonnements annulés. Une fois l’abonnement annulé, vous ne pouvez plus le mettre à jour, à l’exception de ses [metadata](https://docs.stripe.com/metadata.md) et `cancellation_details`. > Si vous définissez une date d’annulation personnalisée, vous ne pouvez pas effectuer de remboursement. Vous ne pouvez empêcher la génération d’un avoir au prorata que si la date `cancel_at` se situe dans la période de facturation en cours. Si vous annulez l’abonnement à une date située en dehors de la période en cours, vous ne pouvez pas désactiver le prorata. #### Dashboard Pour annuler un abonnement dans le Dashboard : 1. Sur la page [Abonnements](https://dashboard.stripe.com/subscriptions), recherchez l’abonnement concerné, cliquez sur le menu de débordement (⋯) et sélectionnez **Annuler l’abonnement**. 2. Choisissez quand mettre fin à l’abonnement : immédiatement, à la fin de la période ou à une date personnalisée. 3. Vous pouvez alors choisir entre rembourser un montant [au prorata](https://docs.stripe.com/billing/subscriptions/prorations.md), rembourser la totalité du dernier paiement, ou ne rien [rembourser](https://docs.stripe.com/refunds.md). 4. Une fois la configuration terminée, cliquez sur **Annuler l’abonnement**. #### API Pour annuler un abonnement à l’aide de l’API : ```curl curl -X DELETE https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" ``` ### Facturer au prorata selon l’utilisation Si un abonnement se trouve en cours de période de facturation payée, vous pouvez appliquer une facturation au prorata à l’annulation en transmettant le paramètre de la [facturation au prorata](https://docs.stripe.com/api/subscriptions/cancel.md#cancel_subscription-prorate). Lorsque vous facturez un abonnement annulé au prorata, vous pouvez inclure : - Les calculs au prorata impayés - [Calcul de la consommation](https://docs.stripe.com/products-prices/pricing-models.md#usage-based-pricing) 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](https://docs.stripe.com/api/subscriptions/cancel.md#cancel_subscription-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](https://support.stripe.com/questions/refunding-credit-balance-to-customer-after-subscription-downgrade-or-cancellation), émettez des [remboursements](https://docs.stripe.com/refunds.md#issuing), puis remettez le [solde de son compte](https://docs.stripe.com/billing/customer/balance.md#modifying) à zéro. ### Résilier à la fin de la période 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 curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -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. ### Résilier après des modifications planifiées ou de futures périodes de facturation Pour programmer la fin d’un abonnement après un nombre défini de périodes de facturation, [créez une planification d’abonnement](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md). Définissez la durée de la planification en indiquant une ou plusieurs phases et intervalles, puis définissez son paramètre [end_behavior](https://docs.stripe.com/api/subscription_schedules/create.md#create_subscription_schedule-end_behavior) sur `cancel`. Avec un comportement de fin défini sur `cancel`, les planifications d’abonnement gèrent automatiquement l’attribut [cancel_at](https://docs.stripe.com/billing/subscriptions/cancel.md#custom-cancel-date) de l’abonnement. Lorsque la planification se trouve dans sa dernière phase, la date d’annulation de l’abonnement est définie sur la date de fin de cette phase. Sinon, aucune date d’annulation n’est définie pour l’abonnement. Par conséquent, ajouter une nouvelle phase à une planification qui se trouve actuellement dans sa dernière phase supprime la date d’annulation. Si l’abonnement se trouve dans sa dernière période de facturation lorsque vous prolongez ou supprimez la date d’annulation, la date de fin de période et la date de référence du cycle de facturation peuvent être mises à jour. Pour en savoir plus, consultez [Définir une date d’annulation personnalisée](https://docs.stripe.com/billing/subscriptions/cancel.md#custom-cancel-date). ### Configurer l’annulation automatique après un litige > #### Assistance limitée > > Cette fonctionnalité prend uniquement en charge les paiements par carte bancaire faisant l’objet d’un litige portant sur la totalité du montant. L’annulation automatique après un litige ne fonctionne pas avec les [horloges de simulation](https://docs.stripe.com/billing/testing.md#simulate-subscriptions). Lorsqu’un client [conteste](https://docs.stripe.com/disputes.md) 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](https://dashboard.stripe.com/settings/billing/automatic). Comptez environ une heure pour que les modifications soient prises en compte. Sous [Gérer les paiements contestés](https://dashboard.stripe.com/settings/billing/automatic), sélectionnez l’une des options suivantes. - **Annuler l’abonnement immédiatement sans prorata** : l’abonnement est annulé immédiatement, sans prorata. Vous ne pouvez pas réactiver un abonnement annulé. Vous devez créer un nouvel abonnement pour le client si vous souhaitez continuer à le facturer. - **Annuler l’abonnement à la fin de la période** : l’abonnement est annulé à la fin de la période de facturation en cours et l’attribut [cancel_at_period_end](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-cancel_at_period_end) est défini sur `true`. Vous disposez ainsi de temps pour traiter le litige avant l’annulation. Pour les abonnements gérés par des [planifications](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md), 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](https://docs.stripe.com/billing/invoices/subscription.md#adding-draft-invoice-items) 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](https://docs.stripe.com/api.md#delete_invoiceitem). De même, toute [utilisation](https://docs.stripe.com/billing/subscriptions/usage-based/recording-usage.md) 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](https://docs.stripe.com/api.md#update_subscription-items-clear_usage) afin de [modifier l’abonnement](https://docs.stripe.com/api.md#update_subscription) 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](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection.md) 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. ## Utilisez Workflows pour supprimer les postes de facture en attente Pour supprimer les postes de facture en attente après l’annulation d’un abonnement, sans écrire de code, utilisez le modèle [Supprimer les postes de facture en attente après l’annulation de l’abonnement](https://dashboard.stripe.com/workflows/create?workflow=eyJkZWVwX2xpbmtfdmVyc2lvbiI6MSwibmFtZSI6IkRlbGV0ZSBwZW5kaW5nIGludm9pY2UgaXRlbXMgYWZ0ZXIgc3Vic2NyaXB0aW9uIGNhbmNlbGxhdGlvbiIsImRlZmluaXRpb24iOiJDb0VERW5VS0VteHBjM1JmYVc1MmIybGpaVjlwZEdWdGN4QUJHbDBLSTNOMGNtbHdaUzVoY0dsZlkyRnNiRjluWlhSZmRqRmZhVzUyYjJsalpXbDBaVzF6RWpZS0pRb0lZM1Z6ZEc5dFpYSVNHUm9YSkh0N0lIUnlhV2RuWlhJdVkzVnpkRzl0WlhJZ2ZYMEtEUW9IY0dWdVpHbHVaeElDSUFFUzN3RUtDR1p2Y2w5bFlXTm9FQVF5MEFFS0dITjBaWEJ6TG14cGMzUmZhVzUyYjJsalpWOXBkR1Z0Y3hnQklyRUJDZ1ppY21GdVkyZ1FBeXFrQVFxaEFRbzhhWFJsYlM1d1lYSmxiblF1YzNWaWMyTnlhWEIwYVc5dVgyUmxkR0ZwYkhNdWMzVmljMk55YVhCMGFXOXVJRDA5UFNCMGNtbG5aMlZ5TG1sa0VtRUtGbVJsYkdWMFpWOWhibDlwYm5admFXTmxYMmwwWlcwUUFScEZDaWx6ZEhKcGNHVXVZWEJwWDJOaGJHeGZaR1ZzWlhSbFgzWXhYMmx1ZG05cFkyVnBkR1Z0YzE5cFpCSVlDaFlLQW1sa0VoQWFEaVI3ZXlCcGRHVnRMbWxrSUgxOUdpWUlBaElpQ2gxamRYTjBiMjFsY2k1emRXSnpZM0pwY0hScGIyNHVaR1ZzWlhSbFpCb0JBUklSTWpBeU5pMHdPUzB6TUM1bGJtUnBkbVUiLCJzdHJpcGVfYXBpX3ZlcnNpb24iOiIyMDI2LTA5LTMwLmVuZGl2ZSJ9) dans [Workflows](https://docs.stripe.com/workflows.md). Le workflow s’exécute lorsque l’abonnement prend fin et supprime uniquement ses postes de facture en attente. ## Identifier les événements d’annulation Stripe envoie les événements suivants pour les abonnements annulés. | Événement | Description | | --- | --- | | `customer.subscription.updated` | Envoyé pour toute mise à jour d’abonnement, y compris lorsque `cancel_at_period_end` est défini sur `true`. | | `customer.subscription.deleted` | Envoyé lors de l’annulation d’un abonnement. L’annulation peut résulter d’un appel direct à supprimer l’abonnement ou peut survenir lorsqu’un abonnement avec `cancel_at_period_end: true` atteint la fin de sa période de facturation. | ## Mettre fin à une annulation en attente Vous pouvez annuler une résiliation programmée via l’[API Update Subscription](https://docs.stripe.com/api/subscriptions/update.md) ou dans le [Dashboard](https://dashboard.stripe.com/test/subscriptions). Il est impossible de réactiver un abonnement résilié. #### Dashboard Pour arrêter une résiliation programmée dans le Dashboard : 1. Sur la page [Abonnements](https://dashboard.stripe.com/subscriptions), sélectionnez l’abonnement que vous souhaitez mettre à jour. 2. Sur la page Détails de l’abonnement, cliquez sur le menu de débordement (⋯), puis sélectionnez **Ne pas annuler**. #### API Pour annuler une résiliation programmée à l’aide de l’API, attribuez la valeur `false` à l’attribut `cancel_at_period_end`. Cette action affecte uniquement les abonnements qui n’ont pas atteint la fin de leur période de facturation. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d cancel_at_period_end=false ``` > Avant la version du [28/02/2018](https://docs.stripe.com/upgrades.md#2018-02-28), *tout* paramètre envoyé à l’API [Update Subscription](https://docs.stripe.com/api/subscriptions/update.md) annule toute résiliation en attente. ## Définir une date de résiliation personnalisée Le paramètre [cancel_at](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-cancel_at) permet d’annuler un abonnement à une date ultérieure. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -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](https://docs.stripe.com/api/subscription_item/object.md#subscription_item_object-current_period_end) du poste d’abonnement est mis à jour 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](https://docs.stripe.com/billing/subscriptions/prorations.md#disable-prorations) les calculs au prorata. > Lorsque `cancel_at` raccourcit la période de facturation en cours, la [désactivation des proratas](https://docs.stripe.com/billing/subscriptions/prorations.md#disable-prorations) peut avoir des effets différents sur les lignes de facture en fonction du [mode de facturation](https://docs.stripe.com/billing/subscriptions/billing-mode.md) de l’abonnement. Pour plus d’informations, consultez la [Comparaison des modes de facturation](https://docs.stripe.com/billing/subscriptions/billing-mode/compare.md#excluding-prorations-for-the-first-truncated-billing-period). Pour les abonnements `billing_mode=flexible` avec `status=trialing`, l’ajout, la mise à jour ou la suppression de la valeur `cancel_at` n’affecte pas la date de fin de l’essai [trial_end](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-trial_end). Pour les abonnements qui utilisent [billing_mode](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-04-30.preview#create_subscription-billing_mode), vous pouvez avoir recours à des assistants d’énumération avec le paramètre `cancel_at` pour simplifier l’annulation d’un abonnement à la fin d’une période de facturation. Les assistants `min_period_end` et `max_period_end` vous permettent de préciser le moment de l’annulation d’un abonnement en fonction des périodes de facturation pour tous les postes d’abonnement. | Événement | Description | | --- | --- | | `min_period_end` | Sélectionne l’horodatage de la période de facturation qui se termine en premier. | | 'max`max_period_end` | Sélectionne l’horodatage de la période de facturation qui se termine en dernier. | Ces assistants résolvent immédiatement les horodatages, ce qui réduit le risque que des modifications ultérieures du `current_period_end` d’un poste affectent l’horodatage résolu pour l’annulation. Si vous programmez une date d’annulation située à plus d’une période de facturation, le cycle de l’abonnement reste inchangé jusqu’au renouvellement de l’abonnement dans la période contenant la date `cancel_at`. Lors de ce renouvellement, la valeur `items.current_period_end` est alors raccourcie pour correspondre à la date `cancel_at`. Dans ce cas, il n’est pas possible de [désactiver les calculs au prorata](https://docs.stripe.com/billing/subscriptions/prorations.md#disable-prorations). Par exemple, votre client souscrit un abonnement à montant prédéterminé de 120 USD par an, qui se renouvelle le 1er janvier 2024. Il a configuré l’abonnement de manière à ce qu’il soit annulé le 1er juillet 2024. Le sous-total final de la facture au 1er janvier est donc de 60 USD et la date `items.current_period_end` est au 1er juillet. Modifier, ajouter ou supprimer une date d’annulation programmée au cours de la période en cours met à jour `items.current_period_end` et crée des prorata. Dans l’exemple précédent, le 15 février, vous déplacez la date d’annulation au 1er octobre. La fin de la période en cours passe au 1er octobre et Stripe crée des prorata de 30 USD pour le trimestre supplémentaire. Pour facturer immédiatement les éléments au prorata au lieu de les inclure dans une facture finale le 1er octobre, définissez [proration_behavior](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-proration_behavior) sur `always_invoice` dans la mise à jour, ou [créez séparément une facture ponctuelle](https://docs.stripe.com/billing/invoices/subscription.md#generating-invoices). ## Annulation avec la date de début du cycle de facturation La propriété de [début du cycle de facturation](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_cycle_anchor) de l’abonnement peut changer si elle se réfère à la date d’annulation précédente. Au cours de la première période, Stripe conserve la date de début de cycle que vous aurez [initialement définie](https://docs.stripe.com/billing/subscriptions/billing-cycle.md#new-subscriptions) pour 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 se réinitialise au [début de la période en cours](https://docs.stripe.com/api/subscription_items/object.md#subscription_item_object-current_period_start). Cette réinitialisation du comportement de début du cycle de facturation n’est garantie que pour les abonnements créés après juin 2024. Les abonnements créés avant cette date peuvent présenter l’ancien comportement selon lequel la propriété de [début du cycle de facturation](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_cycle_anchor) reste inchangée après la suppression ou la prolongation de l’annulation. Ajouter une date d’annulation ou avancer une date existante définit la [date de référence du cycle de facturation](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_cycle_anchor) sur la nouvelle date d’annulation. Dans l’exemple de la section [Définir une date d’annulation personnalisée](https://docs.stripe.com/billing/subscriptions/cancel.md#custom-cancel-date), le 15 février, vous avancez la date d’annulation au 1er avril. La fin de la période et la date de référence du cycle de facturation passent au 1er avril, et Stripe crée des prorata de -30 USD pour créditer votre client du temps non utilisé du 1er avril au 1er juillet. ## See also - [Utiliser les périodes d’essai](https://docs.stripe.com/billing/subscriptions/trials.md)