Braintree Account Updater e carte in scadenza

Quando la carta di un cliente scade o viene sostituita, ogni abbonamento sulla vecchia carta è un pagamento fallito in attesa di accadere. Braintree offre due servizi che recuperano i nuovi dati della carta dai circuiti senza chiedere nulla al cliente: Account Updater e i network token. Nessuno dei due copre tutte le carte, quindi ti serve comunque un modo per raggiungere i clienti che sfuggono.

Questa guida spiega come funziona ciascun servizio, i dettagli che contano per gli abbonamenti e un piano per il resto. Si attiene alla documentazione di Braintree: Account Updater, il webhook Account Updater, il report Expiring Cards, la panoramica sui network token, come funzionano i network token, Updating vault records e le impostazioni avanzate della fatturazione ricorrente (tutti consultati a novembre 2026). Per il quadro generale tra i vari fornitori, vedi network token e card account updater e carte in scadenza.

Account Updater

Cosa fa

Secondo la guida di Braintree ad Account Updater, Account Updater richiede automaticamente gli aggiornamenti dei metodi di pagamento salvati nel vault quando la carta di un cliente scade o viene sostituita, per aiutare a evitare transazioni fallite. Funziona tramite i programmi di aggiornamento dei circuiti, quindi un aggiornamento arriva solo se la banca emittente aderisce.

Chi può usarlo

Account Updater non è attivo per impostazione predefinita. Braintree dice che la maggior parte dei merchant Braintree Direct con sede negli Stati Uniti, o che operano principalmente con clienti statunitensi, può attivarlo, e chiede agli altri di contattarla. Le tariffe sono fissate nel tuo contratto: il report delle commissioni sugli accrediti di Braintree elenca Account Updater tra le commissioni di prodotto fatturate come commissioni per evento. Controlla il prezzo nel tuo contratto.

Cosa non copre

• Le carte prepagate non sono supportate.
• Le carte usate tramite Apple Pay o Google Pay non sono supportate.
• Circuiti: la guida per sviluppatori di Braintree elenca Visa, Mastercard e Discover, mentre la sua pagina commerciale cita anche American Express. Le due fonti non concordano su Amex; verifica con Braintree per il tuo account.

Quando vengono controllate le carte

Dopo un primo batch, Braintree invia le richieste di aggiornamento a ciclo continuo. La guida descrive diversi fattori scatenanti, tra cui:

• un pagamento ricorrente in scadenza entro due settimane;
• un rifiuto sulla carta, con un’eccezione documentata che conta per gli abbonamenti: una carta su un abbonamento mensile addebitata con successo 30 giorni prima non viene aggiunta a un batch la prima volta che viene rifiutata.

Questa eccezione significa che il primo rinnovo mensile fallito su una carta sostituita potrebbe non attivare da solo un aggiornamento. I tuoi nuovi tentativi e le email ai clienti devono coprire questo caso.

Next Day Card Refresh

Braintree descrive anche Next Day Card Refresh, che tenta di aggiornare le carte salvate dopo che un’autorizzazione viene rifiutata con determinati codici di rifiuto. Aiuta solo se qualcosa ritenta poi il pagamento, i nuovi tentativi della fatturazione ricorrente di Braintree o la tua logica. Se le impostazioni dei tentativi sono disattivate, la carta aggiornata resta inutilizzata fino al ciclo di fatturazione successivo. Controllale in Account Settings, Recurring Billing, Options (impostazioni avanzate).

Vedere cosa è cambiato

Puoi esaminare gli aggiornamenti nel Control Panel, in un report generato o tramite il webhook Account Updater daily report. Secondo il riferimento del webhook:

• è disponibile solo per i merchant che usano Account Updater;
• scatta una volta al giorno con i metodi di pagamento aggiornati nelle ultime 24 ore, e non scatta se non ce ne sono stati;
• il payload contiene una data del report e un URL del report, e il link scade dopo una settimana.

Scarica e conserva il report appena arriva. Se una carta è stata aggiornata, non devi più scrivere a quel cliente in merito.

