Table of Contents

Delinquency Billing Best Practices

Mitchell Ivany Updated by Mitchell Ivany

Read Time: 11 mins

Delinquency in Sonar encourages subscribers to pay a past-due balance by letting you build an automated response to non-payment. This article explains when and why delinquency and status changes happen, then walks through two common approaches: slowing a subscriber's connection while keeping the account active, and switching the account into a new status to stop future charges.

Moving a long-term delinquent account from active to inactive is meant to stop future charges from being added. It is not meant to control service access. Limit service access when the account becomes delinquent, not when the account status changes.

For setup steps referenced throughout this article, see Billing Defaults and Account Statuses: Overview & Example Use Cases.

Permissions

Before getting started with the feature, your user roles will need to be adjusted to account for the permissions required to use the delinquency billing feature.

If you're a Super Admin, you already have full access and no changes are required. To learn more, see the User Role Creation & Best Practices article.
Entity
Permission
Reason
Billing Default
View billing defaults
Review the Billing Default that controls delinquency timing and the status switch.
Billing Default
Update a set of billing defaults
Enable the status switch and set Days of Delinquency for Status Switch, Delinquency Account Status, and Delinquency Removal Account Status.
Account Status
View account statuses
View existing statuses when selecting the status used during and after delinquency.
Account Status
Create a new account status
Create the Delinquent status the account moves into during delinquency.
Address List
View all address lists
Review existing Address Lists before building one for delinquent subscribers.
Address List
Create an address list
Build the delinquent Address List used to slow or restrict service.
Delinquency Exclusion
View all delinquency exclusions
Review which dates are excluded from delinquency processing.
Delinquency Exclusion
Update a delinquency exclusion
Adjust excluded dates so delinquency runs on the days you intend.

Feature Details

How Delinquency Works in Sonar

An invoice can become delinquent without changing the account status. This means the invoice was not paid by its due date. The account status only changes after the Grace Period has passed.

The Grace Period adds extra time after the invoice due date. You can also adjust it on individual accounts when required.

From the Bill Day, the total time before an account becomes delinquent is:

Due Days + Grace Days

Delinquency happens in two steps:

  1. The invoice becomes due.
  2. After the Grace Days pass, the account becomes delinquent, and the delinquency process begins.

In the example below, the invoice is created on the 1st of each month and becomes due on the 16th. If the subscriber has not paid by the 16th, the invoice is past due, but the account is not delinquent yet. If the invoice is still unpaid on the 21st, after the 5-day grace period, the invoice becomes delinquent and the account moves to a delinquent status.

Due Days and Grace Days are configured in your Billing Default. For setup steps, see Billing Defaults.

Settings That Work Together

Delinquency Billing uses several settings that work together. The main areas you may need to configure are:

Setting
What it does
Account Statuses
Create a status for delinquent subscribers. See Account Statuses: Overview & Example Use Cases.
Address Lists
Disconnect or slow subscribers after a period of non-payment. See Building Address Lists.
Delinquency Checks & Exclusions
Control when delinquency processing runs and which dates to skip. Leave the Year field blank to repeat an exclusion every year.
Grace Periods
Set the extra days subscribers have after the invoice due date before the account becomes delinquent.
Late & Reconnection Fees
Configure fees that apply when an account becomes delinquent or is reconnected.
To skip specific dates such as holidays or weekends, set up exclusions first. For setup steps, see Delinquency Exclusions: Overview.

Giving a Subscriber More Time: Grace Until

If a subscriber needs more time to pay, use Grace Until to choose a later delinquency date. Grace Until prevents the account from becoming delinquent until after the selected date has passed. You can think of it as "Grace Through" that date.

If automatic late fees apply, they can still be added to the invoice even when Grace Until is set.

When Account Status Changes are Processed

Account status changes controlled by billing settings happen at 12:00 AM UTC.

