Braintree Account Updater et cartes qui expirent

Quand la carte d’un client expire ou est remplacée, chaque abonnement sur l’ancienne carte est un paiement échoué en puissance. Braintree propose deux services qui récupèrent les nouvelles données de carte auprès des réseaux sans rien demander au client : Account Updater et les network tokens. Aucun des deux ne couvre toutes les cartes, donc il vous faut toujours un moyen de joindre les clients qu’ils ratent.

Ce guide explique comment fonctionne chaque service, les détails qui comptent pour les abonnements, et un plan pour le reste. Il s’en tient à la documentation de Braintree : Account Updater, le webhook Account Updater, le rapport Expiring Cards, la vue d’ensemble des network tokens, How network tokens work, Updating vault records et les réglages avancés de la facturation récurrente (tous consultés en novembre 2026). Pour la vue d’ensemble tous fournisseurs confondus, voir les network tokens et les card account updaters et les cartes qui expirent.

Account Updater

Ce qu’il fait

D’après le guide Account Updater de Braintree, Account Updater demande automatiquement des mises à jour pour les moyens de paiement enregistrés dans le vault quand la carte d’un client expire ou est remplacée, pour aider à éviter les transactions échouées. Il passe par les programmes de mise à jour des réseaux de cartes, donc une mise à jour n’arrive que si la banque émettrice y participe.

Qui peut l’utiliser

Account Updater n’est pas activé par défaut. Braintree indique que la plupart des marchands Braintree Direct domiciliés aux États-Unis, ou qui vendent surtout à des clients américains, peuvent l’activer, et demande aux autres de le contacter. Les frais sont fixés dans votre contrat : le rapport des frais de versement de Braintree liste Account Updater parmi les frais de produit facturés à l’événement. Vérifiez le prix dans votre contrat.

Ce qu’il ne couvre pas

Les cartes prépayées ne sont pas prises en charge.
Les cartes utilisées via Apple Pay ou Google Pay ne sont pas prises en charge.
Marques de cartes : le guide développeur de Braintree liste Visa, Mastercard et Discover, tandis que sa page marketing cite aussi American Express. Les deux sources divergent sur Amex ; confirmez avec Braintree pour votre compte.

Quand les cartes sont vérifiées

Après un premier lot, Braintree envoie des demandes de mise à jour en continu. Le guide décrit plusieurs déclencheurs, dont :

un paiement récurrent dû dans les deux semaines ;
un refus sur la carte, avec une exception documentée qui compte pour les abonnements : une carte sur un abonnement mensuel prélevée avec succès 30 jours plus tôt n’est pas ajoutée à un lot la première fois qu’elle est refusée.

Cette exception signifie que le premier renouvellement mensuel échoué sur une carte remplacée peut ne pas déclencher de mise à jour à lui seul. Vos relances et vos emails aux clients doivent le couvrir.

Next Day Card Refresh

Braintree décrit aussi Next Day Card Refresh, qui tente de mettre à jour les cartes du vault après une autorisation refusée avec certains codes de refus. Cela n’aide que si quelque chose relance le paiement ensuite, soit les relances de la facturation récurrente de Braintree, soit votre propre logique. Si vos réglages de relance sont désactivés, la carte actualisée reste inutilisée jusqu’au cycle de facturation suivant. Vérifiez-les dans Account Settings, Recurring Billing, Options (réglages avancés).

Voir ce qui a changé

Vous pouvez consulter les mises à jour dans le Control Panel, dans un rapport généré ou via le webhook Account Updater daily report. D’après la référence du webhook :

il n’est disponible que pour les marchands qui utilisent Account Updater ;
il se déclenche une fois par jour avec les moyens de paiement mis à jour dans les dernières 24 heures, et ne se déclenche pas s’il n’y en a eu aucun ;
le contenu comporte une date de rapport et une URL de rapport, et le lien expire au bout d’une semaine.

Téléchargez et enregistrez le rapport dès son arrivée. Si une carte a été mise à jour, vous n’avez plus besoin d’écrire à ce client à son sujet.

Les network tokens

