This guide shows you how to set up automated payment retries and dunning emails that encourage customers to pay their invoices.
- Click the ⚙️ icon at the top right to open Settings. Under Billing, click Payment Dunning.
- 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.
- 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.
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.
- 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.
- Under Email Addresses Configuration, add any CC or BCC email addresses. Then click Save Changes at the top right.
- 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.
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.
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.
To set up a reminder:
- On the card, click Manage in Email Notifications (or open Settings > Email Notifications).
- Add a scheduler for the event Payment method expiry.
- Choose how many days before expiry to send it and pick the email template.
- 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
- 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.
- 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.
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.
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.
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.
Comments
0 comments
Please sign in to leave a comment.