If delinquency checks do not run on a given day, Sonar waits until the next valid check day. For example, if weekend delinquency checks are disabled and an invoice would become delinquent on a Saturday, Sonar marks it delinquent on the following Monday instead. This shift also moves the account status change, because the status switch is counted from the date the invoice is actually marked delinquent.

The Delinquency Process, Step by Step

In Sonar, billing and delinquency follow this process:

  1. Billing runs on the bill day. Sonar checks whether the account is in an active status. If it is, billing runs and an invoice is created based on the account's services and discounts.
  2. The invoice reaches its due date. If no payment is made by the due date, the invoice is now past due.
  3. Grace days are counted. During this time, the invoice is overdue, but the account is not delinquent yet.
  4. Sonar checks for a delinquency exclusion. After the grace days end, Sonar checks for any Delinquency Exclusions, such as a blocked date or a skipped check day.
    1. If an exclusion applies (Yes): Sonar waits until the next valid processing day, then continues.
    2. If none applies (No): the account becomes delinquent.
  5. The account becomes delinquent. The account is marked delinquent at 12:00 AM UTC.
  6. The account is added to the Delinquent Address List. This list drives speed or access control for delinquent subscribers.
  7. The status switch countdown begins. Once the set Days of Delinquency for Status Switch pass, the account moves to a new status, which stops future charges.

Best Practices: Why Use Delinquency

Delinquency in Sonar is meant to encourage subscribers to take action, usually by paying their past-due balance. Delinquency settings help you move beyond reminders and late fees by creating an automated process for handling unpaid accounts.

A helpful way to think about delinquency is: how many days are you willing to let a subscriber remain unpaid before taking action? Once that time has passed, Sonar can trigger the next step, such as changing the account status.

When using Move accounts into another status after being delinquent for a preset period, make sure the status change happens before the next bill due date. This helps prevent subscribers from being billed for another month of service they may no longer be able to use.

The sections below show two ways to use delinquency effectively, including the action taken and the result it is meant to encourage.

Using a Delinquent Status to Slow Down Service

One way to encourage payment is to slow down the subscriber's connection instead of disconnecting it right away. In this setup, the account stays active, but an Address List reduces the subscriber's speed. The goal is to make the connection slow enough that normal use is limited, while still allowing access to helpful sites like the subscriber portal or their bank's website so they can make a payment.

This approach can be useful because:

  1. It encourages payment without fully cutting off service. This can feel less abrupt for the subscriber while still motivating action.
  2. It can prompt the subscriber to contact your team. If they do not realize they are delinquent, the slower connection may lead them to call in, giving your staff a chance to explain the issue and collect payment.
Creating the Address List

To create an Address List for delinquent subscribers:

  1. Go to Settings.
  2. Select Networking.
  3. Click Address Lists.
  4. Click Create Address List.

After the Create Address List window opens, create a basic Address List for delinquent subscribers. The fields in this window control which accounts are included:

Field
Description
Name
Sets the name of the Address List. Use a clear name that describes its purpose, such as Delinquent Slow Speeds.
Account Status
Controls which accounts are included based on their overall account status.
Delinquency
Determines whether the Address List applies based on delinquency status. This is the key field for targeting delinquent subscribers.
Account Groups
Limits the Address List to subscribers in specific account groups.
Account Statuses
Filters the Address List by one or more selected account statuses.
Account Types
Limits the Address List to specific account types, such as Residential or Business.
Data Services
Limits the Address List to subscribers with specific data services.
Usage Based Billing Policies
Adds subscribers to the Address List when they have a selected usage-based billing policy and exceed their usage cap.

This Address List should apply only to delinquent subscribers. Once created, you can use it with an Inline Device policy to reduce speeds for subscribers who are delinquent.

For full Address List setup steps, see Building Address Lists. To reduce speeds with an Inline Device, see MikroTik: Controlling Speeds.

Using Status Switching to Deactivate an Account

