Ce qui se passe quand un paiement échoue sur Polar

Polar vend vos abonnements en tant que marchand officiel (merchant of record). Quand un renouvellement d’abonnement échoue, Polar gère lui-même la récupération : il retente la carte, garde l’abonnement dans un état récupérable et révoque les avantages si rien ne marche. Les règles sont simples et pour l’essentiel fixes, ce qu’il vaut mieux savoir avant de concevoir quoi que ce soit autour.

Ce guide explique la séquence étape par étape, le seul réglage que vous maîtrisez, les webhooks à écouter, et ce que vous pouvez ajouter sans aller contre le parcours de Polar. Il s’en tient à la documentation de Polar : récupérer les paiements échoués, le fonctionnement des abonnements, les webhooks subscription.past_due et subscription.revoked (tous consultés en novembre 2026). Quand les pages de Polar se contredisent ou restent muettes, nous le disons.

La séquence, étape par étape

Selon la page de Polar sur les paiements échoués :

1. Au renouvellement, Polar fait d’abord passer l’abonnement au cycle de facturation suivant, puis tente de prélever le moyen de paiement par défaut du client.
2. Si le prélèvement échoue, l’abonnement n’est pas résilié. Il passe en past_due et entre dans la récupération automatique des paiements de Polar.
3. Polar retente le paiement selon un calendrier fixe : quatre tentatives réparties sur 21 jours, à compter du premier échec. Le calendrier est fixé par Polar et n’est pas configurable.
4. Si le client met à jour son moyen de paiement entre-temps, Polar retente le prélèvement immédiatement au lieu d’attendre la tentative suivante.
5. Si une tentative réussit, l’abonnement est de nouveau à jour.
6. Si toutes les tentatives échouent, ou si le code de refus montre que le moyen de paiement ne passera jamais (Polar cite lost_card en exemple), Polar arrête les tentatives et révoque l’abonnement et ses avantages.

Le point 6 mérite attention. Polar ne s’acharne pas sur une carte qui ne peut pas fonctionner, ce qui est le bon comportement, et cela veut dire que les refus définitifs se terminent bien avant 21 jours si le client n’agit pas.

Le réglage que vous maîtrisez : la période de grâce

Par défaut, Polar révoque les avantages strictement. Polar propose une période de grâce au niveau de l’organisation, qui retarde la révocation des avantages tant qu’un abonnement est past_due. Vous la réglez dans Settings, puis Subscriptions, puis « Grace period for benefit revocation ».

Ce que la période de grâce fait et ne fait pas, selon la documentation de Polar :

	Pendant la période de grâce
Statut de l’abonnement	Toujours past_due
Avantages du client	Conservés
Calendrier de relance	Inchangé
Mesurée à partir de	past_due_at

La période de grâce porte donc sur l’accès, pas sur l’encaissement. C’est un bon choix quand les avantages sont des choses dont les clients dépendent au quotidien (une clé de licence, l’accès à un dépôt privé, un rôle Discord), et que les perdre pour un problème de carte temporaire ferait partir le client pour de bon.

Comment le client règle le problème

La solution à la plupart des refus définitifs, c’est une nouvelle carte. La vue d’ensemble des abonnements de Polar indique que le Customer Portal permet aux clients de mettre à jour leur moyen de paiement, de télécharger leurs factures et de résilier. Comme Polar retente immédiatement après une mise à jour du moyen de paiement, un client qui met à jour sa carte récupère son abonnement tout de suite.

La documentation de Polar que nous avons consultée ne détaille ni le contenu ni le moment des éventuels emails envoyés aux clients en cas d’échec. Testez en sandbox : provoquez un échec avec une carte de test et regardez ce qui arrive dans la boîte mail du client avant d’écrire vos propres messages, pour ne pas envoyer de doublons.

Les webhooks à écouter