Network token

I network token sono un servizio Braintree separato. Secondo la panoramica sui network token e come funzionano:

• Il circuito trasmette a Braintree gli aggiornamenti dell’emittente (riemissione, furto, smarrimento e modifiche come una scadenza vicina), e Braintree aggiorna i dati della carta nel tuo vault.
• Non serve alcuna modifica all’integrazione per iniziare a usarli.
• Sono disponibili per i merchant negli Stati Uniti e in alcune regioni di Nord America, Sud America ed Europa che elaborano full stack con Braintree.
• Un token potrebbe non essere sempre usato per una data transazione.

Braintree documenta anche che gli addebiti ricorrenti avviati dal merchant portano parametri aggiuntivi (come la fonte della transazione e l’ID della transazione di rete precedente) quando gestisci i pagamenti ricorrenti al di fuori della fatturazione ricorrente di Braintree. Se usi gli abbonamenti Braintree, verifica con Braintree come i token si applicano alla tua configurazione.

	Account Updater	Network token
Come aggiorna	Richieste ai programmi di aggiornamento dei circuiti, in batch e su eventi	Aggiornamenti del ciclo di vita dal circuito al token
Configurazione	Va attivato; idoneità soprattutto USA	Nessuna modifica all’integrazione; disponibilità regionale
Lacune	Prepagate, Apple Pay, Google Pay; emittenti non aderenti	Token non sempre usato

Il report Expiring Cards

Per le carte che nessuno dei due servizi intercetterà, il Control Panel di Braintree ha un report Expiring Cards: vai su Reports, trova la sezione Vault ed esegui Expiring Cards. Puoi filtrare per un intervallo di date personalizzato o vedere tutte le carte scadute. Eseguilo ogni mese per il mese successivo.

La trappola degli abbonamenti: le nuove carte non spostano gli abbonamenti

La documentazione del vault di Braintree fa notare che aggiungere un nuovo metodo di pagamento al vault di un cliente non aggiorna i suoi abbonamenti esistenti. Se un cliente aggiunge una nuova carta tramite la tua app, devi anche aggiornare ogni abbonamento perché usi il nuovo metodo di pagamento, poi ritentare ogni addebito scaduto con Subscription: Retry Charge. Dimenticare questo passaggio è un motivo comune per cui un cliente “ha aggiornato la carta” e se n’è andato comunque.

Un piano per le carte in scadenza su Braintree

1. Attiva Account Updater se sei idoneo, e i network token dove disponibili.
2. Attiva i nuovi tentativi automatici per la fatturazione ricorrente, così Next Day Card Refresh ha qualcosa su cui agire.
3. Conserva il report giornaliero di Account Updater e segna le carte aggiornate nel tuo sistema.
4. Esegui ogni mese il report Expiring Cards per le carte in scadenza il mese successivo.
5. Scrivi ai clienti le cui carte non sono state aggiornate, 30 giorni e poi circa 7 giorni prima della scadenza, con un solo link a una pagina di aggiornamento della carta.
6. Nella pagina di aggiornamento, salva la nuova carta, passa ogni abbonamento su di essa e ritenta ogni addebito scaduto.
7. Copri il primo rinnovo mensile fallito. Poiché la carta di un abbonamento mensile non entra in un batch al primo rifiuto, invia subito un’email di recupero invece di aspettare l’updater.
8. Escludi le carte non supportate (prepagate, Apple Pay, Google Pay) da qualsiasi presupposto che l’updater le gestisca.

Farlo con NoChurn

Account Updater, network token e l’addebito stesso restano a Braintree. NoChurn legge da Braintree tipo di metodo di pagamento, circuito, ultime quattro cifre e scadenza, e aggiunge email scritte dall’IA che rivedi prima dell’invio, con una pagina ospitata dove il cliente aggiorna il metodo di pagamento. Quando un rinnovo fallisce comunque, le email di recupero seguono accanto ai nuovi tentativi degli abbonamenti Braintree. Vedi NoChurn + Braintree.