Getting Started

Product Catalog

Customers

Subscriptions

Invoices, Credit Notes, and Quotes

Taxes

Payments

Site Configuration

Data Privacy & Security

Data Operations

Reports and Analytics

Integrations

Charges 

Overview 

Your Chargebee product catalog allows you to define plans and addons that represent your products and services. However, often you may need to bill your customers for products or services that are non-recurring.

Charges represent products or services that are charged for, in an ad-hoc manner and either purchased once immediately or scheduled for purchase when certain events happen such as subscription activation, trial start, and so on. A charge can also be applied against a customer record, in which case, it is not associated with any particular subscription.

These can be applied via the Chargebee UI or via API.

Creating a Charge 

To create a new charge in your Chargebee site, follow these steps:

  1. Click Product Catalog > Charges > + Create Charge.
  2. In the Create a New Charge page, if you have enabled and created Product families in your Chargebee site, click the Product Family dropdown and select the Product family to which you want to associate this charge.
  3. Specify an Internal Name for the charge that helps you identify the charge internally. It is the name used to refer to the charge on your Chargebee site.
  4. You can add a Description to include additional details about the charge.
  5. The Charge ID is generated based on the Internal Name that you specify. You can modify this id as required. A charge Id is the unique identifier of the charge and when a subscription is created or updated via the API from your app/website.
  6. Under Customer-Facing Info, you can enable the Display in Self-Serve Portal checkbox to make this charge available in the Self-serve Portal. The Self-serve Portal can be used by your customers to make changes to their subscription.
  7. Click Create.

Defining Price Points for a Charge 

Once you create charges, you can start adding multiple price points for each currency. To define a price point for a charge,

  1. Click Product Catalog > Charges. Select the charge for which you are creating the price points.
  2. In the details page, the Pricing section displays all the currencies that you have configured. Go to the currency that you want to add for this charge, and click Set Price.
  3. In the Create a Price Point page, you can modify the basic attributes of the charge's price point such as:
    • External Name: This will be used on all customer facing resources such as Invoice, Quotes, Checkout, and Self-serve Portal.
    • Internal Name: This helps you identify the price point internally. It is the name used to refer to the charge price point on your Chargebee site.
    • Plan Price Point ID: The Charge Price Point ID is generated based on the Internal Name that you specify. You can modify this id as required. This Id is the unique identifier of the price point and when a subscription is created or updated via the API from your app/website.
  4. In the Pricing section, you can configure the pricing attributes of the price point such as:
    • Pricing Model: Choose your preferred pricing model in which you want to charge your customers.
    • Price: Based on the pricing model that you choose, you can specify the price for the charge's price point.
  5. Under Customer facing info, you can do the following:
    • Add a description to the price point which gets displayed on all customer facing resources such as Invoice, Quotes, Checkout and Self-serve Portal.
    • Additionally specify Invoice notes that will appear in all the invoice pdfs that are generated for this charge's price point.
  6. Accounting Information: The Accounting Information section helps Chargebee sync up with any accounting applications that you integrate with, like Xero and Quickbooks. Each of the accounting fields captures information that helps track product-specific sales/revenue from an accounting perspective.
    • SKU: Store Keeping Unit or SKU is a name used to identify a product/service in inventory management or accounting systems. You can use this as an alternative name for your charge and it will be used as the Product Name in the accounting system.
    • Accounting code: This field captures your Accounting systems' General Ledger Account code/name. When product information is synced to the Accounting system, the product-specific information will be synced with this account as captured here. This is a mandatory field. You cannot proceed with accounting integration if this field is left blank.
    • Accounting category: The Accounting Category captures product specific additional metadata or categorization for reporting purpose in the accounting systems (such as regions you are selling to or branches you are selling from). It should be entered in the format: : . E.g. "Region: Northern"
  7. Taxes: If Taxes have been configured, you can choose to exempt a charge price point from taxes by unchecking This charge price point is subject to taxes. If you are choosing to keep the plan taxable, choose a tax profile for it. This would determine — during invoicing — what taxes are applied to the price of the charge.
  8. Click Create.

You can define multiple price points for each charge, based on the currencies in which you want to offer your charges.

Once you have created your charges and defined price points as required, you can start adding charges to customers or subscriptions in several ways.

Adding a Charge 

The +Add Charge action can be found on the details page of both a Subscription or a Customer.

Adding a Charge to a Customer 

