Come gestire le carte in scadenza in Maxio

Una carta in scadenza è il pagamento fallito più prevedibile che esista: sai in che mese smetterà di funzionare prima che succeda. Maxio Advanced Billing (ex Chargify) ti dà tre strumenti: email automatiche di scadenza della carta, un webhook expiring_card e il supporto all’account updater su alcuni gateway. Questa guida spiega cosa fa ciascuno, dove lasciano lacune e come combinarli perché i rinnovi non falliscano per un motivo che potevi vedere arrivare.

Si attiene alla documentazione di Maxio: configurare le impostazioni email, modelli di email, eventi webhook, esempi di payload, confrontare le funzioni dei gateway, gestire i metodi di pagamento, aggiornare i dati di pagamento di un cliente e il glossario di Advanced Billing (tutti consultati a novembre 2026). Dove le pagine di Maxio non concordano, lo segnaliamo. Per cosa succede quando un rinnovo è già fallito, vedi come ridurre il churn involontario in Maxio.

Passo 1: lasciare che l’account updater faccia ciò che può

I circuiti delle carte gestiscono servizi di account updater: quando una banca riemette una carta, il nuovo numero o la nuova data di scadenza possono arrivare all’esercente senza che il cliente faccia nulla. In Maxio, il supporto dipende dal tuo gateway:

Gateway	Account updater in Advanced Billing
Stripe, BlueSnap, Cybersource, Forte (Beta), Maxio Payments	Pienamente supportato: Maxio riceve gli aggiornamenti e mantiene aggiornati i dati delle carte salvate
Altri gateway	L’updater del gateway in genere funziona comunque tramite il suo token, quindi gli addebiti possono riuscire, ma i nuovi dati della carta potrebbero non comparire in Advanced Billing

Alcuni gateway richiedono una configurazione. Per BlueSnap, la guida di configurazione di Maxio chiede di configurare i webhook di BlueSnap e spuntare “Send Account Updater”. Per Forte, l’updater va prima attivato nell’account Forte. Su Stripe, la documentazione di Maxio lega l’updater automatico all’integrazione Stripe Connect.

Due limiti dalla documentazione di Maxio:

• Non tutte le banche emittenti partecipano. Un updater funziona solo quando la banca emittente della carta aderisce, quindi alcune carte scadranno senza aggiornamento.
• Un updater può disattivare un profilo. Quando un updater non trova un conto, può rimuovere il record, lasciando disattivato il profilo di pagamento dell’abbonato. La pagina sui metodi di pagamento di Maxio dice che, al momento della stesura, era successo solo agli esercenti Authorize.Net che usavano l’updater.

Il secondo punto conta per il primo: se il tuo gateway aggiorna la carta in silenzio e Maxio non lo mostra, Maxio può ancora credere che la carta stia per scadere e scrivere al cliente al riguardo. Sappi in quale caso ti trovi prima di scrivere l’email.

Passo 2: le email di scadenza della carta

Maxio può inviare Card Expiration Emails ai clienti la cui carta registrata sta per scadere (modelli di email). Il modello può includere il numero di giorni alla scadenza e un link di aggiornamento, {{update_url}}, che è l’URL self-service dell’abbonamento, così il cliente inserisce da solo la nuova carta e tu non tocchi mai i dati della carta.

Quando vengono inviate: due versioni nella documentazione di Maxio

Le pagine di Maxio indicano due calendari:

• L’attuale pagina delle impostazioni email dice che le email partono tre volte nel mese in cui la carta scade: il 1°, il 15 e una settimana prima della fine del mese (quindi la terza data varia con la lunghezza del mese).
• Il glossario e la pagina dei modelli di email citano il 1°, il 15 e il 23, e il glossario fa riferimento al mese precedente alla scadenza della carta.

La pagina delle impostazioni email è la più precisa e sembra la più recente, ma verifica un invio reale sul tuo sito prima di costruire qualcosa che dipende dalle date esatte.

Rendere utile l’email

