Récupérer les paiements échoués dans Chargebee
Le dunning de Chargebee : modes Smart et Custom, période de relance, action finale, emails de relance, lien de mise à jour de carte, payment_failed.
Par Florian
Chargebee a un système de relance (dunning) mature : il classe les erreurs de paiement, relance selon son propre calendrier ou le vôtre, écrit aux clients avec un lien pour mettre à jour leur carte et applique une action finale quand rien ne marche. L’essentiel de ce que vous pouvez récupérer avec Chargebee tient à quelques réglages et à la qualité de vos emails. Ce guide explique ces réglages et ce qu’il faut ajouter autour.
Il s’en tient à la documentation de Chargebee : Dunning, Smart and manual dunning, What is Smart Dunning, quel webhook se déclenche pendant le dunning, l’API Invoices, l’événement payment_failed, le Self-Serve Portal et comment les clients mettent à jour leur moyen de paiement (tous consultés en novembre 2026). Chargebee a deux générations de dunning ; ce guide décrit la génération actuelle et signale où l’ancienne diffère.
Comment fonctionne le dunning de Chargebee
Quand un prélèvement de renouvellement automatique échoue, la facture entre en dunning. Chargebee relance alors le paiement et envoie des emails de rappel pendant une période de relance (dunning period) : le nombre de jours pendant lesquels la facture reste en dunning avant que l’action finale ne soit exécutée. Les relances n’ont lieu que dans cette fenêtre.
Avec l’auto-collection activée, l’abonnement reste Active pendant le dunning. La suite dépend de vos réglages.
Deux modes de relance
La page Dunning de Chargebee décrit deux modes :
| Mode Smart | Mode Custom | |
|---|---|---|
| Qui choisit le moment | Chargebee, selon l’erreur de la passerelle | Vous, en jours après le premier échec |
| Nombre maximal de relances | Jusqu’à 12 | Jusqu’à 5 |
| Refus définitifs | Pas relancés tant que le moyen de paiement ne change pas | La documentation décrit des relances aux jours que vous fixez |
| Dates exactes | Non garanties | Fixes |
Le mode Smart classe les codes d’erreur de la passerelle en refus définitifs (hard declines) ou temporaires (soft declines). Les refus définitifs attendent que le client mette à jour son moyen de paiement. Pour les refus temporaires, Chargebee choisit un moment de relance selon la catégorie d’erreur et les chances de récupération. La documentation de Chargebee indique que les dates exactes de relance ne peuvent pas être garanties dans ce mode. Un « Collect Now » manuel compte aussi comme une relance. Un article d’aide de Chargebee précise que Smart Dunning n’est disponible qu’à partir de certaines offres, donc vérifiez la vôtre.
Le mode Custom vous laisse fixer les jours de relance. L’exemple de Chargebee : avec une période de relance de 8 jours et une fréquence de relance « 1,4,8 », les relances ont lieu 1, 4 et 8 jours après le premier échec.
Chargebee met aussi en avant Revive, un mode de relance par machine learning qui fonctionne dans les limites de Smart Dunning. Vérifiez avec Chargebee sa disponibilité sur votre offre.
Les échecs 3D Secure
Quel que soit le mode choisi, Chargebee indique que les paiements échoués à cause de 3D Secure ne sont relancés que la veille de la fin de la période de relance, si le client n’a pas agi. Ces clients doivent effectuer eux-mêmes l’authentification, donc c’est l’email qui les récupère, pas la relance.
L’action finale
Quand toutes les relances échouent, vous choisissez ce qui arrive à :
- l’abonnement : le résilier, ou le garder actif ;
- la facture : la marquer impayée, la passer en perte ou l’annuler.
Résilier est l’option stricte ; garder l’abonnement actif avec la facture impayée vous laisse plus de temps pour joindre le client, au prix de servir quelqu’un qui n’a pas payé. Faites un choix délibéré plutôt que de laisser la valeur par défaut.
Dunning v1
Les sites plus anciens peuvent encore être en Dunning v1. Les propres articles d’aide de Chargebee donnent des nombres de relances différents pour la v1, donc si votre site l’utilise, vérifiez les réglages dans votre dashboard plutôt que de vous fier à un article, et envisagez de passer à la version actuelle.
Les emails de relance et le lien de mise à jour de la carte
Chargebee envoie des emails de relance pendant les tentatives, et ces emails contiennent un lien où le client peut mettre à jour son moyen de paiement sur les pages hébergées de Chargebee (guide de mise à jour du moyen de paiement). Chargebee peut aussi prévenir les clients quand une carte est sur le point d’expirer, a expiré ou devient invalide.
Il existe trois autres façons d’obtenir un nouveau moyen de paiement :
- Request payment method. Depuis une page client ou abonnement du dashboard, l’équipe peut envoyer un lien sécurisé vers la page hébergée de Chargebee.
- Self-Serve Portal. Une fois activé sous Settings › Configure Chargebee › Checkout and Self-Serve Portal, les clients peuvent gérer leurs moyens de paiement et régler les factures impayées (Self-Serve Portal).
- API. L’API des pages hébergées pour gérer les sources de paiement renvoie une URL vers laquelle rediriger le client, si vous voulez le lien dans votre propre app ou vos emails.
Les modèles d’emails par défaut sont un point de départ. Modifiez-les pour que le client reconnaisse votre marque, comprenne ce qui a échoué et voie un seul bouton clair.
Événements et webhooks
Pour suivre le dunning, Chargebee recommande d’écouter payment_failed et de lire le dunning_status de la facture :
dunning_status |
Signification |
|---|---|
in_progress |
La facture est en dunning, il reste des relances |
exhausted |
La dernière relance a échoué ; la période de relance est terminée |
success |
Un paiement a été encaissé pendant le dunning |
stopped |
Le dunning a été arrêté pour cette facture |
Chaque tentative échouée pendant le dunning génère un événement payment_failed ; seul le dernier porte exhausted (quel événement marque la fin du dunning). payment_succeeded se déclenche quand un paiement est encaissé. Utilisez-les pour garder vos propres enregistrements à jour, arrêter toute communication supplémentaire dès qu’un paiement réussit et savoir quand l’action finale a eu lieu.
Une configuration de récupération, étape par étape
- Choisissez un mode de relance. Le mode Smart est le choix par défaut raisonnable pour les paiements par carte si votre offre l’inclut, puisqu’il évite les relances inutiles sur les refus définitifs. Utilisez le mode Custom si vous avez besoin de dates prévisibles, par exemple pour coller aux jours de paie de vos clients.
- Fixez la période de relance selon votre cycle de facturation. Une offre mensuelle ne peut pas attendre aussi longtemps qu’une offre annuelle.
- Choisissez délibérément l’action finale pour l’abonnement et la facture.
- Activez et réécrivez les emails de relance. Envoyez le premier dès le premier échec, avec le lien de mise à jour. Pour les refus définitifs, l’email est la seule chose qui récupérera le paiement.
- Traitez 3D Secure à part. Dites à ces clients que leur banque a besoin qu’ils confirment le paiement, et envoyez-leur le lien tout de suite.
- Activez le Self-Serve Portal pour que les clients qui ignorent l’email puissent quand même corriger leur carte depuis votre app.
- Activez les avis d’expiration de carte pour attraper les échecs avant qu’ils n’arrivent.
- Écoutez
payment_failedetpayment_succeededet enregistrez le résultat par type d’erreur, pour voir quels échecs votre configuration récupère et lesquels elle rate.
Ce qu’il faut ajouter par-dessus
Les relances et les emails de Chargebee couvrent bien les bases. Ce qui vous reste, c’est surtout la communication : des emails qui semblent écrits par une personne, dans la langue du client, et qui disent quoi faire pour l’échec précis ; des réponses qui arrivent chez quelqu’un ; et un suivi des clients perdus pour tenter de les faire revenir.
Le faire avec NoChurn
NoChurn se connecte à votre site Chargebee avec une clé API et suit ses webhooks. Il fonctionne à côté de vos réglages de dunning Chargebee : il envoie des emails de récupération rédigés par l’IA et relus par vous, avec un lien pour que le client mette à jour son moyen de paiement, et il ajoute des parcours d’annulation, des emails de reconquête à J30, J60 et J90 et un score de churn de 0 à 100. La facturation, le prélèvement lui-même et votre passerelle de paiement restent chez Chargebee. Les litiges viennent de la passerelle derrière Chargebee ; avec Stripe ou Braintree, NoChurn réunit les preuves et rédige une réponse envoyée seulement après votre relecture. NoChurn est gratuit en dessous de 300 $ de MRR. Voir NoChurn + Chargebee.