Go to the respective customer details page and do the following:

  1. Click +Add Charge.
  2. Select the Charge that you want to apply to the Customer.
  3. If needed, change the price of the Charge in the Unit Price field.
  4. Select a coupon to apply. (Only one-time coupons that are applicable to the Charges are available here).
  5. Specify the Service period:
    • Choose the time period that the charge is to be accounted for, by specifying the from and to dates/times of the period.
    • The default period is the current date/time and can be set to a period from any date/time in the past and into the future.
    • Chargebee accounts for this service period while running the revenue recognition and deferred revenue reports.
  6. Click Add.
Note

The time component can only be chosen when your site runs on millisecond-based billing mode.

Adding a Charge to a Subscription 

Go to the respective subscription details page and do the following:

  1. Click +Add Charge.
  2. Select the Charge that you want to apply to the Subscription. Any Charge, including those that may have been restricted for the plan chosen, can be applied using this action.
  3. If needed, change the price of the Charge.
  4. Specify the Service period:
    • Choose the time period that the Charge is to be accounted for. Specify the from and to dates/times of the period.
    • The period must start after the subscription start date/time.
    • Chargebee accounts for this service period while running the revenue recognition and deferred revenue reports.
  5. Choose whether to invoice the charge immediately or to add it to unbilled charges of the subscription.
  6. Click Add.
Note

The time component can only be chosen when your site runs on millisecond-based billing mode.

Adding a Charge while Editing a Subscription 

You can also add charges while editing a subscription.

  1. On the subscription details page, click Edit Subscription.
  2. Click +Add Charge and choose the charge that you want to add to the subscription. Any charge that have been restricted for the plan selected, will not be available.
  3. Select the event at which to apply the charge. For some events, you can also choose whether the addon is charged just once or every time the event happens.
  4. Service period:
    • Choose the number of days that the charge is to be accounted for. The period is considered to start on the day/time the addon is charged.
    • Chargebee accounts for this service period while running the revenue recognition and deferred revenue reports.
  5. Click Add.
  6. If needed, change the price of the charge and click Update to save your changes to the subscription.

One-time Charges 

You can collect an ad-hoc payment from a customer or a subscription using the 'Add Charge' option. This option can be quite useful, especially when you come across scenarios where you have to collect payments from customers for goods or services that are not normally included as a part of their subscription model. It can also be used when you want to collect payment for a product or service that is not modeled into your system like a non-recurring addon.

A one-time charge can be applied to a customer or a subscription via the Chargebee UI or via API.

Adding a One-Time Charge 

On the Chargebee UI the Add Charge action on the details page of either a Subscription or a Customer can be used to add a one-time charge.

  • Applying to a Customer

    1. Specify the amount for the charge.
    2. Select a coupon to apply. (Only one-time coupons that are applicable to the invoice amount are available here).
    3. Service period:
      • Choose the time period that the charged service is to be accounted for. Specify the from and to dates/times of the period.
      • The default period is the current date/time and can be set to a period from any date/time in the past and into the future.
      • Chargebee accounts for this service period while running the revenue recognition and deferred revenue reports.

        Note
        The time component can only be chosen when your site runs on millisecond-based billing mode.

    4. Provide a description for the charge.
  • Applying to a Subscription

    1. Specify the amount for the charge.
    2. Service period:
      • Choose the time period that the charged service is to be accounted for. Specify the from and to dates/times of the period.
      • The period must start after the subscription start date/time.
      • Chargebee accounts for this service period while running the revenue recognition and deferred revenue reports.

        Note
        The time component can only be chosen when your site runs on millisecond-based billing mode.

    3. Provide a description for the charge.
    4. Choose to invoice the charge immediately or add it to unbilled charges. An email notification can also be sent when the invoice is generated.
      • Coupons cannot applied to the charge if invoiced immediately.
      • However, when the charge is added to unbilled charges, any invoice-amount coupon on the subscription will also apply to this charge.

If there have been multiple one-time charges against the subscription, the total of all the charges will be shown on the subscription details page:

Note: You cannot view the total one-time charges for a Customer on the UI.

Opt-in feature

Alert while charging a customer having unpaid invoices:

Enabling this feature displays a prompt while a new charge is created for a customer with unpaid invoices.

Click Proceed to charge the customer or Dismiss to cancel the charge creating event.

This applies for charges created during,

The prompt appears irrespective of the charge being invoiced immediately or added to unbilled charges.

To avail this feature, contact [email protected] .

Was this article helpful?
Loading…