Il modello predefinito è un punto di partenza. Una buona email per una carta in scadenza:

1. Dice quale carta (circuito e ultime quattro cifre) e quale abbonamento.
2. Indica la data in cui verrà addebitato il prossimo rinnovo, se cade dopo la scadenza.
3. Ha un solo pulsante verso il link di aggiornamento, funzionante su telefono, senza password da ricordare.
4. Arriva dal tuo brand e da un vero indirizzo di risposta.

Passo 3: il webhook expiring_card

Maxio invia anche un webhook expiring_card. Secondo la sua pagina sugli eventi webhook, è periodico: inviato il 1°, il 15 e 7 giorni prima della fine del mese, e identifica tutte le carte che scadono nel mese corrente. Il payload contiene l’oggetto subscription, con i dati del cliente, del prodotto e della carta.

Nota cosa significa: il webhook arriva nel mese della scadenza, non settimane prima. Per un piano mensile fatturato all’inizio del mese va bene. Per un cliente il cui rinnovo è il 2 e la cui carta scade alla fine di quel mese, va bene anche così. Ma per un piano annuale che si rinnova la prossima primavera, un avviso “scade questo mese” oggi non è il problema; lo è la carta che sarà registrata al rinnovo. Usa il webhook come trigger, e decidi cosa fare con la tua logica:

• Rinnovo prima della scadenza: nessuna azione necessaria ora; il prossimo rinnovo riuscirà.
• Rinnovo dopo la scadenza, piano mensile: chiedi subito una nuova carta.
• Piano annuale: confronta tu, in anticipo, la data di scadenza della carta con la data di rinnovo, invece di aspettare il webhook.

Passo 4: altri modi per ottenere una nuova carta

Quando l’email non funziona, Maxio offre opzioni manuali e in blocco (aggiornare i dati di pagamento di un cliente):

• Dall’abbonamento. Nella scheda Payment Details, “Email Customer to Request Payment Update” invia al cliente un link alla sua pagina self-service. Maxio lo consiglia rispetto all’inserire tu i nuovi dati della carta per il cliente.
• In blocco. Un’email in blocco già scritta, “Request Payment Method Update”, invia un link di aggiornamento sicuro a un gruppo di abbonati.
• Nel Billing Portal. I clienti aggiungono una carta in Payment, o usano Update Payment Method su un abbonamento specifico.
• Maxio Core. Se usi Maxio Core invece di Advanced Billing, la documentazione descrive come copiare un link dalla pagina del profilo di fatturazione e-Bill del cliente e inviarlo.

Aggiungi anche un messaggio dentro il tuo prodotto: un banner per il titolare dell’account quando la sua carta scade questo mese raggiunge chi ignora le email.

Una checklist

• Sai se l’account updater del tuo gateway è pienamente supportato in Advanced Billing.
• Le impostazioni dell’updater lato gateway sono attive dove serve.
• Le Card Expiration Emails sono attive, con il tuo brand e un link di aggiornamento funzionante.
• Hai verificato su un invio reale quale calendario usa Maxio sul tuo sito.
• expiring_card è gestito, con una logica per piani mensili e annuali.
• Per i piani annuali la scadenza viene confrontata con la data di rinnovo con largo anticipo.
• Un banner in-app compare quando la carta registrata sta per scadere.
• Il dunning è configurato per le carte che non sei riuscito a intercettare in tempo.

Farlo con NoChurn

NoChurn legge gli abbonamenti Maxio e il tipo e la data di scadenza di ogni profilo di pagamento, e li usa nel churn score da 0 a 100 del cliente. Quando un rinnovo fallisce, NoChurn invia email di recupero scritte dall’IA e riviste da te, insieme al tuo dunning Maxio, con un link per aggiornare il profilo di pagamento. Dati della carta, addebito e account updater restano a Maxio e al tuo gateway. NoChurn è gratuito sotto i 300 $ di MRR, con tutte le funzioni in ogni piano (il tuo dominio email da 9 $). Vedi NoChurn + Maxio.