Dunning
For online payments, Dunning retries failed payment attempts and sends payment reminders. For offline payments, Dunning sends payment reminders during the dunning period. Online payment failures are common and can happen for reasons outside your control, including insufficient funds, expired cards, and connectivity issues.
With Chargebee's Dunning feature, you can send email reminders to your customers asking them to update payment details and schedule payment retries at intervals to ensure revenue can be recovered. After the final payment retry attempt, you can configure what should be the status of the subscription. Chargebee's Dunning applies to:
- Online payments
- Offline payments
- Direct debit payments
- Real-time payments, such as PIX and UPI
- One-time payments
Dunning settings are under Revenue Recovery in Settings > Configure Chargebee. Online Dunning covers auto-collected invoices. Offline Dunning covers invoices that customers pay manually.
While you do your best to handle retries for the best payment recovery, not all failed payments get recovered in the same pattern. Or more importantly, your account with the payment gateways could be blacklisted for reasons such as:
- Multiple retries causing a higher decline ratio
- Non-compliance with card association rules
Chargebee's Smart retry logic retries payments at dynamic intervals based on the type of gateway transaction errors, and it acts on the hard or soft declines accordingly.
Prerequisites
In Chargebee, you can configure dunning email notifications. These emails will be sent to your customers informing them about the payment failure and reminding them to make the payment or update the payment method.
- Enable Email Notifications v2 for your Chargebee site. This will allow you to send multiple email reminders to your customer, irrespective of the number of dunning retries configured.
- Once Email Notifications v2 is enabled, go to Settings > Configure Chargebee > Online Dunning or Offline Dunning, and enable dunning for your Chargebee site.
Smart Retry
Smart retry is an intelligent, built-in dunning logic that initiates payment retries based on the type of gateway transaction errors. Chargebee classifies gateway transaction error codes into hard and soft declines.
- Hard declines are errors that need your customers' or your intervention
- Soft declines are the ones that result from a temporary issue, such as a connectivity issue, and can be retried for a successful recovery at a later time
Hard declines will not be retried until an update in payment method happens and for soft declines, based on the error category and the chances of recovery, Chargebee will suitably decide an opportune time to retry. This not only helps recover your revenue promptly but it does it in the best and safest possible way.
Dunning for Online Payments
Online dunning applies when Auto Collection is turned on for a subscription and the first attempt to collect the payment fails. Chargebee retries payment collection and emails the customer about the failed payment.
Online dunning applies only after Chargebee attempts to collect payment using a payment method on file and that attempt fails. If there is no payment method on file for the customer or subscription, Chargebee does not make that initial online collection attempt, so configured online dunning retries and failure-related email reminders do not start for that invoice. With Auto collection on at activation or renewal, Chargebee may cancel the subscription with a no-card cancellation reason instead—for example when a trial or future subscription becomes active without a card on file.
To send reminders when no online payment method is present, turn Auto collection off for the subscription, enable Dunning for Offline Payments, and for trial or future subscriptions that become active, turn on Apply dunning setting whenever 'Future' and 'Trial' subscriptions become active under offline dunning settings so reminders apply to the activation invoice.
Go to Settings > Configure Chargebee > Online Dunning. The page includes:
- Payment Terms
- Retry/Dunning for cards, e-wallet payments
- Dunning for Direct Debit payments
- Dunning for Real Time payments
- Notifications
Dunning for Cards, e-wallet payments
These settings apply to customers who pay with cards, PayPal, and e-wallets such as Amazon Pay and Apple Pay.
Go to Settings > Configure Chargebee > Online Dunning > Retry/Dunning for cards, e-wallet payments.
-
Default Retry/Dunning: Turn this on to retry failed card and e-wallet payments and apply the final action when recovery does not succeed. If this option is off, Chargebee does not retry those payment methods when the first attempt fails, and the final action runs.
-
Retry/Dunning period: This is the number of days failed payments are retried. The count starts on the invoice due date. When the period ends, the final action applies to the subscription and the invoice. Chargebee retries payment collection during this period. You can configure email notifications to be sent during the period.
-
Retry mode: This decides how Chargebee retries the payment. Select Smart or Custom.
Smart [up to 12 retries]: Chargebee determines the retry frequency from transaction patterns and the type of gateway transaction error. See Smart Retry.
Based on the type of gateway transaction errors, Chargebee will retry up to 12 times to collect the payment.
To increase the likelihood of payment retries on specific dates, contact support. While exact dates cannot be guaranteed, the smart collection logic can be adjusted to attempt retries on your preferred date if your date falls one day before or after the scheduled retry date.
Smart Retry is available only on specific plans. Visit Plans and Pricing for more.
Custom: Enter a Retry schedule as a list of days, counted from the invoice due date. You can set up to 5 retries.
Say the retry/dunning period is 8 days and the retry schedule is 1, 4, 8. The retries are scheduled 1 day, 4 days, and 8 days after the invoice due date.
If the invoice due date is January 1:
- Payment retry #1: January 2, 1 day after the invoice due date
- Payment retry #2: January 5, 4 days after the invoice due date
- Payment retry #3: January 9, 8 days after the invoice due date
-
When dunning period ends, what happens to subscriptions?: If the invoice is still unpaid when the Dunning Period ends, you can define the final action taken on the subscription. You can choose to let the subscription remain active or cancel the subscription at once.
-
When dunning period ends, what happens to invoices?: If the invoice remains unpaid at the end of the dunning period, this option lets you choose how the invoice should be handled. You can:
- Mark the invoice as not paid,
- Void Invoice
- Write-off the invoice
- Reverse the invoice, where the invoice is marked as Paid and an adjustment Credit Note will be created with reason code Subscription_Cancellation.
-
'Future' and 'Trial' subscriptions: When this option is on and payment fails on the day a subscription moves to Active from trial or future, the invoice goes through dunning. The same retries and final action apply.
-
One-time invoices: Turn this on to retry failed one-time charges, such as overages. The final action in When dunning period ends, what happens to invoices? still runs. The subscription is not affected.
-
Dunning for advance invoices: Enabling this option starts dunning for advance invoices.
-
When the terms in the advance invoice are underway, then the final action mentioned in 'When dunning period ends, what happens to invoice/subscription?' is carried out.
-
However, if the terms in the advance invoice haven't begun as yet, the subscription does not get canceled (even if set to cancel in the dunning process). Instead, a cancellation is scheduled for the end of the current term and the full amount gets refunded as a credit note. If the payment has not been collected as yet, an adjustment credit note is created. If the payment has been partially collected, the amount that has been collected is refunded as a refundable credit note, while the remainder is refunded as an adjustment credit note.
-
Dunning for Direct Debit Payments
This setting is for your customers who use direct debit payments such as SEPA (via GoCardless, or Adyen), ACH (via Stripe) or Authorize.Net) to make payments.
- You can select the desired number of retries between 1 and 5 to collect payments in this case.
- It usually takes 5-7 business days for the payment service provider (Stripe, GoCardless) to confirm the payment status to Chargebee.
- When the payment service provider confirms that the payment failed, Chargebee will initiate the next automatic retry to collect payment.
When the status of the transaction is in_progress, Chargebee will not retry to collect the payment or send email notifications.
If the gateway rejects an ACH payment immediately, the invoice can follow General Online Dunning instead of Dunning for Direct Debit Payments. Chargebee's retry frequency applies only while the invoice is in direct debit dunning. See Why did my ACH retries exceed the Direct Debit Dunning limit?.
To set up dunning for direct debit payments, go to Settings > Configure Chargebee > Online Dunning > Dunning for Direct Debit payments.
-
Activate Dunning: Enables dunning for direct debit payments. If this option is disabled, Chargebee will not retry to collect payment when the initial attempt fails, and the final action will be executed.
-
Dunning period: Dunning period is the time period (in days) during which an invoice will stay in dunning before the final action is carried out on the subscription and invoice. Chargebee will retry to collect payments during the dunning period. You can configure email notifications to be sent out to the customer within the dunning period. Final action will be executed at the end of the dunning period.
-
Chargebee's retry frequency: This indicates the number of retries that you want for each failed payment. You can select between 1 to 5 retries. While Chargebee suggests a retry frequency of only 2 attempts, you can check with your payment gateway if you'd like to set a higher limit.
-
When dunning period ends, what happens to subscriptions?: This is the final action taken on the subscription if the invoice is still unpaid when the dunning period ends. This applies to recurring invoices only. You can keep the subscription active or cancel it.
-
When dunning period ends, what happens to invoices?: If the invoice remains unpaid at the end of the dunning period, this option lets you choose how the invoice should be handled. You can:
- Mark the invoice as not paid,
- Void Invoice
- Write-off the invoice
- Reverse the invoice, where the invoice is marked as Paid and an adjustment Credit Note will be created with reason code Subscription_Cancellation.
-
Dunning for 'Future' and 'Trial' subscriptions: Turn this on to run dunning when payment collection fails while a future or trial subscription is activated.
-
Dunning for one-time invoices: Turn this on to run dunning when payment collection fails for a one-time invoice. The final action still runs. The subscription is not interrupted.
-
Dunning for advance invoices: Turn this on to run dunning when payment collection fails on advance invoice generation.
Dunning for Real Time payments
Real-time payment methods, such as PIX and UPI, have their own dunning settings.
Go to Settings > Configure Chargebee > Online Dunning > Dunning for Real Time payments.
For PIX, turn on Dunning to retry failed PIX payments and send email reminders. PIX allows up to 3 retries within 7 days, with one retry per day. Chargebee schedules those retries across this window before the final action. Set When dunning period ends, what happens to subscriptions? and When dunning period ends, what happens to invoices? for that PIX configuration.
The same page covers UPI. See UPI via Stripe and Pix via Adyen for how those methods use this configuration.
Dunning for Offline Payments
Chargebee allows you to collect payments offline via cash, checks, bank transfers, etc. Dunning for offline payments allows you to send email reminders to the customer.
If offline dunning is enabled for a customer and subsequently the Auto Collection option is turned ON for them, Chargebee will stop dunning. To continue using dunning after the Auto Collection status is modified, contact support.
Go to Settings > Configure Chargebee > Offline Dunning. Offline Dunning includes Payment Terms, Dunning for offline payments, and Notifications.
Open Dunning for offline payments to set the dunning period and the final action.
-
Dunning Period: Dunning for offline payments is initiated the day the invoice is generated. During the dunning period, Chargebee will send email notifications configured for offline dunning. At the end of the dunning period, if the invoice is still not paid, final action will be executed. If offline dunning is disabled, Chargebee will not send email notification and the invoice will continue to remain in the payment due state.
-
When dunning period ends, what happens to subscriptions?: If the invoice is still unpaid at the end of the dunning period, you can choose to either cancel the subscription or retain it as active.
-
When dunning period ends, what happens to invoices?: If the invoice remains unpaid at the end of the dunning period, this option lets you choose how the invoice should be handled. You can:
- Mark the invoice as not paid,
- Void Invoice
- Write-off the invoice
- Reverse the invoice, where the invoice is marked as Paid and an adjustment Credit Note will be created with reason code Subscription_Cancellation.
Dunning for 3DS Payments
If your business is based out of Europe or has a significant customer base in the EEA, it is recommended that you authenticate payments via 3D Secure. This is to ensure that you are SCA compliant and in line with the PSD2 regulation.
To be compliant, complete Chargebee's SCA checklist. On completion, you can also recover failed 3DS payments with ease.
3DS failures are hard declines and need customer intervention. Therefore, even if you have configured Custom Retry or Smart Retry in Chargebee, we will retry 3DS failures only the day before the dunning period ends, if no action has been taken by the customer throughout the dunning period.
Invoices in Dunning
When Auto-collection is turned ON for a subscription and the payment attempt fails, Chargebee initiates the dunning process. In the Invoices index page, you can click individual invoices to view retry-related information for that invoice.
You could find the Retry Attempts log with details such as the number of retries made, when the last attempt was, the status of the attempt and the reason for failure. Further, you can click the Details option present against each retry attempt to know more about it.
You can also click the Collect Now button to initiate a payment attempt, which will be listed in the Payments and Credits log. Meanwhile, if you use Collect Now with Smart Dunning enabled, it will be considered a dunning attempt and relevant information will be included in the Retry Attempts log.
With Smart Dunning enabled, using the Collect Now action to manually initiate a payment retry also counts as a retry. The same will be logged in the Retry Attempts details and the number of retries left will be adjusted accordingly. Although, retries left will not change in the case of using Collect Now with Custom Dunning enabled.
Manage Dunning
Chargebee will repeatedly attempt to collect payment from the customer based on your dunning configuration. However, if you would like to make an exception for your customer, or you were informed that the payment will be made on a specific date, you can Stop or Pause dunning for the invoice in Chargebee.
Pause Dunning
If you pause dunning till a specific date, Chargebee will try and collect payment on the expected payment date.
There are two scenarios to consider when setting an expected payment date:
-
Expected payment date falls within the dunning period: Chargebee will put retry attempts and emails on hold until the expected payment date. On the expected payment date, Chargebee will attempt to collect the payment. If the payment doesn't go through, Chargebee will continue dunning with the remaining retries and email notifications.
-
Expected payment date falls after the dunning period: Chargebee will put dunning retries and email notifications on hold until the expected payment date. On the expected payment date Chargebee will attempt to collect the payment for one last time. If the payment doesn't go through, Chargebee will execute the final action set for the subscription (cancel or retain as active).
Using Chargebee API
You can also pause dunning using this API endpoint for Payment Due invoices that have been enabled for Auto Collection.
Pause Dunning will not extend the dunning period.
Resume Dunning
You can resume dunning for a dunning paused invoice at any point during the pause period. Chargebee will resume the dunning retries that remain after the pause period and not attempt retries that have elapsed during the pause period.
Using Chargebee API
You can also resume dunning using this API endpoint for Payment Due invoices that have been previously paused.
Stop Dunning
If you choose to stop dunning, Chargebee will neither retry to collect payments nor send dunning email notifications to your customers. Once stopped, you cannot restart dunning for the invoice again. The invoice will be marked as Not Paid. However, the subscription will remain uninterrupted.
When you stop dunning forever, you can capture an Expected Payment Date and this information will be saved for further reference.
Using Chargebee API
You can also stop dunning using this API endpoint.
Dunning Email Notifications
You can configure emails to be sent out to your customers informing them about the payment failure as well as reminding them about the unpaid invoices and any necessary action to be taken at their end, if any.
The emails can be sent irrespective of the dunning attempts, which means you can send multiple emails to your customer within the dunning period.
Chargebee's Dunning v2 works exclusively with Email Notifications v2.
You can open dunning emails from either of these places:
- Settings > Configure Chargebee > Online Dunning > Notifications, or Offline Dunning > Notifications
- Settings > Configure Chargebee > Email Notifications > Revenue Recovery > Dunning for online payments or Dunning for offline payments
On Online Dunning > Notifications, Dunning Reminders notifies customers before the due date, when a payment fails during dunning, and after dunning is exhausted. Select Configure to edit those emails. The same page also includes Invoice Receipt emails for online invoices.
On Offline Dunning > Notifications, configure Invoice Receipt, Posted Invoice Notification, and Dunning Reminders. Offline Dunning Reminders notify customers before, on, and after the invoice due date.
On the Configure Emails page, the Revenue Recovery category lists Dunning for online payments, Dunning for offline payments, Payment failures, and Chargeback Management.
You can enable each email, edit the content, and choose when it is sent.
Chargebee will continue to send dunning reminder emails to your customers until the invoice is paid or until the dunning period expires.
Email reminders for Direct Debit payment retries will follow the same schedule as that of online dunning reminders. However, Chargebee will not send email reminders for Direct debit payment transactions that are in-progress. Scheduled emails will be sent if the transaction fails.