Événement	Signification
subscription.past_due	Un renouvellement a échoué. Polar le décrit comme un état récupérable : le client peut mettre à jour son moyen de paiement pour rétablir l’abonnement.
subscription.updated	L’abonnement a changé, y compris quand il est récupéré
subscription.revoked	L’abonnement a été révoqué, soit parce qu’il a été résilié, soit parce que les tentatives de paiement sont épuisées

Une incohérence à prévoir : la page subscription.revoked de Polar indique que, quand les tentatives sont épuisées, le statut devient unpaid, alors que la page sur les paiements échoués décrit un abonnement qui se termine comme résilié, avantages révoqués. Écrivez votre handler pour traiter les deux comme « ne paie plus », et enregistrez le statut réellement reçu.

Une configuration pratique sur Polar

1. Décidez de la période de grâce. Si les avantages font partie du travail quotidien, mettez-en une. S’ils sont faciles à rétablir, une révocation stricte convient.
2. Gérez subscription.past_due dans votre app. Affichez une bannière avec un lien vers le Customer Portal. Beaucoup de clients ne lisent jamais les emails de facturation, mais ils voient votre produit.
3. Expliquez la suite. Dites au client que Polar va réessayer et que mettre à jour la carte règle le problème tout de suite.
4. Gérez la révocation avec soin. Sur subscription.revoked, gardez les données du client, expliquez pourquoi l’accès s’est arrêté et donnez un chemin de retour clair.
5. Enregistrez chaque échec. Stockez l’abonnement, le montant, la date et le résultat. Au bout de quelques mois, vous verrez combien se récupèrent par une nouvelle tentative et combien seulement après une mise à jour de carte.
6. Testez avec les cartes de sandbox. Faites un refus temporaire, un refus définitif et une récupération avant la mise en production.

À quoi ressemble la chronologie pour un client

En combinant les règles de Polar, un refus temporaire typique se déroule ainsi :

1. Jour du renouvellement : le prélèvement échoue, l’abonnement passe en past_due, et subscription.past_due arrive dans votre app.
2. Pendant les trois semaines suivantes : Polar fait ses tentatives planifiées. Si vous avez défini une période de grâce, le client garde ses avantages pendant ce temps.
3. À tout moment dans cette fenêtre : le client met à jour sa carte dans le Customer Portal, Polar retente aussitôt, et l’abonnement est récupéré.
4. Fin de la fenêtre sans succès : Polar révoque l’abonnement, et subscription.revoked arrive dans votre app.

Pour un refus définitif, l’étape 2 peut être entièrement sautée, car Polar arrête de retenter un moyen de paiement qui ne peut pas réussir. C’est pourquoi la bannière dans l’app compte le plus pour les refus définitifs : l’action du client est le seul chemin de retour, et la fenêtre est courte.

Ce que Polar ne couvre pas

La récupération de Polar est volontairement simple. Ce qui vous revient :

• Le contexte. Polar traite chaque échec de la même façon. Un échec sur un client de longue date qui utilise le produit chaque jour mérite un autre message qu’un échec sur un compte dormant.
• Des messages avec votre propre ton. Si vous voulez des messages de récupération qui mentionnent l’offre, l’usage ou l’équipe du client, c’est à vous de les écrire.
• La mesure. Récupérés et perdus par mois, par cause. Voir le churn involontaire pour les définitions et les modèles d’emails de relance pour des idées de messages.
• La prévention. Les cartes qui expirent avant le prochain renouvellement sont prévisibles. Un rappel avant le renouvellement évite complètement l’échec ; voir les cartes qui expirent.

Le faire avec NoChurn

Sur Polar, l’encaissement, les nouvelles tentatives et le calendrier de 21 jours restent chez Polar, en tant que marchand officiel ; NoChurn ne les modifie pas. Il lit vos abonnements et échecs Polar, envoie des emails de récupération rédigés par l’IA que vous relisez avant envoi, et donne à chaque client un churn score de 0 à 100, enrichi de vos propres données envoyées par API. Les résiliations passent ensuite par un parcours d’annulation et des emails de reconquête à J30, J60 et J90. Voir NoChurn + Polar.