Come gestire le carte in scadenza in Zuora
Evitare che le carte scadute facciano fallire i rinnovi Zuora: Payment Method Updater, updater in tempo reale, eventi a 15 e 30 giorni e pagine hosted.
Di Florian
Le carte scadute sono i pagamenti falliti più prevedibili che esistano. Conosci la data di scadenza con mesi di anticipo, eppure molti rinnovi falliscono ancora su carte scadute il mese scorso. Zuora ti dà due strumenti complementari contro questo problema: un updater automatico che recupera i nuovi dati della carta dai circuiti, ed eventi di scadenza che ti permettono di chiedere al cliente prima che qualcosa fallisca.
Questa guida spiega entrambi, poi ti dà una configurazione da applicare. Si attiene alla documentazione di Zuora: Payment Method Updater, la panoramica di Payment Method Updater, Set up Chase Payment Method Updater, Support for Real Time Account Updater (Adyen), Standard events for Zuora Payments e How do I allow customers to modify their stored payment methods? (tutte consultate a novembre 2026). Per il contesto generale su updater e network token, vedi network token e card account updater.
Perché le carte scadute falliscono ancora
Le banche sostituiscono le carte per molti motivi: scadenza, smarrimento, frode, un nuovo design. Il cliente riceve una nuova carta e la aggiorna nei posti che ricorda; gli abbonamenti attivati tempo fa non sono nell’elenco. Quando il rinnovo parte sulla vecchia carta, viene rifiutato. Se nessuno interviene, un cliente che non aveva alcuna intenzione di andarsene fa churn.
Ci sono due modi per risolverlo:
- Ottenere i nuovi dati dal circuito, senza coinvolgere il cliente. È ciò che fanno i servizi di account updater.
- Chiedere al cliente di aggiornare la carta, idealmente prima che la vecchia scada.
Ti servono entrambi, perché gli updater coprono solo gli emittenti aderenti e alcuni tipi di carta.
Payment Method Updater (batch)
Il Payment Method Updater (PMU) di Zuora invia i dati delle carte in batch ai servizi di aggiornamento dei circuiti e scrive i risultati in Zuora. Secondo la documentazione PMU e la sua panoramica:
- Copre Visa, Mastercard e American Express, tramite i servizi Visa Account Updater, Mastercard Automatic Billing Updater e American Express Card Refresher.
- Viene eseguito prima di ogni bill cycle day, così i dati aggiornati sono pronti quando il payment run addebita la carta.
- I risultati possono includere un nuovo numero di carta (Zuora lo salva come nuovo metodo di pagamento predefinito), una nuova data di scadenza o un indicatore di conto chiuso. Le carte segnate come chiuse non vengono più usate per elaborare pagamenti.
- Il servizio richiede di solito da 2 a 5 giorni, perché l’updater di ogni circuito segue il proprio calendario.
Supporto dei gateway
Il PMU si configura per tipo di gateway. La documentazione di Zuora elenca il supporto PMU per gateway tra cui Adyen, BlueSnap, Chase, Checkout.com, CyberSource, First Data, Merchant e-Solutions, Vantiv e Worldpay, e indica Global Payments come non supportato. Alcuni updater (CyberSource, e l’updater American Express di Zuora) funzionano senza un contratto separato di elaborazione dei pagamenti con quel gateway; gli altri richiedono che tu elabori i pagamenti anche tramite quel gateway. Un updater copre tutti i metodi di pagamento di un tipo di gateway; l’aggiornamento di istanze specifiche di gateway non è supportato.
I tempi del batch
Configuri quanti giorni prima del bill cycle day parte il servizio. L’anticipo giusto dipende dal gateway: per Chase, Zuora consiglia 10 giorni, in Settings, Payments, Set Up Payment Method Updater (configurazione Chase). Partire troppo tardi significa che l’aggiornamento arriva quando il payment run è già stato rifiutato.
Quando le carte non si possono inviare
La guida alla risoluzione dei problemi di Zuora segnala che i dati di carta non validi compaiono con stato Warning e tipo di aggiornamento NotApprovedForSubmitted, che puoi esportare da Reporting, Data Sources. Quelle carte non verranno mai aggiornate in automatico, quindi passano direttamente al contatto con il cliente.
Updater in tempo reale
Alcuni gateway aggiornano i dati della carta al momento del pagamento invece che in batch. Zuora documenta il supporto dell’updater in tempo reale per Adyen (Adyen RTAU), limitato alle carte Visa e Mastercard emesse negli Stati Uniti e in Canada, e una pagina separata per uno Stripe real-time account updater. Verifica le condizioni su quelle pagine per il tuo account prima di farci affidamento.
Eventi di scadenza: chiedi prima che fallisca
Gli eventi standard per i pagamenti di Zuora includono due avvisi di scadenza legati all’evento Payment Method Expiration:
| Evento | Quando scatta |
|---|---|
| 30 Day Warning | Il metodo di pagamento predefinito dell’account scade entro 30 giorni |
| 15 Day Warning | Il metodo di pagamento predefinito dell’account scade entro 15 giorni |
Dettagli dalla documentazione di Zuora:
- La data di scadenza di una carta è l’ultimo giorno del mese di scadenza.
- Un job programmato valuta questi eventi ogni giorno (alle 5:15 UTC per i tenant EU e US Cloud Data Center 1, alle 5:15 ora di Los Angeles per US Cloud Data Center 2).
- Gli avvisi partono anche per un metodo di pagamento chiuso; Zuora consiglia di non lasciare un metodo chiuso come predefinito dell’account.
- Riguardano solo il metodo di pagamento predefinito.
Ogni avviso può essere consegnato via email o come callout al tuo sistema. Poiché nel frattempo il PMU potrebbe aggiornare la carta, fai in modo che il gestore dell’email o del callout ricontrolli la scadenza sull’account prima di inviare qualcosa al cliente.
Dare al cliente un modo per aggiornare
Quando l’updater non può aiutare, il cliente deve inserire una nuova carta. La guida di Zuora sulla modifica dei metodi di pagamento salvati descrive le opzioni:
- La pagina di pagamento hosted (Payment Pages 2.0), caricata con l’ID del metodo di pagamento esistente (
pmId) così il cliente può aggiornare i dati della carta. Così i dati della carta restano fuori dai tuoi server. - L’API Update a payment method, che Zuora sconsiglia per i dati delle carte a favore di Payment Pages 2.0.
- L’interfaccia di Zuora, per gli agenti del supporto.
Collega le tue email di scadenza direttamente a una pagina che carica il modulo di pagamento hosted per quell’account. Dopo che la nuova carta è salvata come predefinita, il payment run successivo la usa.
Un piano di configurazione
- Attiva il PMU per ogni tipo di gateway che usi, con un anticipo adatto al gateway (10 giorni per Chase, secondo Zuora).
- Verifica le opzioni di updater in tempo reale se elabori tramite Adyen o Stripe.
- Attiva gli avvisi a 30 e 15 giorni con un callout al tuo sistema.
- Ricontrolla prima di inviare. Se il PMU ha già aggiornato la carta, salta l’email.
- Invia l’email a 30 giorni con un link alla pagina di pagamento hosted. Tienila breve: quale carta, quando scade, un pulsante.
- Invia il promemoria a 15 giorni solo se la carta è ancora invariata.
- Esporta ogni mese le carte NotApprovedForSubmitted e contatta direttamente quei clienti.
- Mantieni un piano B per i pagamenti falliti. Alcune carte falliranno comunque; vedi come recuperare i pagamenti falliti in Zuora.
Farlo con NoChurn
Payment Method Updater, eventi di scadenza e payment run di Zuora restano in Zuora. NoChurn legge da Zuora il tipo e la scadenza del metodo di pagamento e aggiunge email scritte dall’IA che controlli prima che partano, con un link con cui il cliente aggiorna il metodo di pagamento, più email di recupero quando un rinnovo fallisce comunque. Ogni cliente riceve anche un churn score da 0 a 100. Vedi NoChurn + Zuora.