Come funzionano i pagamenti falliti su Paddle Billing, e cosa puoi aggiungere

Quando un rinnovo fallisce su Paddle Billing, molte cose succedono senza di te: Paddle è il merchant of record, riprova il pagamento e può scrivere al cliente. È un vero vantaggio rispetto a costruire i solleciti da solo. Significa anche che devi sapere esattamente cosa fa Paddle, per non duplicarlo né lasciare buchi.

Questa guida spiega come Paddle Billing gestisce un pagamento fallito di un abbonamento, cosa aggiunge Paddle Retain, come i clienti aggiornano i dati di pagamento e le parti che puoi migliorare tu. Si attiene alla documentazione di Paddle: il changelog sul dunning predefinito, configure Payment Recovery and dunning, Payment Recovery, update payment details e l’articolo di assistenza di Paddle sulla cadenza dei nuovi tentativi di Retain (tutti consultati a novembre 2026).

Cosa succede quando un rinnovo fallisce

Per un abbonamento incassato automaticamente, la guida al dunning di Paddle descrive la sequenza:

1. Il pagamento della transazione di rinnovo fallisce.
2. Lo stato dell’abbonamento passa a past_due.
3. Paddle invia transaction.payment_failed per il tentativo, poi transaction.past_due e subscription.past_due quando la transazione e l’abbonamento diventano scaduti.
4. Paddle riprova il pagamento.
5. Se un nuovo tentativo va a buon fine, l’abbonamento torna active e non è più scaduto.

Nuovi tentativi predefiniti, con o senza Retain

Il changelog 2025 di Paddle ha reso disponibili a tutti gli utenti Paddle Billing i nuovi tentativi automatici dopo un pagamento fallito. I pagamenti falliti degli abbonamenti incassati automaticamente vengono riprovati fino a sette volte in 30 giorni, anche se non hai attivato Paddle Retain.

Due limiti da conoscere:

• Solo account live. Paddle dice che i nuovi tentativi automatici avvengono solo sugli account live. In sandbox non c’è alcun nuovo tentativo, quindi lì non puoi testare il calendario completo.
• Solo incasso automatico. Per gli abbonamenti incassati manualmente (pagati su fattura), Paddle Retain non fa nulla quando sono scaduti. Paddle ha spostato questi abbonamenti in past_due nel 2024, ma sollecitarli spetta a te.

Cosa succede alla fine della finestra

Secondo l’articolo di assistenza di Paddle sulla cadenza dei nuovi tentativi, sei tu a stabilire cosa succede a un abbonamento quando la finestra di recupero termina: cancellarlo, metterlo in pausa o lasciarlo scaduto. Il valore predefinito è la cancellazione dopo 30 giorni, e la finestra si può modificare dalla dashboard di Paddle.

Scegli con cognizione. Cancellare è pulito per i report. Mettere in pausa conserva l’abbonamento, così il cliente può tornare senza un nuovo checkout. Lasciarlo scaduto tiene la porta aperta ma può lasciare ai clienti un accesso che non stanno pagando, a meno che la tua app non controlli lo stato.

Cosa aggiunge Paddle Retain

Payment Recovery fa parte di Paddle Retain. Oltre ai nuovi tentativi predefiniti, la documentazione di Paddle descrive:

Funzione	Cosa dice Paddle che fa
Tactical Retries	Riprova i pagamenti falliti in momenti scelti in base al tipo di metodo di pagamento, alla posizione del cliente e ad altri dettagli
Email di recupero	Fino a quattro email di recupero del pagamento
Altri canali	Promemoria di pagamento in-app e via SMS
Fine del dunning	Può mettere in pausa o cancellare automaticamente gli abbonamenti quando tutti i tentativi sono esauriti

Per impostazione predefinita, il dunning di Retain dura 30 giorni. Controlla nella dashboard di Paddle se Payment Recovery è attivo per il tuo account prima di dare per scontato che tutto questo valga per te.

Se usi Retain, lascia che sia lui a gestire nuovi tentativi ed email. Un secondo calendario di tentativi sulla stessa carta aggiunge tentativi senza aggiungere informazioni, e due sequenze di sollecito nella stessa casella sembrano spam.

