Skip to main content
SubscriptionFlow Docs
Billing

Automate Payment Retries & Dunning

Updated Dunning managementDunningpayment retry

This guide shows you how to set up automated payment retries and dunning emails that encourage customers to pay their invoices.

  1. Click the ⚙️ icon at the top right to open Settings. Under Billing, click Payment Dunning.

Payment Dunning in Settings

  1. The Payment Retry page shows your Manual Retry schedule (rule-based dunning) and the AI Smart Retry option. Under Manual Retry, click Settings. Use History and Analytics to see past retries and recovery results.

Payment Retry overview

  1. Under Payment retry notification for failed auto payment attempts, set how many days after the failed payment the first retry happens (Initial Payment Retry) and choose the Email Template that tells the customer about it. Set when the next retry happens under 2nd Payment Retry, and how many days after the last retry the subscription-suspended email is sent. Click Add Payment Retry to add more attempts.

Payment retry schedule

  1. Under End of Payment Retry Cancellation Process, choose what happens to the Subscription if the payment isn't recovered (Pause The Subscription, Cancel The Subscription or Leave the Subscription Active), and what happens to the unpaid Invoice:

    • Void the Invoice (reverse all charges): the invoice is marked Void and a credit note is created for the full amount. Any partial payment is released to the customer's account as unapplied credit, so the account statement stays balanced. This option used to be called "Reverse the Invoice".
    • Leave the Invoice Over Due: the invoice stays overdue for manual follow-up.
    • Write-Off: the invoice is written off as bad debt.

    The same choice exists separately for automatic payments and for manual payments (under End of Email Notification Cancellation Process). Settings saved before this release keep their current option.

End of payment retry actions

  1. Turn on Email notification for manual overdue payments to send dunning emails for overdue invoices that aren't charged automatically. Choose the email template for the initial notification, click Add Notification for more reminders, and choose what happens to the subscription and invoice under End of Email Notification Cancellation Process.

Email notifications for manual overdue payments

  1. Under Email Addresses Configuration, add any CC or BCC email addresses. Then click Save Changes at the top right.

Email addresses configuration

  1. When you save, choose whether the new settings apply to invoices already in payment retry (Yes) or only to new ones (No). Check Override existing attached payment retry invoices? to move invoices already on a retry schedule to the new configuration. Click Submit. Every save creates a new settings version.

Payment Retry Action Confirmation

Stop retries for cancelled subscriptions

Without this setting, an invoice that failed before a customer cancelled keeps being retried and can be charged after the cancellation. Turn on Cancelled Subscriptions in Payment Retry Settings and click Save Changes. It's off by default.

Cancelled Subscriptions

What automatic retries do for each kind of invoice:

Invoice bills What automatic retries do Example
Only cancelled subscriptions Stop. A note is added to the invoice timeline Cancelled monthly plan, $30 due: no further charge
Only one-off items Continue as normal Setup fee $50: retried as usual
A cancelled subscription plus active subscriptions or one-off items Charge only the active part; stop once it's paid $100 invoice: $60 cancelled plan + $40 active plan: retries charge $40
A cancelled subscription whose lines were removed from the invoice Continue as normal for what is left Cancelled lines deleted, $40 left: retried as usual

The cancelled part (the subtotal plus tax of the cancelled subscription's lines) stays on the invoice as outstanding, so you decide how to close it: credit it, write it off, or collect it manually. The setting doesn't stop overdue reminder emails for manual payments, never changes the invoice status, and doesn't trigger any end-of-retry action. With the setting off, retries charge the whole invoice as before.

Card expiry reminders

Warning customers before their card expires prevents many failed payments. On the Payment Retry page, click Show Advanced Settings and find the Card Expiry Reminders card. Active lists each reminder (for example "5 days before expiry"); Not set up means no customer is warned yet.

Card Expiry Reminders

To set up a reminder:

  1. On the card, click Manage in Email Notifications (or open Settings > Email Notifications).
  2. Add a scheduler for the event Payment method expiry.
  3. Choose how many days before expiry to send it and pick the email template.
  4. Make sure both the scheduler and its email notification are switched on.

The reminder goes to customers whose active card's expiry date matches the chosen day.

Charging when a customer updates their card

When a customer adds or updates a card, SubscriptionFlow collects every invoice that is in payment retry, not only the newest open invoice. This works when the customer has auto-charge on and the auto charge open invoices preference is enabled. One payment covers the customer's latest open invoice and every older invoice still in payment retry (retrying or paused).

Older open invoices that aren't in payment retry, invoices in a different currency from the latest invoice, and invoices with a pending payment are not charged. Each charge is logged on the payment's timeline as "Auto Charge on Payment Method Activation".

See which invoices each settings version handled

  1. On the Payment Retry page, click History. Setting History lists every saved version of your retry configuration, separately for Auto Payments, Manual Payments and Reporting.

Setting History

  1. On any version, click Invoices. The number beside it is how many invoices that version handled. The window shows totals (invoices, retrying, paused, stopped, completed, recovered and still outstanding). Filter with All, Retrying, Paused, Stopped, Completed and Recovered, or search by invoice number or customer. Click Open in analytics to see that version's recovery results. The list shows 25 invoices at a time, newest first.

Invoices on a settings version

Recovery performance

Recovery performance shows how much revenue payment retries win back, for every retry method. It's read-only: opening it never changes a retry. On the Payment Retry page, click Analytics, then Recovery performance.

Recovery performance

Use the filters to choose the period invoices entered payment retry (Last 7 days, Last 30 days, Last 90 days, All time, or a From–To range), the Payment type (automatic or manual), and the Settings version. Compare with shows the selection side by side with the previous period of the same length or an older settings version; green arrows mark improvements and red arrows declines.

The tiles show:

Tile Meaning
Recovery rate Share of those invoices that are now paid
Revenue recovered Amount received on invoices paid after a failure
Still in payment retry Invoices still being retried or paused, and what they owe
Ended unpaid Invoices whose retries ended without payment, and the amount not collected
Avg. time to recover Days from entering payment retry to being paid

Below them, breakdowns show monthly recovery, recovery by payment type, by retry type (Smart Retry, your retry rules, overdue reminders), by gateway, when invoices were recovered (before the first retry step or after step 1, 2 and so on), and recovery by first decline reason with a suggested next step. Retry approval rate shows how often retry charges are approved, by retry type, gateway and weekday, with the most common decline codes.

Recovery breakdowns

Note: Analytics tiles add amounts from different currencies together and show them with a $ sign. Use the totals as a guide if you bill in several currencies.

Was this article helpful?2 out of 2 found this helpful
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.