Payment Retries addebita nuovamente e automaticamente i pagamenti di rinnovo delle sottoscrizioni non riusciti secondo una pianificazione con ritardi progressivi. Quando un tentativo riesce, la sottoscrizione torna a
active, senza alcuna azione da parte del cliente e senza lavoro di integrazione.Cosa sono i nuovi tentativi di pagamento?
Quando un pagamento di rinnovo di una sottoscrizione non riesce, la sottoscrizione passa aon_hold, oppure a past_due se imposti un periodo di tolleranza. Con Payment Retries attivo, Dodo Payments addebita nuovamente il metodo di pagamento salvato del cliente secondo una pianificazione, fino a quando un addebito non va a buon fine o la finestra di recupero non si chiude.
I tentativi recuperano i ricavi persi a causa di errori temporanei, come una sospensione temporanea sulla carta, fondi insufficienti che il cliente ricarica in un secondo momento oppure un errore di rete transitorio. Il cliente non riceve email e non deve modificare nulla.
Payment Retries si applica solo ai pagamenti di rinnovo delle sottoscrizioni. Il primo pagamento di una sottoscrizione (configurazione del mandato), i pagamenti una tantum, gli addebiti per la modifica del piano e gli addebiti on-demand non vengono ritentati.
Come funzionano i nuovi tentativi di pagamento
1
Renewal fails
Un pagamento di rinnovo di una sottoscrizione non riesce e la sottoscrizione passa a
on_hold, oppure a past_due durante un periodo di tolleranza.2
Retryability check
Dodo Payments controlla il codice di errore dell’errore. I rifiuti temporanei, come fondi insufficienti, un rifiuto generico oppure un errore di elaborazione o di rete, possono essere ritentati. I rifiuti definitivi interrompono la catena di tentativi, perché un altro tentativo non cambierebbe l’esito. Un errore senza codice di errore viene considerato un rifiuto definitivo.
3
Scheduled retry
Se il rifiuto può essere ritentato e il tentativo successivo rientra nella finestra di recupero, Dodo Payments lo pianifica. Ogni tentativo è un addebito off-session sul metodo di pagamento salvato del cliente e ogni ritardo viene calcolato a partire dall’errore precedente.
4
Recovery
Al primo tentativo riuscito, la sottoscrizione torna a
active e la data di fatturazione successiva viene spostata a un periodo di fatturazione dopo il tentativo riuscito. Se la finestra si chiude prima che un tentativo abbia successo, i tentativi si interrompono e la sottoscrizione mantiene il proprio stato, ad esempio on_hold.Configurazione dei nuovi tentativi di pagamento
Attiva e configura Payment Retries in Impostazioni → Recupero nella dashboard.
Payment Retries settings under Settings → Recovery
La finestra di recupero inizia quando viene creata la fattura per il rinnovo non riuscito. Dodo Payments pianifica un tentativo solo se la somma di tutti i ritardi fino a quel tentativo rientra nella finestra e solo mentre la finestra è ancora aperta.
Pianificazione dei tentativi
I tentativi applicano ritardi progressivamente maggiori. Dodo Payments effettua fino a 8 tentativi, purché ciascuno rientri nella finestra di recupero:Transizioni dello stato della sottoscrizione
I tentativi spostano la sottoscrizione tra questi stati:Quando una sottoscrizione viene annullata, la relativa catena di tentativi termina e non vengono effettuati altri tentativi. Ogni altro stato (
on_hold, past_due, expired, pending, failed) continua a essere ritentato, perché la fattura di rinnovo aperta rappresenta un debito per un periodo già utilizzato dal cliente. I tentativi si interrompono anche quando la fattura viene pagata in un altro modo, ad esempio dopo che il cliente aggiorna il proprio metodo di pagamento, oppure quando aggiungi il cliente alla tua blocklist.Subscription Webhook Payloads
Visualizza gli schemi completi del payload webhook per gli eventi del ciclo di vita della sottoscrizione.
Errori ritentabili e non ritentabili
Il codice di errore dell’errore più recente determina se la catena continua:Ritentare un rifiuto definitivo non cambierebbe l’esito, quindi la catena termina non appena si verifica un rifiuto definitivo. Abbina Payment Retries a Subscription Dunning per chiedere al cliente un nuovo metodo di pagamento in questi casi. Per il tipo di ogni codice, consulta Transaction Failures.
Ritentare on-demand
Non devi aspettare il tentativo pianificato successivo. Quando una sottoscrizione èon_hold, puoi inviare un tentativo dalla pagina dei dettagli del pagamento non riuscito nella dashboard oppure con POST /payments/{payment_id}/retry. I tentativi manuali vengono eseguiti indipendentemente dalla pianificazione: non consumano né spostano un tentativo automatico e funzionano anche quando Payment Retries è disattivato. Consulta Manual Payment Retry.
Payment Retries e Dunning
Payment Retries e Subscription Dunning recuperano tipi diversi di errori:
Attiva entrambe le funzioni per ottenere la copertura più ampia: i tentativi automatici intercettano gli errori transitori e il dunning recupera i clienti il cui metodo di pagamento deve essere sostituito.
Correlati
Manual Payment Retry
Invia subito un tentativo invece di aspettare il tentativo pianificato successivo.
Subscription Dunning
Sequenze di email che chiedono ai clienti di aggiornare il proprio metodo di pagamento.
Abandoned Cart Recovery
Recupera i checkout abbandonati o non riusciti con email di recupero.
Subscriptions
Gli stati della sottoscrizione tra cui si spostano i flussi di recupero.
Subscription Webhooks
Reagisci agli eventi
subscription.on_hold e subscription.active.