Réduire le churn sur Lemon Squeezy

Lemon Squeezy en fait déjà pas mal pour garder les abonnements en vie : il relance les paiements échoués, envoie des emails de récupération, et donne aux clients un portail où ils peuvent mettre en pause au lieu d’annuler. Ce guide explique ce qu’il fait nativement, quels statuts d’abonnement et webhooks surveiller, et où un parcours d’annulation et la reconquête viennent s’ajouter.

Il s’en tient à la documentation de Lemon Squeezy : abonnements, l’objet subscription, récupération et relances, gérer les abonnements avec l’API, portail client, types d’événements webhook, remises et remboursements et chargebacks (tous consultés en novembre 2026).

Lemon Squeezy est le marchand officiel

Lemon Squeezy vend à vos clients en tant que marchand officiel (merchant of record). Il traite les paiements, les remboursements et les chargebacks. Sa doc indique qu’en cas de litige, il rembourse généralement en votre nom et déduit le montant (moins ses frais de plateforme) plus 15 $ de frais de litige de votre prochain versement, et qu’il fournit des informations au prestataire de paiement pour défendre le dossier. Trop de chargebacks peuvent le conduire à suspendre une boutique. Pour le travail sur le churn, cela veut dire que vous modifiez les abonnements via l’API et le portail de Lemon Squeezy, et que vous ne gérez pas les paiements vous-même.

Les statuts d’abonnement

L’objet subscription a sept statuts. Savoir lesquels donnent encore accès est la base de tout le reste.

Statut	Signification	Accès
`on_trial`	En essai, en attente du premier paiement	Oui
`active`	Actif et valide	Oui
`paused`	Encaissement en pause, abonnement toujours en cours	Facultatif, à vous de choisir
`past_due`	Un renouvellement a échoué et Lemon Squeezy retente	Oui
`unpaid`	Toutes les tentatives ont échoué ; les règles de relance décident de la suite	Voir ci-dessous
`cancelled`	Paiements futurs annulés, toujours valide jusqu’à la fin de la période (période de grâce)	Oui
`expired`	Terminé, après annulation ou après les relances	Non

Lemon Squeezy recommande d’autoriser l’accès pour on_trial, active, cancelled, past_due et éventuellement paused. Sa page sur les relances indique qu’une fois la dernière tentative échouée, l’abonnement devient unpaid et le client perd l’accès.

Ce que fait Lemon Squeezy sur les paiements échoués

Lemon Squeezy a une récupération intégrée, décrite sur sa page récupération et relances :

Nouvelles tentatives. Après un renouvellement échoué, l’abonnement passe en past_due et Lemon Squeezy retente le paiement quatre fois sur deux semaines. Une tentative réussie le ramène en active. Si les quatre échouent, il devient unpaid.
Emails pendant les tentatives. Chaque tentative échouée envoie au client un email lui demandant de mettre à jour ses informations de facturation.
Relances après les tentatives. Si vous activez les relances, Lemon Squeezy envoie une série d’emails de relance sur une période que vous configurez, et vos règles de relance décident quand l’abonnement devient expired. Vous pouvez modifier les emails par défaut, les objets et le calendrier. Si les relances sont désactivées, le statut reste unpaid.
Avis de carte bientôt expirée. Lemon Squeezy peut envoyer un email aux clients avant l’expiration d’un moyen de paiement enregistré.
PayPal fonctionne différemment. Pour les abonnements PayPal, la page PayPal indique que les tentatives ont lieu tous les 5 jours, jusqu’à deux fois par cycle de facturation, et que l’abonnement est suspendu après deux cycles de facturation échoués.

Le même lien de mise à jour de carte est envoyé avec chaque email de tentative et de relance. Lemon Squeezy précise que ces URL de mise à jour expirent après 24 heures : si vous envoyez vos propres messages, récupérez à chaque fois une URL fraîche depuis l’API plutôt que d’en stocker une.

C’est une bonne base native. Ce que vous contrôlez, c’est le calendrier des relances et le texte des emails ; le moment des nouvelles tentatives est fixé par Lemon Squeezy.

Pause et annulation via l’API

Le guide de gestion des abonnements couvre les deux.

Pause. Envoyez PATCH /v1/subscriptions/:id avec un objet pause. Deux modes existent :

void : pour les périodes où vous ne pouvez pas fournir le service ;
free : le client continue d’utiliser le produit gratuitement pendant la pause.

