CHARGEBACKSBRAINTREE

Contester les chargebacks sur Braintree

Les litiges Braintree : types et statuts, date limite de réponse, codes de raison, preuves catégorisées pour le récurrent, et quand accepter.

Publié le 6 min de lecture

Un chargeback sur un abonnement concerne rarement une carte volée. Le plus souvent, le client a oublié qu’il s’était inscrit, n’a pas reconnu le libellé ou croyait avoir résilié. Ces cas se gagnent quand vous avez les bons enregistrements et que vous les soumettez dans le format attendu par Braintree. Les outils de Braintree sont bons, mais stricts : ratez la date ou rangez une preuve dans la mauvaise catégorie, et la réponse n’arrive jamais à la banque.

Ce guide passe en revue la façon dont Braintree structure les litiges, les règles de preuve qui comptent pour la facturation récurrente et un processus que vous pouvez appliquer à chaque cas. Il s’en tient à la documentation de Braintree : la vue d’ensemble des litiges, Managing disputes via the API, Evidence requirements, l’objet de réponse Dispute, les codes de raison des chargebacks, Disputing chargebacks, Dispute: Accept et PayPal disputes (tous consultés en novembre 2026). Pour les appels d’API de base et les noms des webhooks, voir la section sur les litiges de la récupération des paiements d’abonnement échoués sur Braintree.

Types et statuts de litige

L’objet dispute a un kind et un status.

Types :

Type Ce que c’est
Retrieval Une demande d’informations sur une transaction
Chargeback La banque du titulaire annule la transaction
Pre-arbitration Une étape ultérieure, après un chargeback

Statuts : Open, Accepted, Auto Accepted, Disputed, Won, Lost et Expired. « Disputed » signifie que vous avez soumis des preuves et attendez la décision de la banque. « Expired » signifie que la date limite de réponse est passée et que vous avez perdu le droit de contester.

Les transactions PayPal traitées via Braintree suivent le processus propre à PayPal, en trois étapes (retrieval, claim, chargeback) décrites dans le guide des litiges PayPal de Braintree. Braintree précise que les retrievals et les claims résolus via PayPal ou votre passerelle n’entraînent pas de frais de litige, alors qu’un litige qui devient chargeback peut entraîner des frais de l’émetteur ou de la banque.

Acceptation automatique des pre-arbitrations

D’après l’article de Braintree sur la contestation des chargebacks, depuis le 27 août 2025, Braintree accepte automatiquement les pre-arbitrations de moins de 1 000 $ pour les marchands au forfait aux États-Unis, et des frais de traitement de la pre-arbitration sont facturés quel que soit le résultat. Si vous êtes dans ce groupe, votre effort doit porter sur la première réponse au chargeback.

Tout se joue sur la date limite de réponse

Chaque litige a une date limite de réponse (reply-by date). Selon Braintree, vous devez ajouter vos preuves et finaliser avant cette date, sinon votre réponse n’est pas prise en compte par la banque. Si vous ne répondez pas, une réponse Accept est envoyée en votre nom. Téléverser des preuves sans finaliser revient à ne pas répondre.

Règles pratiques :

  • Utilisez Dispute: Search filtré par date limite de réponse pour lister tout ce qui arrive à échéance dans les prochains jours.
  • Fixez une échéance interne deux jours ouvrés avant la date limite.
  • Les preuves ne peuvent être ajoutées ou retirées (avec Dispute: Remove Evidence) que tant que le litige est Open.

Les codes de raison qui touchent les abonnements

L’article sur les codes de raison des chargebacks et la référence des litiges listent, entre autres :

  • Transaction récurrente annulée : le titulaire dit avoir été facturé pour un prélèvement récurrent qu’il avait résilié ou tenté de résilier. Les codes des marques de cartes listés par Braintree incluent Visa 41 et 1320, Mastercard 41 et 4841, Discover 4541 et American Express C28.
  • Fraude / non autorisé : le titulaire dit ne pas avoir effectué l’achat.
  • Non reçu : le titulaire dit ne pas avoir reçu le produit ou le service.

Pour les abonnements, « transaction récurrente annulée » et « fraude » venant de clients qui ont oublié l’abonnement forment le duo habituel. Chacun demande des preuves différentes.

Les preuves catégorisées : la règle qui piège les équipes

Les exigences de preuves de Braintree indiquent que, quand vous répondez à un litige pour fraude ou non-réception, vous devez catégoriser chaque preuve selon l’exigence qu’elle remplit. Un tableau du même guide liste les catégories acceptées pour chaque code de raison ; utiliser une catégorie non autorisée pour ce code est une erreur de validation, tout comme finaliser sans preuve valable.