This approach uses Billing Defaults to automatically move delinquent subscribers into another status. It is helpful even if delinquency is uncommon, because an automated process reduces manual work as your subscriber base grows.

In this example, Residential subscribers use RADIUS for authentication and service delivery. For the Residential Billing Default:

  1. Enable Move accounts into another status after being delinquent for a preset period.
  2. Set Days of Delinquency for Status Switch to 7 days.
  3. Set the Delinquency Account Status to a clear status, such as Delinquent.

Using 7 days helps account for delinquency check schedules. For example, if delinquency checks do not run on weekends, a 7-day window helps ensure the status change happens on a day when support staff are available.

The status-switch fields live in your Billing Default. For setup steps, see Billing Defaults.

These three fields control the status switch:

Field
What it controls
Days of Delinquency for Status Switch
How long the account stays delinquent before changing statuses.
Delinquency Account Status
The status used while the account is delinquent.
Delinquency Removal Account Status
The status the account moves into after the delinquency period ends.

While Inactive can be used as the status, Delinquent is clearer because it explains why the account status changed.

To create a new Delinquent account status:

  1. Go to Settings.
  2. Expand Accounts.
  3. Select Account Statuses.
  4. Click Create Account Status.
  5. Enter a clear name, such as Delinquent.
  6. Configure the status settings as required for your workflow.
  7. Click Create.

After the status is created, return to the Billing Default and select it as the Delinquency Account Status.

For status setup and example use cases, see Account Statuses: Overview & Example Use Cases.

In this scenario, delinquent accounts move into a status that removes service and prevents future billing for service the subscriber will not receive. This is a stronger step than slowing down the connection, and is usually used as a final escalation when reminders, late fees, and reduced speeds have not led to payment.

Worked Example: Weekend Check Shift

To see how a disabled check day moves both dates:

  1. The invoice was expected to become delinquent on Saturday, August 14, 2021.
  2. Weekend delinquency checks were disabled, so the invoice became delinquent on Monday, August 16, 2021 instead.
  3. Days of Delinquency for Status Switch is set to 10.
  4. The account status changes 10 days from the actual delinquency date, on Thursday, August 26, 2021.

Frequently Asked Questions

If a delinquent account makes a payment on its bill day, will Sonar automatically create an invoice?

It depends on the account's Next Bill Date and billing settings.

  1. If the Next Bill Date is today: If the payment brings the account out of delinquency and back to Active, billing runs normally as long as Daily Billing is enabled. The invoice is not created immediately when the account becomes active; it is created the next time billing runs.
  2. If the Next Bill Date is in the past: If the Bill Day is today but the Next Bill Date is already in the past, Sonar moves the Next Bill Date to the next month. No invoice is created for the current month. For example, if the Next Bill Date was 10/17/2023, the Bill Day is the 17th, and payment is made today, the Next Bill Date moves to 11/17/2023.
  3. If prorated account status changes are enabled: If the payment changes the account back to Active, Sonar may create prorated transactions. These transactions are not invoiced immediately.

Does the time of day matter when the account comes out of delinquency?

Yes. If the Next Bill Date is today but there is less than one hour left in the day, Sonar moves the Next Bill Date to the next month.

Will Sonar automatically create an invoice during the month after an account comes out of delinquency?

Invoices are created automatically on the account's Bill Date when Daily Billing is enabled and the account is Active.

Does this work the same if the account moved from Active to Inactive because of delinquency?

Yes. If a payment moves the account back to an Active status, the account bills on its next valid Bill Date. If the original Bill Date passed while the account was delinquent, Sonar updates the Next Bill Date to the next applicable billing date.

Billing Defaults | Account Statuses: Overview & Example Use Cases | Delinquency Exclusions: Overview | Building Address Lists | MikroTik: Controlling Speeds | Creating Discounts for Services and Packages

How did we do?

Creating Discounts for Services and Packages

Delinquency Exclusions: Overview

Contact