Configurer les relances dans Recurly
Les paiements échoués dans Recurly : campagnes et cycles de relance, Intelligent Retries, emails, factures impayées et échouées, mises à jour, webhooks.
Par Florian
Recurly propose l’un des dispositifs de relance natifs les plus complets parmi les plateformes de facturation d’abonnements. Nouvelles tentatives, emails, actions de fin de cycle et pages de facturation client sont intégrés, et l’essentiel du travail consiste à choisir des réglages raisonnables et à brancher les bons webhooks dans votre app. Ce guide passe en revue chaque élément et vous donne une checklist de configuration applicable dès aujourd’hui.
Tout ce qui est propre à Recurly vient de sa documentation : Dunning campaigns, Intelligent retries, Static retries, Dunning 101: Understanding dunning windows, Hosted account management et la référence des webhooks (tous consultés en novembre 2026). Recurly vend aussi un produit distinct, Recurly Commerce, avec ses propres réglages de relance ; ce guide porte sur Recurly Subscriptions.
Comment Recurly répartit le travail : nouvelles tentatives et relances
Recurly traite deux choses séparément :
- Les nouvelles tentatives décident quand un prélèvement refusé est retenté.
- Les relances (dunning) décident ce que le client reçoit comme messages, pendant combien de temps, et ce qui arrive à la facture et à l’abonnement à la fin.
Les deux s’appliquent à la même facture en même temps, mais se configurent à des endroits différents. Garder cette séparation en tête rend le reste des réglages plus facile à comprendre.
Les nouvelles tentatives : Intelligent Retries et static retries
Intelligent Retries
Selon la documentation Intelligent retries, Recurly utilise un modèle de machine learning pour choisir quand retenter les paiements récurrents par carte refusés. Il se concentre sur les refus temporaires (comme la provision insuffisante). Les limites documentées :
- Les tentatives s’arrêtent à 20 tentatives de transaction au total ou 60 jours après la création de la facture, selon ce qui arrive en premier.
- Intelligent Retries ne s’applique pas aux prélèvements comme ACH et SEPA. Recurly les documente à part, dans les nouvelles tentatives de prélèvement.
- Les refus définitifs sont en général considérés comme finaux et ne sont pas retentés automatiquement, à quelques exceptions documentées près, par exemple quand le client ou l’Account Updater modifie les informations de facturation.
Un point à vérifier dans votre propre compte : une entrée du changelog de Recurly d’août 2026 décrit des refus temporaires retentés jusqu’à 20 fois par période de 30 jours, en conformité avec les règles des réseaux de cartes. Cette formulation diffère de la fenêtre de 60 jours de la page principale : confirmez auprès de Recurly la limite qui s’applique à vous avant de compter sur l’une ou l’autre.
Static retries
Recurly documente aussi une option sans ML, les static retries, pilotées par les codes de refus de la passerelle et les merchant advice codes. Elles s’arrêtent après 7 refus de transaction, 20 tentatives au total ou 60 jours après la création de la facture, selon ce qui arrive en premier, ou plus tôt si le cycle de relance se termine avant.
Quelle que soit la logique utilisée, les nouvelles tentatives ne durent jamais plus longtemps que le cycle de relance. Si votre fenêtre de relance est courte, elle plafonne aussi vos tentatives.
Campagnes et cycles de relance
Une campagne de relance (dunning campaign) est l’ensemble de règles que Recurly applique à une facture impayée. Chaque site a une campagne par défaut et, sur les offres éligibles, vous pouvez créer des campagnes supplémentaires et les attribuer à des offres ou des comptes précis. La page des campagnes de relance précise que plusieurs campagnes demandent une offre Professional ou Elite. Les campagnes se trouvent dans Configuration, puis Dunning Management. Les réglages de relance sont versionnés : modifier une campagne ne change pas les factures déjà en relance.
Chaque campagne contient jusqu’à trois types de cycle, chacun avec son calendrier et ses emails :
| Type de cycle | S’applique à | Modèle d’email par défaut |
|---|---|---|
| Payment Declined | Les factures prélevées automatiquement qui échouent | Payment Declined |
| Invoice Past Due | Les factures à encaissement manuel qui dépassent leur délai de paiement | Invoice Past Due |
| Post-Trial Payment Declined | Les factures qui échouent juste après un essai gratuit | Post-Trial Payment Declined |
Pour les factures manuelles, la période de relance commence le lendemain du dépassement du délai de paiement.
Quelle durée pour un cycle ?
Le guide des fenêtres de relance de Recurly recommande :
- Facturation mensuelle : une fenêtre de 27 jours, pour que le cycle se termine avant la facture suivante, même en février.
- Facturation trimestrielle et annuelle : environ 60 jours.
- Facturation hebdomadaire : 7 jours.
Ce sont des recommandations, pas des limites strictes. L’idée derrière est saine : si un cycle mensuel dure plus d’un mois, une seconde facture arrive par-dessus la première, et vous voilà à courir après deux factures impayées d’un client qui ne reviendra peut-être jamais.
Ce qui se passe à la fin du cycle
Pour chaque cycle, vous choisissez ce qui arrive à la facture et à l’abonnement si le client n’a pas payé. Par défaut, Recurly marque la facture failed. Vous pouvez aussi faire expirer l’abonnement, le garder actif, ou faire en sorte que les factures n’échouent jamais automatiquement, ce qui les laisse impayées indéfiniment.
Quelques comportements tirés des articles de support de Recurly, qui surprennent souvent les équipes :
- L’état de l’abonnement et celui de la facture sont distincts. Un abonnement peut être actif alors que sa facture est impayée (article de support). Fondez aussi vos décisions d’accès sur la facture, pas seulement sur l’abonnement.
- Faire échouer une facture ne résilie pas l’abonnement. Si vous voulez arrêter la facturation, résiliez l’abonnement séparément (article de support).
- Résilier un abonnement n’arrête pas les relances sur les factures ouvertes. Utilisez Stop Collection sur la facture pour cela (article de support).
- Il n’existe pas d’option de pause native dans la configuration des relances.
Les emails de relance
Chaque étape d’un cycle peut envoyer un email. Recurly fournit des modèles de base (Payment Declined, Invoice Past Due, Post-Trial Payment Declined et Subscription Expired for Non-Payment) qui ne peuvent pas être supprimés, et vous pouvez créer les vôtres et les rattacher aux étapes de la campagne.
L’email Payment Declined par défaut renvoie déjà le client vers sa page de gestion de compte hébergée. Chaque compte a deux URL hébergées : une URL Account Management qui connecte le client, et une URL Edit Billing Information qui n’ouvre que le formulaire de facturation. Si vous hébergez votre propre page de facturation, vous pouvez modifier le modèle pour pointer vers elle, avec le hosted login token du compte obtenu via l’API.
Un plan d’emails raisonnable pour une campagne mensuelle :
| Jour | Objectif | |
|---|---|---|
| 0 | Paiement refusé | Informer, un seul lien clair pour mettre à jour la facturation |
| 3 | Rappel | Redonner le lien, dire ce qui va suivre |
| 10 | Rappel | Court, signaler que l’accès est menacé |
| 20 | Dernier avis | Donner la date exacte de fin de l’abonnement |
| Fin | Expiré pour non-paiement | Confirmer la fin, proposer un chemin de retour |
Gardez chaque email court et centré sur le lien de facturation. Ne répétez pas au client le motif de refus brut.
Une mise à jour de facturation déclenche une nouvelle tentative immédiate
C’est l’un des comportements natifs les plus utiles. Selon la documentation de Recurly, quand un client met à jour ses informations de facturation, Recurly retente l’encaissement de toutes les factures en retard de ce compte. Cela vaut aussi pour les refus définitifs : une nouvelle carte est le seul événement qui justifie de retenter une facture refusée définitivement. Pour le prélèvement, passer à un nouveau compte bancaire remet à zéro le compteur de tentatives.
En pratique, vos emails de relance n’ont pas besoin d’une étape « payer maintenant » séparée. Amener le client jusqu’au formulaire de facturation, c’est tout le travail.
Les webhooks à écouter
La référence des webhooks de Recurly et la documentation des relances listent les événements qui comptent pendant les relances. Ceux que vous recevez dépendent de la configuration de votre site :
| Événement | Quand il est envoyé | Que faire dans votre app |
|---|---|---|
failed_payment |
Après chaque paiement échoué | Signaler le compte, afficher une bannière dans l’app |
successful_payment |
Après un paiement réussi | Retirer le signalement, rétablir l’accès |
new_dunning_event |
Quand des factures entrent et restent en relance | Suivre l’état de relance par compte |
charge_invoice.past_due |
Une facture de débit passe en impayé (sites avec factures d’avoir) | Lancer vos propres rappels, le cas échéant |
charge_invoice.failed |
Une facture de débit échoue, directement ou en fin de relance | Décider de l’accès, arrêter les rappels |
subscription_expired |
Recurly fait expirer un abonnement, y compris pour non-paiement | Retirer l’accès |
Les sites sans factures d’avoir reçoivent à la place les anciennes notifications de facture de Recurly, avec des noms différents. Vérifiez quel ensemble envoie votre site avant d’écrire vos handlers.
Une checklist de configuration
- Choisissez votre logique de nouvelles tentatives. Intelligent Retries pour la plupart des activités par carte ; vérifiez comment le prélèvement est retenté si vous acceptez ACH ou SEPA.
- Réglez la durée du cycle selon la fréquence de facturation. Partez des recommandations de Recurly : 27 jours (mensuel) et 60 jours (annuel).
- Choisissez volontairement l’action de fin de cycle. Décidez si l’abonnement expire ou reste actif, et si les factures échouent. Écrivez-le pour que le support le sache.
- Rédigez les emails. Un lien par email, vers la page Edit Billing Information ou votre propre formulaire de facturation.
- Ajoutez une campagne post-essai si vous proposez des essais gratuits. Le premier prélèvement après un essai échoue différemment d’un renouvellement : le client ne vous a jamais payé.
- Branchez les webhooks. Fondez l’accès sur l’état de la facture, pas seulement sur celui de l’abonnement.
- Ajoutez une bannière dans l’app pour les clients connectés ayant une facture impayée. Les emails passent facilement inaperçus ; le produit, non.
- Faites le point chaque mois. Regardez les factures qui ont échoué en fin de relance et les codes de refus correspondants.
Le faire avec NoChurn
Les nouvelles tentatives et relances natives de Recurly sont solides, et NoChurn ne les remplace pas : nouvelles tentatives, facturation et prélèvement restent dans Recurly. NoChurn se connecte avec une clé API Recurly, suit les webhooks de Recurly et ajoute des emails de récupération rédigés par l’IA, que vous relisez avant envoi, avec un lien pour que le client mette à jour ses informations de facturation. Il couvre aussi ce que les relances ne font pas : des parcours d’annulation avec raisons et offres (un coupon, une pause ou un changement d’offre sur l’abonnement Recurly) et un bouton d’annulation en un clic toujours visible, des emails de reconquête à J30, J60 et J90 selon la raison de la résiliation, et un churn score de 0 à 100. Les chargebacks viennent de la passerelle derrière Recurly ; avec Stripe ou Braintree, NoChurn réunit les preuves et rédige une réponse que vous relisez. Voir NoChurn + Recurly.