Mettre en pause des abonnements sur Paddle Billing
La pause sur Paddle Billing : l’opération pause, effective_from, resume_at, options on_resume, cas des impayés, webhooks et offres de pause dans Retain.
Certains clients ne veulent pas partir ; ils veulent faire une pause. Une activité saisonnière, un projet en suspens, un trimestre serré. Si la résiliation est la seule option, ils la prennent, et les faire revenir plus tard coûte un nouveau checkout et souvent une remise. Une pause garde l’abonnement, la fiche client et le moyen de paiement, et leur offre un chemin de retour facile.
Paddle Billing prend en charge la pause nativement, via l’API et via les parcours d’annulation de Paddle Retain. Ce guide explique comment cela fonctionne, ce qui se passe à la reprise, et comment bien la proposer. Il s’en tient à la documentation de Paddle : mettre en pause un abonnement, la référence API pause subscription, pause ou reprise d’abonnement, le webhook subscription.paused, les entrées du changelog sur les options de facturation à la reprise et la pause des abonnements impayés, et Cancellation Flows (tous consultés en novembre 2026).
Comment fonctionne une pause sur Paddle
Vous mettez un abonnement en pause avec l’opération pause subscription. Les principales options :
| Champ | Ce qu’il fait |
|---|---|
effective_from |
next_billing_period ou immediately. Pour les abonnements actifs, la valeur par défaut est next_billing_period. |
resume_at |
Date et heure facultatives (RFC 3339) auxquelles l’abonnement doit reprendre de lui-même |
on_resume |
Le fonctionnement de la facturation à la reprise de l’abonnement (voir plus bas) |
À la prochaine période de facturation (par défaut)
Mettre en pause à la prochaine période de facturation est l’option en douceur. Le guide de la pause de Paddle explique qu’elle crée sur l’abonnement un changement planifié indiquant qu’il doit se mettre en pause à la prochaine date de facturation. D’ici là, l’abonnement reste actif et le client garde ce qu’il a payé.
Vous verrez le changement planifié via subscription.updated, puis subscription.paused quand la pause prend effet, comme décrit dans pause ou reprise d’abonnement.
Immédiatement
Avec immediately, l’abonnement se met en pause tout de suite. Utilisez-le quand le client demande explicitement d’arrêter maintenant, ou quand votre propre logique l’exige (par exemple après un paiement échoué).
La reprise
Un abonnement en pause peut reprendre de deux façons : automatiquement à resume_at si vous l’avez défini, ou quand vous appelez l’opération resume.
Ce que le client paie à la reprise dépend de on_resume, ajouté dans le changelog 2024 de Paddle :
start_new_billing_period(par défaut) : une nouvelle période de facturation commence et Paddle prélève tout de suite.continue_billing_period: l’abonnement garde sa période de facturation en cours. Paddle renvoie une erreur si vous combinez cette option avec une date de reprise postérieure à la fin de cette période.
Pour la plupart des pauses de rétention, la valeur par défaut est plus simple à expliquer aux clients : « votre offre redémarre le [date] et vous serez prélevé à ce moment-là ». Utilisez continue_billing_period pour de courtes pauses à l’intérieur d’une période que le client a déjà payée.
Les abonnements impayés
La pause interagit avec les paiements échoués d’une façon qu’il vaut mieux connaître :
- La documentation de Paddle indique que, tant qu’un abonnement est
past_due, vous pouvez encore le mettre en pause ou le résilier, même si la plupart des autres modifications sont bloquées. - Le changelog 2024 de Paddle indique que, quand vous mettez un abonnement en pause, les transactions de renouvellement impayées sont annulées automatiquement, pour éviter de facturer des périodes qui se chevauchent. Quand l’abonnement en pause reprend, un nouveau cycle de facturation commence.
- Paddle renvoie une erreur si vous essayez de poursuivre la période de facturation en cours d’un abonnement impayé. Utilisez plutôt
start_new_billing_period.
La pause est donc aussi une issue raisonnable pour les paiements échoués. L’article d’aide de Paddle sur le rythme des nouvelles tentatives indique que vous pouvez choisir de mettre en pause, de résilier ou de laisser en impayé un abonnement à la fin de la fenêtre de récupération.
Pause et résiliation
Un détail dans la documentation des Cancellation Flows de Paddle : si un client résilie un abonnement actif, la résiliation est planifiée à la prochaine période de facturation, mais un abonnement en pause est résilié immédiatement. Dites-le aux clients dans votre confirmation de pause, pour que « pause, puis résiliation plus tard » ne les surprenne pas.
Proposer une pause avec Paddle Retain
Les Cancellation Flows de Paddle Retain lancent un court questionnaire quand un client essaie de résilier, puis lui proposent de rester. La documentation de Paddle cite la pause parmi les options de sauvetage, planifiée pour la prochaine période de facturation, avec les changements d’offre et une remise temporaire quand le client refuse la première offre. Les choix de résiliation, de pause et de passage à une offre inférieure sont répercutés dans Paddle Billing.
Depuis janvier 2026, le changelog de Paddle indique que les Cancellation Flows apparaissent aussi quand les clients résilient dans le portail client de Paddle, et depuis les liens de résiliation des emails d’abonnement de Paddle. Sans parcours configuré, les clients voient une simple boîte de confirmation. Une entrée plus récente du changelog ajoute que les parcours peuvent être construits et testés en sandbox via le portail client.
Pour les régions soumises à des règles de résiliation en un clic, le changelog 2024 de Paddle indique qu’un lien de résiliation apparaît sur chaque écran du parcours. Paddle détecte ces régions automatiquement.
Bien proposer une pause
- Adaptez l’offre à la raison. Une pause répond aux raisons temporaires : saisonnalité, projet en suspens, voyage, cycle budgétaire. Elle ne répond pas à « trop cher » ni à « fonctionnalités manquantes ». Voir pause ou remise comme offre de rétention.
- Proposez des durées fixes. Un, deux ou trois mois, avec
resume_atdéfini. Les pauses sans fin ont tendance à devenir des résiliations silencieuses. - Dites ce qui se passe à la reprise. La date, le montant, et si une nouvelle période de facturation commence.
- Prévenez avant la reprise. Envoyez un email quelques jours avant
resume_atavec un lien pour prolonger ou résilier. Un prélèvement surprise après une pause est une source classique de demandes de remboursement. - Gardez la résiliation à un clic. La pause est une offre, jamais une barrière. Voir les règles « click to cancel ».
Le brancher dans votre app
- Sur
subscription.updatedavec une pause planifiée, affichez la date de pause sur la page du compte. - Sur
subscription.paused, passez le compte en état de pause et décidez quelles données restent visibles. - À la reprise, rétablissez l’accès et enregistrez-le.
- Dans les rapports, comptez à part les clients en pause. Une pause n’est pas du churn, mais une pause qui se termine en résiliation doit garder sa raison d’origine.
Checklist de test
- Une pause à la prochaine période de facturation garde l’accès jusqu’à cette date.
- Une pause immédiate coupe l’accès tout de suite.
-
resume_atfait reprendre l’abonnement et prélève comme prévu selon votre choixon_resume. - Mettre en pause un abonnement impayé annule le renouvellement en retard.
- Résilier un abonnement en pause y met fin immédiatement, et votre app le gère.
Le faire avec NoChurn
Le parcours d’annulation de NoChurn demande une raison et propose selon elle une pause, une remise ou un changement d’offre, avec un bouton d’annulation en un clic toujours visible. Il tourne en version hébergée ou headless via l’API : il convient donc aux apps qui n’utilisent pas le portail Paddle. L’abonnement lui-même reste dans Paddle, qui demeure le marchand officiel. Les raisons de résiliation alimentent ensuite les emails de reconquête à J30, J60 et J90 et le churn score. Voir NoChurn + Paddle.