Skip to main content
Payment Retries debiterar automatiskt misslyckade betalningar för förnyelse av abonnemang igen enligt ett gradvis förlängt schema. När ett nytt försök lyckas återgår abonnemanget till active utan att kunden behöver göra något och utan integrationsarbete.

Vad är nya betalningsförsök?

När en betalning för förnyelse av ett abonnemang misslyckas flyttas abonnemanget till on_hold, eller till past_due om du har angett en respittid. När Payment Retries är aktiverat debiterar Dodo Payments kundens sparade betalningsmetod igen enligt ett schema tills en debitering lyckas eller återställningsfönstret stängs. Nya försök återvinner intäkter som gått förlorade på grund av tillfälliga fel, till exempel en tillfällig reservation på kortet, otillräckliga medel som kunden fyller på senare eller ett tillfälligt nätverksfel. Kunden får inget e-postmeddelande och behöver inte ändra något.
Payment Retries gäller endast betalningar för förnyelse av abonnemang. Den första betalningen för ett abonnemang (upprättande av medgivande), engångsbetalningar, debiteringar vid planändringar och debiteringar på begäran görs inte om.

Så fungerar nya betalningsförsök

1

Renewal fails

En betalning för förnyelse av ett abonnemang misslyckas och abonnemanget flyttas till on_hold, eller till past_due under en respittid.
2

Retryability check

Dodo Payments kontrollerar felkoden för felet. Milda nekanden, som otillräckliga medel, ett generiskt nekande eller ett bearbetnings- eller nätverksfel, kan göras om. Definitiva nekanden avslutar kedjan av nya försök eftersom ett nytt försök inte skulle ändra resultatet. Ett fel utan felkod räknas som ett definitivt nekande.
3

Scheduled retry

Om nekandet kan göras om och nästa försök ryms inom återställningsfönstret schemalägger Dodo Payments det. Varje nytt försök är en off-session-debitering av kundens sparade betalningsmetod, och varje fördröjning räknas från föregående misslyckande.
4

Recovery

Vid det första lyckade nya försöket återgår abonnemanget till active och nästa faktureringsdatum flyttas till en faktureringsperiod efter det lyckade nya försöket. Om fönstret stängs innan något nytt försök lyckas stoppas de nya försöken och abonnemanget behåller sin status, till exempel on_hold.

Konfigurera nya betalningsförsök

Aktivera och konfigurera Payment Retries under Settings → Recovery i din dashboard.
Sidan Recovery Settings med reglaget Enable Payment Retries aktiverat och fältet Recovery window (days) inställt på 13

Payment Retries settings under Settings → Recovery

Sidan har två inställningar: Återställningsfönstret börjar när fakturan för den misslyckade förnyelsen skapas. Dodo Payments schemalägger ett försök endast om summan av alla fördröjningar fram till det försöket ryms inom fönstret och endast medan fönstret fortfarande är öppet.

Schema för nya försök

Fördröjningen mellan nya försök ökar gradvis. Dodo Payments gör upp till 8 försök, så länge varje försök ryms inom ditt återställningsfönster:
Standardfönstret på 13 dagar täcker försök 1 till och med 5, eftersom försök 5 görs ungefär 10,5 dagar efter felet. Om du vill köra de senare försöken med längre intervall måste du öka fönstret: försök 6 kräver minst 16 dagar, försök 7 minst 23 dagar och försök 8 det maximala värdet på 30 dagar.

Statusövergångar för abonnemang

Nya försök flyttar abonnemanget mellan följande statusar:
När ett abonnemang avslutas tar kedjan av nya försök slut och inga fler försök görs. Alla andra statusar (on_hold, past_due, expired, pending, failed) fortsätter att försöka, eftersom den öppna förnyelsefakturan är en skuld för en period som kunden redan har använt. Nya försök stoppas också när fakturan betalas på annat sätt, till exempel efter att kunden uppdaterat sin betalningsmetod eller när du lägger till kunden i din blocklista.
Dessa övergångar genererar standardhändelserna för webhookar för abonnemang, så din behörighetslogik behöver ingen särskild hantering för nya försök:

Subscription Webhook Payloads

Visa de fullständiga schemana för webhook-nyttolaster för händelser i abonnemangets livscykel.

Fel som kan respektive inte kan göras om

Felkoden för det senaste felet avgör om kedjan fortsätter:
Att försöka igen efter ett definitivt nekande ändrar inte resultatet, så kedjan avslutas så snart ett definitivt nekande inträffar. Kombinera Payment Retries med Subscription Dunning för att be kunden om en ny betalningsmetod i sådana fall. Information om typen för varje kod finns i Transaction Failures.

Göra nya försök på begäran

Du behöver inte vänta på nästa schemalagda försök. Medan ett abonnemang har statusen on_hold kan du skicka ett nytt försök från detaljsidan för den misslyckade betalningen i dashboarden eller med POST /payments/{payment_id}/retry. Manuella nya försök körs oberoende av schemat: de förbrukar inte och flyttar inte ett automatiskt försök, och de fungerar även när Payment Retries är avstängt. Se Manual Payment Retry.

Payment Retries jämfört med Dunning

Payment Retries och Subscription Dunning återställer olika typer av fel: Aktivera båda för bredast möjliga täckning: automatiska nya försök fångar upp tillfälliga fel och dunning återvinner kunder vars betalningsmetod behöver ersättas.

Relaterat

Manual Payment Retry

Skicka ett nytt försök direkt i stället för att vänta på nästa schemalagda försök.

Subscription Dunning

E-postsekvenser som ber kunder att uppdatera sin betalningsmetod.

Abandoned Cart Recovery

Återvinn övergivna eller misslyckade kassor med återställningsmejl.

Subscriptions

Abonnemangets statusar som återställningsflöden flyttar mellan.

Subscription Webhooks

Agera på händelserna subscription.on_hold och subscription.active.
Senast ändrad 26 september 2026