Permettere ai clienti di aggiornare i dati di pagamento

La maggior parte dei rifiuti definitivi si recupera solo quando il cliente ti dà una nuova carta. La guida update payment details di Paddle elenca le opzioni:

1. Customer portal. Il portale di Paddle è attivo per impostazione predefinita e permette ai clienti di aggiornare il metodo di pagamento senza schermate tue.
2. Sessione del customer portal. Puoi creare un deep link autenticato che porta direttamente alla pagina di aggiornamento del metodo di pagamento per un abbonamento specifico, così il cliente non deve accedere.
3. URL di gestione dell’abbonamento. Paddle restituisce per ogni abbonamento un link update_subscription_payment_method che puoi mostrare nella tua app.
4. Transazione di aggiornamento del metodo di pagamento. Chiama GET /subscriptions/:id/update-payment-method-transaction. Se l’abbonamento è past_due, restituisce la transazione scaduta più recente. Apri il suo checkout.url, oppure passa l’ID della transazione a Paddle.js. Funziona solo quando collection_mode è automatic.

Un passaggio di configurazione sfugge spesso: il default payment link deve essere impostato nel tuo account Paddle e approvato prima che i clienti possano aggiornare i dati di pagamento. Paddle lo usa anche nelle sue email di sollecito.

Quando un abbonamento scaduto viene pagato dopo un aggiornamento, Paddle invia subscription.activated e lo stato torna active.

Una configurazione pratica

Che tu usi Retain o no, questi passi chiudono i buchi più comuni.

1. Imposta il default payment link e verifica che sia approvato. Senza, i link di aggiornamento non funzionano.
2. Scegli l’esito di fine finestra (cancellazione, pausa o past due) in base a come la tua app gestisce l’accesso.
3. Condiziona l’accesso allo stato. Gestisci subscription.past_due, subscription.activated e subscription.canceled nella tua app. Decidi quanto accesso mantiene un cliente scaduto, e dichiaralo.
4. Mostra il problema nella tua app. Un banner per i clienti scaduti con il link di gestione dell’abbonamento raggiunge chi non apre mai le email di sollecito.
5. Non scrivere due volte. Se Paddle o Retain inviano email di recupero, i tuoi messaggi dovrebbero essere in-app, o chiaramente diversi (per esempio dal titolare dell’account, per i grandi account B2B).
6. Sollecita tu le fatture manuali. Retain non agisce sugli abbonamenti incassati manualmente. Costruisci una sequenza di promemoria per questi.
7. Registra ogni fallimento. Salva ogni transaction.payment_failed con abbonamento, importo ed esito. Dopo qualche mese saprai quali clienti si recuperano con un nuovo tentativo e quali solo con una nuova carta.

Cosa puoi aggiungere sopra

Paddle copre bene il nucleo: nuovi tentativi, una pagina di aggiornamento ospitata, email e un modello di stati. Ciò che resta è soprattutto contesto.

• Sapere quali clienti sono a rischio. Un fallimento su un account attivo e di lunga data è diverso da un fallimento su un account in cui nessuno accede da due mesi.
• Collegare i fallimenti a ciò che sai del cliente. Piano, utilizzo, storico del supporto e tipo di metodo di pagamento cambiano tutti ciò che dovrebbe dire un buon messaggio di recupero.
• Misurare. Conta recuperati e persi per mese e per causa. Vedi churn involontario per le definizioni e modelli di email di sollecito se scrivi tu i testi in-app.

Farlo con NoChurn

Per Paddle, incasso dei pagamenti, nuovi tentativi ed email di Paddle restano a Paddle come merchant of record. NoChurn legge abbonamenti e transazioni Paddle, assegna a ogni cliente un churn score da 0 a 100 usando i dati personalizzati inviati via API, e aggiunge un flusso di disdetta ed email di win-back a 30, 60 e 90 giorni. Dove le impostazioni di Paddle lasciano spazio, può inviare messaggi di recupero scritti dall’IA che controlli prima dell’invio. Vedi NoChurn + Paddle.