Skip to main content

Dunning & Reminders

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 & Reminders" option, select Get Started

  1. To enable Dunning & 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​

The first step if you are starting from scratch is creating a dunning group. We define criteria for these groups to identify which invoices are going to be following the dunning path.

Dunning Group Name​

Make sure you label your dunning group so it's identifiable and it makes sense, 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 traveling down.

Setting Up Criteria​

You must select 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

  • Customer
  • Subscription
  • Invoice
  • Invoice Schedule

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 3 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​

You can disable or delete dunning groups by clicking on the dunning group options button. 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 to show you that it is disabled.

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

  • 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

  • Attempt a payment
  • Send an email
  • Set a custom field
  • Cancel 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​

Here is one way 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.

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.