Cosa succede quando un pagamento fallisce su Polar

Polar vende i tuoi abbonamenti come merchant of record. Quando il rinnovo di un abbonamento fallisce, Polar gestisce da solo il recupero: riprova la carta, mantiene l’abbonamento in uno stato recuperabile e revoca i benefit se nulla funziona. Le regole sono semplici e per lo più fisse, ed è bene conoscerle prima di progettare qualsiasi cosa intorno.

Questa guida spiega la sequenza passo per passo, l’unica impostazione che controlli, i webhook da ascoltare e cosa puoi aggiungere senza scontrarti con il flusso di Polar. Si attiene alla documentazione di Polar: recovering failed payments, how subscriptions work, i webhook subscription.past_due e subscription.revoked (tutti consultati a novembre 2026). Dove le pagine di Polar non concordano o tacciono, lo diciamo.

La sequenza, passo per passo

Secondo la pagina sui pagamenti falliti di Polar:

1. Al rinnovo, Polar prima fa avanzare l’abbonamento al ciclo di fatturazione successivo, poi tenta di addebitare il metodo di pagamento predefinito del cliente.
2. Se l’addebito fallisce, l’abbonamento non viene cancellato. Passa a past_due ed entra nel recupero automatico dei pagamenti di Polar.
3. Polar riprova il pagamento secondo un calendario fisso: quattro tentativi distribuiti su 21 giorni, contati dal primo fallimento. Il calendario è fissato da Polar e non è configurabile.
4. Se nel frattempo il cliente aggiorna il metodo di pagamento, Polar riprova subito l’addebito invece di aspettare il prossimo tentativo programmato.
5. Se un nuovo tentativo va a buon fine, l’abbonamento torna in regola.
6. Se tutti i tentativi falliscono, o se il codice di rifiuto indica che il metodo di pagamento non funzionerà mai (Polar cita lost_card come esempio), Polar smette di riprovare e revoca l’abbonamento e i suoi benefit.

Il punto 6 merita attenzione. Polar non continua a riprovare una carta che non può funzionare, il che è il comportamento corretto, e significa che i rifiuti definitivi finiscono molto prima dei 21 giorni a meno che il cliente non intervenga.

L’impostazione che controlli: il grace period

Per impostazione predefinita, Polar revoca i benefit in modo rigoroso. Polar offre un grace period a livello di organizzazione che rimanda la revoca dei benefit mentre un abbonamento è past_due. Lo imposti in Settings, poi Subscriptions, poi «Grace period for benefit revocation».

Cosa fa e cosa non fa il grace period, secondo la documentazione di Polar:

	Durante il grace period
Stato dell’abbonamento	Ancora past_due
Benefit del cliente	Mantenuti
Calendario dei nuovi tentativi	Invariato
Misurato da	past_due_at

Quindi il grace period riguarda l’accesso, non l’incasso. È una buona scelta quando i benefit sono cose su cui i clienti contano ogni giorno (una chiave di licenza, l’accesso a un repository privato, un ruolo Discord) e perderli per un problema temporaneo della carta farebbe andare via il cliente per sempre.

Come il cliente risolve

La soluzione per la maggior parte dei rifiuti definitivi è una nuova carta. La panoramica sugli abbonamenti di Polar dice che il Customer Portal permette ai clienti di aggiornare il metodo di pagamento, scaricare le fatture e disdire. Poiché Polar riprova subito dopo un aggiornamento del metodo di pagamento, un cliente che aggiorna la carta recupera immediatamente l’abbonamento.

La documentazione di Polar che abbiamo consultato non descrive nel dettaglio il contenuto o i tempi delle eventuali email di notifica inviate ai clienti in caso di fallimento. Provalo in sandbox: provoca un fallimento con una carta di test e guarda cosa arriva nella casella del cliente prima di scrivere i tuoi messaggi, così non invii doppioni.

I webhook da ascoltare