Les deux arrêtent l’encaissement. Une date resumes_at facultative lève la pause automatiquement. Passer pause à null reprend l’encaissement selon le calendrier d’origine.

Annulation. DELETE /v1/subscriptions/:id annule un abonnement actif. Il passe en cancelled et reste valide jusqu’à la prochaine date de renouvellement, indiquée dans ends_at, puis expire. Pendant cette période de grâce, vous pouvez le réactiver en mettant à jour l’abonnement avec cancelled à false.

Le portail client

Le portail client hébergé de Lemon Squeezy permet aux clients de changer de produit d’abonnement, de mettre en pause et de reprendre, d’annuler et de réactiver, et de mettre à jour leurs coordonnées de facturation. Vous choisissez les fonctionnalités affichées dans les réglages du portail. Chaque objet subscription porte aussi une URL customer_portal, un lien pré-signé valable 24 heures, que vous pouvez ouvrir depuis votre appli.

Si vous laissez les clients annuler directement depuis le portail, ils sautent toute étape de rétention que vous construisez. Décidez-le volontairement : soit vous envoyez le bouton « Annuler » de votre appli d’abord vers votre propre parcours, soit vous vous appuyez sur l’option de pause du portail comme seule offre.

Les remises

Les remises de Lemon Squeezy ont trois durées (objet discount) : once, repeating pour un nombre de mois défini, ou forever. Pour les offres annuelles, ce nombre se compte toujours en mois : deux paiements annuels, c’est 24. La documentation des remises décrit des codes utilisés au checkout ; elle ne décrit pas l’application d’une remise à un abonnement existant. Vérifiez auprès de Lemon Squeezy avant de promettre une offre « 50 % sur vos 3 prochains mois » à un abonné actuel. La pause et le passage à un produit moins cher via le portail sont les offres que sa doc prend clairement en charge.

Les webhooks à écouter

D’après la page des types d’événements :

Événement	À utiliser pour
`subscription_updated`	Fourre-tout pour les dernières données de l’abonnement ; recommandé par Lemon Squeezy
`subscription_payment_failed`	Un renouvellement a échoué ; les tentatives commencent
`subscription_cancelled`	Annulé par le client ou par vous ; la période de grâce commence
`subscription_expired`	L’accès doit prendre fin
`subscription_paused` / `subscription_unpaused`	Pause commencée ou terminée

Vous pouvez simuler des événements comme subscription_cancelled et subscription_expired en mode test.

Ajouter un parcours d’annulation

Envoyez le bouton « Annuler » de votre appli vers votre parcours. Affichez une courte liste de raisons plus « Autre ».
Proposez une seule chose adaptée à la raison. « Je ne m’en sers pas en ce moment » : une pause en mode void avec un resumes_at. « Trop cher » : un produit moins cher. « Il manque une fonctionnalité » : une réponse d’une personne.
Gardez « Annuler maintenant » visible à chaque étape. Un clic doit suffire à terminer l’annulation sans accepter d’offre.
Appliquez le résultat avec l’API. Pause avec PATCH et un objet pause ; annulation avec DELETE, qui garde l’accès jusqu’à ends_at.
Confirmez la date de fin à partir de l’abonnement renvoyé par l’API.
Proposez « garder mon abonnement » pendant la période de grâce, ce qui passe cancelled à false.

La reconquête

Une fois qu’un abonnement est expired, c’est terminé. Gardez la raison recueillie, et recontactez le client plus tard avec quelque chose qui y répond. Utilisez l’événement subscription_expired comme point de départ du compte à rebours, et envoyez-le vers un nouveau checkout.

Le faire avec NoChurn

NoChurn lit vos abonnements et webhooks Lemon Squeezy. Il ajoute un parcours d’annulation avec raisons, offres (comme une pause ou un changement d’offre) et un bouton d’annulation en un clic toujours visible, hébergé ou headless via l’API, plus des emails de reconquête à J30, J60 et J90 selon la raison d’annulation, et un churn score de 0 à 100. Lemon Squeezy reste le marchand officiel : paiements, récupération des paiements, remboursements et litiges restent chez lui. Les paiements échoués apparaissent dans la chronologie client et le churn score de NoChurn, et les litiges apparaissent en lecture seule. NoChurn est gratuit sous 300 $ de MRR. Voir NoChurn + Lemon Squeezy.