Skip to main content

Dunning & Reminders

Overview

Dunning is the process of automated follow-ups for late, overdue, or declined payments. You can also use this add-on to send reminders and perform other feats of automation.

ChargeOver only duns invoices that are Unpaid or Overdue. Any other invoices will not be dunned.

Enable Dunning

  1. Go to your Settings and select Add-Ons then More Add-Ons from the left side menu
  2. Once you've located the "Dunning and Reminders" option, select Get Started

  1. To enable Dunning and Reminders, you will want to choose Yes from the drop down menu

Once you have enabled those settings, you will be prompted to start from scratch or with our default settings.

Dunning Groups

If you are starting your dunning groups from scratch, you will first need to create a dunning group. You can pick the criteria for the dunning group, which will determine which invoices will be following that specific dunning path.

Dunning Group Name

Make sure you name your dunning group that is easily understood to you and your team. That way, when it shows up on an invoice that has been dunned, you can easily find your way back to which dunning path the invoice is following.

Setting Up Criteria

When you set up criteria, you will choose an object and field first, before selecting a comparison. For any objects that are not an Invoice, the comparison action will be applied on the invoice's related object, like a subscription or quote.

For example, if you choose to filter by a subscription field, the invoice will only be included if the subscription that generated it matches the criteria.

Supported objects include:

  • Customers
  • Subscriptions
  • Invoices
  • Invoice Schedules

Each object will have a varying list of fields that you can choose from. Once you have decided which object and field you are going to filter on, you need to choose a comparison. The available comparisons will depend on which object or field you select.

Supported comparisons:

  • Is
  • Is Not
  • In List
  • Not In List
  • Does Exist
  • Does Not Exist

After choosing a comparison, you must enter or select the value for comparison. You can add up to three criteria for each dunning group.

info

It is important to note that any changes made to dunning groups will take affect on the next scheduled nightly event process.

Disable or Delete Dunning Group

You can disable or delete dunning groups by clicking on the dunning group options button. It is the three horizontal dots at the top of every dunning group.

Disabled dunning groups will never be used as a part of ChargeOver's dunning process until you enable them again, but they still appear in the Dunning and Reminders page.

Deleted dunning groups will never be used as a part of ChargeOver's dunning process and they will not appear on the Dunning and Reminders page.

Dunning Rules

Once you have defined the criteria for the dunning group, you can set up some dunning rules. Dunning rules consist of a timing component and an action component.

Timing

When choosing the timing, it's important to remember that you are selecting a number of days based around a specific event in your invoicing timeline.

Every time you select a number of days, it will be in respect to that selected timeline.

An example would be if you decided you wanted an email sent to a customer after their credit card fails for the second time.

If you choose to select dunning to be activated one day before an event, then the next rule should automatically change to after.

Invoice milestones include:

  • After invoice date
  • Before invoice due
  • After invoice due
  • After scheduled payment date
  • After scheduled payment due

Actions

Every dunning rule contains at least one action. These actions are what make events happen in ChargeOver.

Supported actions include:

  • Attempting a payment
  • Sending an email
  • Setting a custom field
  • Canceling a subscription
  • Suspending a subscription
info

It is important to remember that any changes made to dunning rules will take affect on the next scheduled nightly event process.

Dunning Generated Payments

Whenever a payment is the result of the dunning and reminders process, we will show a message on the transaction details page that will indicate which rule was responsible for the payment.

Examples

Typical Use Case

Below is an example showing how you could set up your dunning groups to capture all of your credit card and ACH payments.

This example shows that when an invoice is generated from a subscription, with the payment method set as a credit card, it falls within the first dunning group.

Two days and seven days after the invoice date, ChargeOver will attempt a payment on the subscriptions payment method for the full balance due. Ten days after the invoice date, ChargeOver will then cancel the subscription automatically.

If the invoice instead came from a subscription with the payment method set as ACH, it would fall into the second dunning group.

Ten days after the invoice date, ChargeOver will attempt a payment on the subscription payment method for the full balance due. Twenty days after the invoice date, ChargeOver will cancel the subscription automatically.

Keep in Mind

As a reminder, invoices that are unpaid or overdue will follow the arrows in the image based on how the criteria for the group is defined. During our nightly processes, ChargeOver looks for invoices that meet the criteria for each of the dunning groups, from left to right.

If we have determined that the invoice meets a dunning group criteria, we check to see if we need to take action based on the timing of the dunning rules. If not, we move on to check the next dunning group and rules, otherwise, we will take the action that was configured.

Once we dun an invoice, that invoice will continue to follow the dunning rules in the group until it is paid off or until it reaches the end of the dunning group.

Invoices Can Meet Multiple Criteria

Since we have so many options for criteria, it is possible that you have an invoice that could potentially follow multiple dunning groups.

How This is Determined

  1. Dunning group priority is displayed from left to right
  2. Assuming an invoice meets multiple criteria, the earliest scheduled action will determine which dunning group the invoice follows

As you can see, if an invoice was generated from a subscription with a credit card payment method and the associated customer's Industry custom field is set as Digital Marketing, this invioce could potentially meet the criteria for both dunning groups.

Based on the ordering of the dunning groups and the schedule of the dunning actions, the invoice would end up following the first dunning group.

Notes

Making Changes to Objects

When you make changes to ChargeOver customers, subscriptions, or invoices, it is important to consider how it might affect your automated processes. Changes made to objects related to open or unpaid invoices may affect how those invoices get dunned.

If the object you are updating has a related open or unpaid invoice that has already been dunned, we will display a messaged notifying you that you may be impacting dunning behavior.