Evento	Significato
subscription.past_due	Un rinnovo è fallito. Polar lo descrive come uno stato recuperabile: il cliente può aggiornare il metodo di pagamento per ripristinare l’abbonamento.
subscription.updated	L’abbonamento è cambiato, anche quando viene recuperato
subscription.revoked	L’abbonamento è stato revocato, perché cancellato o perché i nuovi tentativi di pagamento sono esauriti

Un’incoerenza da prevedere: la pagina su subscription.revoked di Polar dice che, quando i nuovi tentativi sono esauriti, lo stato diventa unpaid, mentre la pagina sui pagamenti falliti descrive l’abbonamento che termina come cancellato con i benefit revocati. Scrivi il tuo handler in modo che tratti entrambi come «non paga più», e registra lo stato che ricevi davvero.

Una configurazione pratica su Polar

1. Decidi il grace period. Se i benefit fanno parte del lavoro quotidiano, impostane uno. Se i benefit sono facili da ripristinare, una revoca rigorosa va bene.
2. Gestisci subscription.past_due nella tua app. Mostra un banner con un link al Customer Portal. Molti clienti non leggono mai le email di fatturazione, ma vedono il tuo prodotto.
3. Spiega cosa succede dopo. Di’ al cliente che Polar riproverà e che aggiornare la carta risolve subito.
4. Gestisci la revoca con garbo. Su subscription.revoked, conserva i dati del cliente, spiega perché l’accesso si è interrotto e offri un modo chiaro per tornare.
5. Registra ogni fallimento. Salva abbonamento, importo, data ed esito. Dopo qualche mese vedrai quanti si recuperano con un nuovo tentativo e quanti solo dopo un aggiornamento della carta.
6. Testa con le carte sandbox. Prova un rifiuto temporaneo, un rifiuto definitivo e un recupero prima di andare live.

Come appare la timeline per un cliente

Mettendo insieme le regole di Polar, un tipico rifiuto temporaneo si svolge così:

1. Giorno del rinnovo: l’addebito fallisce, l’abbonamento diventa past_due e subscription.past_due arriva alla tua app.
2. Nelle tre settimane successive: Polar fa i suoi nuovi tentativi programmati. Se hai impostato un grace period, il cliente mantiene i benefit per quel tempo.
3. In qualsiasi momento di quella finestra: il cliente aggiorna la carta nel Customer Portal, Polar riprova subito e l’abbonamento viene recuperato.
4. Fine della finestra senza successo: Polar revoca l’abbonamento, e subscription.revoked arriva alla tua app.

Per un rifiuto definitivo, il passo 2 può essere saltato del tutto, perché Polar smette di riprovare un metodo di pagamento che non può funzionare. Per questo il banner in-app conta di più per i rifiuti definitivi: l’azione del cliente è l’unica via per tornare, e la finestra è breve.

Cosa Polar non copre

Il recupero di Polar è volutamente semplice. Le parti che restano a te:

• Contesto. Polar tratta ogni fallimento allo stesso modo. Un fallimento su un cliente di lunga data che usa il prodotto ogni giorno merita un messaggio diverso da uno su un account dormiente.
• Messaggi con la tua voce. Se vuoi messaggi di recupero che citino il piano, l’utilizzo o il team del cliente, li scrivi tu.
• Misurazione. Recuperati e persi per mese, per causa. Vedi churn involontario per le definizioni e modelli di email di sollecito per idee di messaggi.
• Prevenzione. Le carte che scadono prima del prossimo rinnovo sono prevedibili. Un promemoria prima del rinnovo evita del tutto il fallimento; vedi carte in scadenza.

Farlo con NoChurn

Su Polar, incasso dei pagamenti, nuovi tentativi e calendario di 21 giorni restano a Polar come merchant of record; NoChurn non li modifica. Legge abbonamenti e fallimenti Polar, invia email di recupero scritte dall’IA che controlli prima dell’invio e assegna a ogni cliente un churn score da 0 a 100, arricchito con i tuoi dati inviati via API. Le disdette passano poi da un flusso di disdetta e ricevono email di win-back a 30, 60 e 90 giorni. Vedi NoChurn + Polar.