Docs

Log in to read the version of docs relevant to your site, or use the dropdown versions

Unbilled Charges

Introduction

The Unbilled Charges feature separates the creation of subscription-related charges from their invoicing.

There can be multiple charges incurred for a subscription, including:

  • Upgrade or downgrade
  • Switch to a different plan
  • Addon attached in the middle of the subscription term
  • Add a one-time charge or any other additions or changes to the subscription

Example

Subscription created: April 1, 2017 Plan subscribed to: Silver Plan ($50) Subscription updated on April 15, 2017 with the following changes:

  • Addon: Custom Report ($30)
  • One-time charge: Migration support ($79)

You can add the two incurred charges to a list of unbilled charges for the subscription.

When unbilled charges are created in Chargebee, they can be invoiced on demand.

If left unbilled, they are:

Configuration

Chargebee allows you to configure how unbilled charges are handled on your site. Navigate to Settings > Configure Chargebee > Billing LogIQ > Billing & Invoices > Unbilled Charges and ensure that the proper settings are in place.

Note: Unbilled Charges are enabled on the web interface by default. You can disable them on the web interface, but they are still available via the API.

You can choose the site defaults as either invoice immediately or add them to unbilled charges for the following cases:

Users can choose to override these default settings while creating charges on the Chargebee interface. However, if you want to prevent this, click the more options (vertical ellipsis) menu to the right of the setting and disable the Allow overriding via Chargebee interface toggle.

Disabling Unbilled Charges

You can use the Disable button to turn off unbilled charges. This will:

Note: When charges are incurred via Checkout and Self-Serve Portal, they are always invoiced immediately.

Add as Unbilled Charge

Here are the ways you can add a charge to the Unbilled Charges list via the web interface and API:

Via the Web Interface

Provided the configuration allows, you can keep charges as unbilled during the following actions:

Via API

Creating Actual Charges Here are the API calls you can use to add a charge to the list of unbilled charges:

Note: Set the invoice_immediately parameter to false to keep the charge as unbilled.

Estimating Charges Without Creating Them Get an estimate of any unbilled charges using the following API calls:

Viewing Unbilled Charges

You can view all unbilled charges for a particular customer or for a particular subscription.

Subscription Level

All unbilled charges for a subscription are listed on its details page:

The section also shows the date on which the charges will be invoiced (same as the subscription renewal date).

Customer Level

All unbilled charges for a customer (across all subscriptions under it) are listed on its details page.

Note:

If you'd like to view the details of any changes that Chargebee makes to the list of unbilled charges, you can use the List unbilled charges API call. The is_voided parameter is set to true for unbilled charges that have already been invoiced. For such charges, the voided_at parameter is also available.

Invoicing Options

Immediate (on-demand) invoicing of unbilled charges can be done at two levels:

Subscription Level

After navigating to the details page of the subscription, click the Invoice now link at the top of the list of unbilled charges to immediately invoice the charges.

Customer Level

Unbilled charges for a customer can be found on the customer details page. Click the Invoice now link above the list of charges to immediately invoice all such charges. The unbilled charges are invoiced separately for each subscription under the customer.

Note:

If consolidated invoicing is enabled, all the unbilled charges for the customer may be billed together in a single invoice.

Using API for Invoicing

API calls can be used to either invoice unbilled charges or create an estimate for unbilled charges. They work for both customer and subscription levels depending on the parameters passed.

FAQs

1) How are discounts and one-time charges applied to unbilled charges?

One-time charges are not affected by existing coupons.

For example, if a subscription is created on May 1, and a coupon is applied to the subscription on May 2, the coupon will not apply to all charges created after May 2.

If an ad hoc charge or non-recurring addon is added to unbilled charges, the discount(s) present in the subscription will not be applied to the charge immediately. When the unbilled one-time charge or non-recurring addon is invoiced, the discount present in the subscription will be applied.

2) How are discounts applied to one-time charges present as unbilled charges?

Coupons will be immediately applied to recurring charges that are added to the list of unbilled charges.

Example

If a recurring charge of $50 is added to the list of unbilled charges, any coupons that are created after the charge is added will be immediately applied to the charge.

3) How is proration applied to unbilled charges?

If changes to a subscription affect existing charges present in the Unbilled Charges section, Chargebee will revise the unbilled charges so that any invoices raised are accurate and up to date.

Example

A subscription is created with a Silver plan ($50/month) on April 1. It is not invoiced immediately. An unbilled charge is created for $50 in the subscription's details page for the billing period April 1 – May 1. On April 16, the subscription is changed to a Gold plan ($100/month). This change affects the current unbilled charge (of $50 for the Silver plan), so Chargebee will revise it. The list of unbilled items will now contain the following:

  • Revised charge for the Silver plan – $25 (April 1 to April 16)
  • Charge for the Gold plan – $50 (April 16 to May 1)

4) How are taxes applied to unbilled charges?

Tax exclusive: If you are operating with an exclusive price type, tax for unbilled charges will be calculated at the time the invoices are created. Tax inclusive: If you are operating with an inclusive price type, taxes will be calculated when you create the charge and will be applied immediately. In other words, if your prices include tax, all the pending charges that appear in the list of unbilled charges will include tax as well. More info on price types.

Was this article helpful?