Deux catégories comptent le plus pour la facturation récurrente :

  • RECURRING_TRANSACTION_ID : l’ID d’une transaction récurrente précédente non contestée pour le même service.
  • RECURRING_TRANSACTION_DATE_TIME : la date de cette transaction. Braintree l’exige chaque fois que vous fournissez un ID de transaction récurrente (ou un ARN) ; une réponse sans elle est rejetée.

La preuve d’un historique de transactions récurrentes non contestées fait partie des types de preuves que Braintree liste pour certains litiges pour fraude et non-réception. Concrètement : si la même carte vous a payé pendant des mois sans réclamation, dites-le, dans la bonne catégorie, avec les dates.

Quand vous contestez depuis le Control Panel, Braintree ajoute automatiquement à votre réponse des détails de transaction comme les résultats AVS et CVV.

Quoi soumettre, selon la raison

Raison Preuves qui y répondent
Transaction récurrente annulée Votre politique de résiliation telle qu’affichée à l’inscription ; l’historique du compte montrant l’absence de demande de résiliation avant le prélèvement (ou la date de résiliation et le fait que le prélèvement la précédait) ; les rappels de renouvellement envoyés
Fraude (le client ne reconnaît pas le prélèvement) Les paiements récurrents antérieurs non contestés sur la même carte (catégorisés), les informations d’inscription, les connexions et l’usage après le prélèvement contesté
Non reçu / service non fourni Les journaux d’usage de la période facturée, les traces d’accès, les conversations de support où le client a utilisé le service

Gardez chaque document ciblé. Un résumé d’une page qui expose les faits avec les dates, suivi des enregistrements justificatifs, est plus facile à lire pour un analyste bancaire qu’un long export.

Quand accepter plutôt

Dispute: Accept clôt un litige Open en faveur du client. La documentation de Braintree ajoute une remarque importante : si vous avez déjà remboursé la transaction, n’acceptez pas ; soumettez plutôt le remboursement comme preuve. Acceptez quand :

  • le client a bien résilié et vous avez prélevé quand même (corrigez le bug, puis remboursez les autres clients concernés) ;
  • les preuves dont vous disposez ne répondent pas au code de raison ;
  • le montant est inférieur au temps que prendrait une réponse, et vous n’avez pas de schéma récurrent à défendre.

Un processus pour chaque litige

  1. Le webhook arrive. Sur dispute_opened, récupérez le litige et enregistrez le type, la raison, le montant et la date limite de réponse.
  2. Arrêtez les prélèvements futurs si c’est pertinent. Un client qui conteste un renouvellement a peu de chances de payer le suivant. Décidez s’il faut résilier l’abonnement ou suspendre l’accès pendant que le dossier est ouvert.
  3. Rassemblez les enregistrements de facturation, d’usage du produit, d’email et de support, pour le client et la période contestée.
  4. Choisissez les catégories autorisées pour ce code de raison et rattachez chaque enregistrement à l’une d’elles.
  5. Rédigez le résumé, ajoutez les preuves texte et fichier.
  6. Finalisez avant votre échéance interne.
  7. Suivez le résultat grâce aux webhooks dispute_won et dispute_lost, par code de raison.
  8. Corrigez la cause. Libellé peu clair, rappel de renouvellement absent, bouton d’annulation difficile à trouver : chaque litige perdu doit faire changer quelque chose. Pour la prévention, voir les règles click-to-cancel et les rappels de renouvellement des offres annuelles.

Testez avant la mise en production

La sandbox de Braintree peut simuler les résultats : soumettre le texte compelling_evidence puis finaliser fait passer un litige de test à Won, et losing_evidence simule une défaite (guide de test). Utilisez-la pour vérifier votre catégorisation et votre logique de finalisation de bout en bout.

Le faire avec NoChurn

Braintree garde le litige, la décision et les fonds. NoChurn suit les webhooks de litige de Braintree et réunit automatiquement les preuves : réponses du parcours d’annulation, emails envoyés, usage du produit et conversations de support. Il rédige une réponse avec l’IA, et rien n’est envoyé à Braintree tant qu’une personne de votre équipe ne l’a pas relue et approuvée. Les conversations de support viennent de connecteurs help desk en lecture seule et sont citées telles quelles. Voir NoChurn + Braintree.

PROMPT

Read https://www.nochurn.sh/llms.txt,
then follow https://www.nochurn.sh/docs/quickstart/
to add NoChurn to this app. Use a test key
(nc_test_…) until I say we go live.

Arrêtez de perdre du revenu.

  • Gratuit jusqu’à $300 de MRR
  • Sans carte bancaire
  • Prêt en 10 minutes
  • Jamais une commission sur ce que nous récupérons