Les network tokens sont un service Braintree distinct. D’après la vue d’ensemble des network tokens et leur fonctionnement :

Le réseau de cartes transmet les mises à jour de l’émetteur (réémission, vol, perte, et changements comme une expiration proche) à Braintree, qui met à jour les données de carte dans votre vault.
Aucun changement d’intégration n’est nécessaire pour commencer à les utiliser.
Ils sont disponibles pour les marchands aux États-Unis et dans certaines régions d’Amérique du Nord, d’Amérique du Sud et d’Europe qui traitent en full stack avec Braintree.
Un token n’est pas forcément utilisé pour une transaction donnée.

Braintree documente aussi que les prélèvements récurrents à l’initiative du marchand portent des paramètres supplémentaires (comme la source de la transaction et l’ID de transaction réseau précédent) quand vous gérez les paiements récurrents en dehors de la facturation récurrente de Braintree. Si vous utilisez les abonnements Braintree, vérifiez avec Braintree comment les tokens s’appliquent à votre configuration.

	Account Updater	Network tokens
Mode de mise à jour	Demandes aux programmes de mise à jour des réseaux, par lots et sur déclencheurs	Mises à jour du cycle de vie du réseau vers le token
Mise en place	Doit être activé ; éligibilité surtout aux États-Unis	Aucun changement d’intégration ; disponibilité régionale
Manques	Prépayées, Apple Pay, Google Pay ; émetteurs non participants	Token pas toujours utilisé

Le rapport Expiring Cards

Pour les cartes qu’aucun des deux services ne rattrapera, le Control Panel de Braintree propose un rapport Expiring Cards : allez dans Reports, trouvez la section Vault et lancez Expiring Cards. Vous pouvez filtrer sur une plage de dates personnalisée ou voir toutes les cartes expirées. Lancez-le chaque mois pour le mois suivant.

Le piège des abonnements : une nouvelle carte ne déplace pas les abonnements

La documentation du vault de Braintree souligne qu’ajouter un nouveau moyen de paiement au vault d’un client ne met pas à jour ses abonnements existants. Si un client ajoute une nouvelle carte dans votre app, vous devez aussi basculer chaque abonnement sur ce nouveau moyen de paiement, puis relancer tout prélèvement en retard avec Subscription: Retry Charge. Oublier cette étape est une raison fréquente pour laquelle un client « a mis à jour sa carte » et a quand même churné.

Un plan pour les cartes qui expirent sur Braintree

Activez Account Updater si vous êtes éligible, et les network tokens là où ils sont disponibles.
Activez les relances automatiques de la facturation récurrente pour que Next Day Card Refresh ait quelque chose sur quoi agir.
Enregistrez le rapport quotidien d’Account Updater et marquez les cartes mises à jour dans votre système.
Lancez le rapport Expiring Cards chaque mois pour les cartes qui expirent le mois suivant.
Écrivez aux clients dont la carte n’a pas été mise à jour, 30 jours puis environ 7 jours avant l’expiration, avec un seul lien vers une page de mise à jour de la carte.
Sur la page de mise à jour, enregistrez la nouvelle carte, basculez chaque abonnement dessus et relancez tout prélèvement en retard.
Couvrez le premier renouvellement mensuel échoué. Comme la carte d’un abonnement mensuel n’entre pas dans un lot à son premier refus, envoyez tout de suite un email de récupération plutôt que d’attendre l’updater.
Excluez les cartes non prises en charge (prépayées, Apple Pay, Google Pay) de toute hypothèse selon laquelle l’updater s’en chargera.

Le faire avec NoChurn

Account Updater, les network tokens et le prélèvement lui-même restent chez Braintree. NoChurn lit dans Braintree le type de moyen de paiement, la marque, les 4 derniers chiffres et l’expiration, et ajoute des emails rédigés par l’IA que vous relisez avant leur envoi, avec une page hébergée où le client met à jour son moyen de paiement. Quand un renouvellement échoue malgré tout, des emails de récupération suivent en parallèle des relances d’abonnement de Braintree. Voir NoChurn + Braintree.