Ajouter un parcours d’annulation aux abonnements Braintree

La facturation récurrente de Braintree n’a qu’une opération de résiliation, et elle est définitive : un abonnement résilié ne peut être ni modifié ni réactivé. Il n’y a pas de page de résiliation intégrée, pas de questionnaire sur la raison et pas d’offre de rétention. Si vous voulez que les clients voient une alternative avant de partir, et garder une trace de pourquoi ils sont partis, vous construisez ce parcours dans votre app et appelez Braintree à la fin.

Ce guide couvre les opérations Braintree sur lesquelles repose un parcours d’annulation, les limites qui le façonnent et une conception étape par étape. Il s’en tient à la documentation de Braintree : Subscription: Cancel, Subscription: Update, Manage subscriptions, Plans, Statuses, les webhooks d’abonnement et le guide des abonnements (tous consultés en novembre 2026).

Comment fonctionne la résiliation dans Braintree

Subscription: Cancel fait passer un abonnement à Canceled, que la référence des statuts de Braintree décrit comme l’arrêt de toute facturation. La référence est explicite : une fois un abonnement résilié, vous ne pouvez ni le modifier ni le réactiver ; un client qui revient a besoin d’un nouvel abonnement.

Trois conséquences pour votre parcours :

• La résiliation est la dernière étape, jamais la première. Faites passer toutes les offres avant l’appel.
• Il n’y a pas d’option « résilier en fin de période » dans l’opération de résiliation. Si vous résiliez en milieu de cycle, la facturation s’arrête, et ce à quoi le client garde accès relève de votre décision dans votre app.
• Enregistrez vous-même la date de résiliation. Braintree précise que la date de résiliation ne figure pas dans les résultats de recherche d’abonnements et suggère de la capter depuis le webhook subscription_canceled.

Terminer à la fin de la période payée

Beaucoup d’entreprises veulent que le client garde l’accès jusqu’à la fin de ce qu’il a payé, sans autre prélèvement. Deux approches collent au modèle de Braintree :

1. Résilier maintenant, garder l’accès dans votre app jusqu’à la fin de la période de facturation en cours, en utilisant la date de fin de période que vous avez enregistrée pour l’abonnement.
2. Limiter le nombre de cycles de facturation. Subscription: Update vous permet de fixer le nombre de cycles de facturation, qui doit être supérieur ou égal au cycle en cours, et désactive « never expires ». Quand un abonnement atteint son nombre de cycles, Braintree le marque Expired. L’abonnement se termine ainsi naturellement après le cycle en cours, et un client qui change d’avis d’ici là peut être rétabli en le repassant en « never expire ».

La seconde approche garde l’abonnement modifiable jusqu’à sa fin, ce qui facilite le retour en arrière. Testez-la en sandbox avec les réglages de vos offres avant de compter dessus.

Ce que vous pouvez proposer à la place

L’opération de mise à jour de Braintree vous donne les leviers des offres de rétention.

Remises

Vous pouvez ajouter, modifier ou retirer des discounts (et des add-ons) sur un abonnement existant. Règles clés de la documentation :

• Les détails d’une remise (nom, montant, durée) se gèrent dans le Control Panel, pas par l’API. Créez-y d’abord vos remises de rétention, puis appliquez-les par ID.
• Une remise donnée ne peut être appliquée qu’une fois à un abonnement ; pour l’appliquer plusieurs fois, utilisez sa quantité.

Créez une remise de rétention dédiée, par exemple « Retention 30% x3 », pour que les offres acceptées soient faciles à retrouver dans les rapports et jamais confondues avec les remises commerciales.

Changements de prix et d’offre

Vous pouvez changer le prix de l’abonnement, avec une option qui détermine si le changement est proratisé, ou le passer à une autre offre. Braintree précise que passer à une offre de périodicité différente n’est possible que pour certains marchands qui le demandent, et remet à zéro le cycle de facturation en cours. Pour la plupart des parcours d’annulation, passer à une offre moins chère de même périodicité est l’offre la plus simple.

Une pause

La documentation Braintree que nous avons consultée ne décrit pas d’opération de pause ou de « sauter un cycle » pour les abonnements. Le webhook subscription_billing_skipped existe, mais il se déclenche quand un cycle est sauté parce qu’un solde nul ou négatif le couvre déjà, pas à la demande. Si vous voulez proposer une pause, vous devrez la construire par-dessus Braintree (par exemple avec une remise totale temporaire pour un nombre de cycles défini), et tester soigneusement le comportement de facturation avant.

Les webhooks que votre parcours doit écouter

D’après les webhooks d’abonnement de Braintree :

Type	Usage dans un parcours d’annulation
subscription_canceled	Enregistrer la date de résiliation, retirer l’accès au bon moment, lancer la reconquête
subscription_expired	L’abonnement a atteint son dernier cycle (pour l’approche « cycles limités »)
subscription_charged_successfully	Confirme qu’un prix d’offre a été prélevé

Écoutez même les résiliations que vous déclenchez vous-même. Les agents du support peuvent résilier depuis le Control Panel, et ces résiliations doivent arriver dans les mêmes enregistrements.

Construire le parcours

1. Envoyez le bouton d’annulation vers votre propre page, jamais directement vers l’API.

2. Demandez pourquoi. Cinq à sept raisons plus « Autre ». Enregistrez la réponse avec l’ID d’abonnement Braintree. Des idées dans les questionnaires sur les raisons de résiliation.

3. Montrez une offre adaptée à la raison :

   Raison	Offre	Opération Braintree
   Trop cher	Remise à durée limitée	Update : ajouter une remise de rétention
   Besoin moindre	Offre moins chère	Update : changer d’offre ou de prix
   Je ne m’en sers pas en ce moment	Une pause, si vous en avez construit une	Votre propre logique (voir plus haut)
   Problème technique	Aide du support	Aucune tant que ce n’est pas résolu
   Changement d’outil ou fermeture	Pas d’offre	Cancel

4. Gardez « Résilier l’abonnement » visible à chaque étape, aussi facile à cliquer que l’offre. Règles et bonnes pratiques dans les règles click-to-cancel et les bonnes pratiques du parcours d’annulation.

5. En cas d’acceptation, appelez Subscription: Update, puis confirmez par email avec le nouveau prix et sa durée.

6. En cas de résiliation, appelez Subscription: Cancel (ou limitez les cycles de facturation), affichez la date de fin d’accès, envoyez une confirmation.

7. Gérez les abonnements en retard de paiement. Un client qui résilie alors qu’il est en retard peut devoir un solde ; décidez de votre politique et affichez-la.

8. Faites le point chaque mois sur les raisons qui reviennent le plus et les offres qui rapportent encore au bout de trois mois.

Erreurs fréquentes

• Résilier, puis essayer d’appliquer une offre. Les abonnements résiliés ne sont pas modifiables.
• Créer les remises dans le code. Les détails des remises vivent dans le Control Panel ; prévoyez-les à l’avance.
• Perdre la date de résiliation. Sans le webhook enregistré, vous ne pouvez ni caler les emails de reconquête ni mesurer le churn par mois.
• Cacher l’option de résiliation derrière l’offre. Cela coûte la confiance et, dans beaucoup d’endroits, enfreint les règles.

Le faire avec NoChurn

Braintree garde l’abonnement, les paiements et la résiliation elle-même. Le parcours d’annulation de NoChurn demande la raison, montre une offre (une remise, un changement d’offre ou une résiliation sur l’abonnement Braintree) et garde une annulation en un clic visible à chaque étape, en version hébergée ou headless via l’API. Les réponses alimentent les emails de reconquête à J30, J60 et J90 et un score de churn de 0 à 100, et deviennent des preuves si le client conteste plus tard un prélèvement. Voir NoChurn + Braintree.