Docs
You are viewing:
Product Catalog 1.0
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. Some of these charges may be ad-hoc and not part of your standard product catalog.
Non-recurring addons and one-time charges help you bill your customers in such cases. You can apply these to your customers via the Chargebee user interface or API.
In addition to plans and addons in Chargebee that are billed in a recurring manner, you can also create non-recurring addons. Such addons represent products or services that are charged for on an ad hoc basis and are either purchased once immediately or scheduled for purchase when certain events happen, such as subscription activation or trial start.
A non-recurring addon can also be applied to a customer record, in which case it is not associated with any particular subscription.
Modeling a non-recurring or ad hoc purchase as a non-recurring addon in Chargebee, rather than as a one-time charge, gives you greater insights into which types and how many addons were applied to your subscriptions using reports.
Non-recurring addons can be applied to customers or subscriptions in several ways:
The Add One-Time Addon action can be found on the details page of both a subscription or a customer.
Applying to a Customer:
Note The time component can only be chosen when your site runs on millisecond-based billing mode.
Applying to a Subscription
Note The time component can only be chosen when your site runs on millisecond-based billing mode.
You can also add one-time addons after clicking Edit Subscription on the details page of a subscription.
A couple of API calls for charging non-recurring addons are as follows:
Note:
You can collect a one-time payment from a customer or a subscription using the Add Quick Charge option. This option is useful when you need to collect payments from customers for goods or services that are not normally included as 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, such as a non-recurring addon.
A one-time charge can be applied to a customer or a subscription via the Chargebee UI or API:
On the Chargebee user interface, the Add Addon action on the details page of either a subscription or a customer can be used to add a one-time charge. (Shown below for a customer)
Applying to a Customer
Note The time component can only be chosen when your site runs on millisecond-based billing mode.
Applying to a Subscription
Note The time component can only be chosen when your site runs on millisecond-based billing mode.
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 support.
Here are a couple of API calls that can be used to add charges:
In addition to creating invoices for a single addon or quick charge, you can also create invoices for multiple charges and non-recurring addons together. When you want to add multiple ad hoc charges or non-recurring addons to a customer or a subscription, you can use the Add One-Time Addons and Quick Charge action.
To raise an Invoice for multiple ad-hoc charges and addons, follow these steps:
Navigate to the details page of the customer or subscription.
Click Add One-Time Addons and Quick Charge on the Action panel.
On the Add One-Time Addons and Quick Charges page, click Add Quick Charge to add any ad hoc charges.
In the Add Charge pop-up, enter the following details:
Click Add One-Time Addon to add non-recurring addons.
You can click Add Coupon/Coupon Code to apply a coupon. (Multiple coupons of the same type can also be added. Contact support to enable this feature.)
Specify the PO number if required.
Under Invoice Notes, you can add additional information to be displayed to your customers on the invoice. Invoice notes configured for invoices in general, and those added for a customer, subscription, or non-recurring addon, if any, are displayed here as well. You can remove some of these notes and add a new note as needed. This note is displayed first in the invoice under Invoice Notes.
If the addon is a physical good to be shipped, you can add the shipping address details. You can choose to ship to the customer's billing address, or you can add a new shipping address. Any existing shipping addresses available for the customer are also available for selection.
Click Preview and Send to preview the invoice, and click Create Invoice.
Here's how the Add Addon, Add Charge and Add One-Time Charges and Addons option are displayed on the Action panel:
Here's how Add Addon configuration appears in the Change subscription page:
Was this article helpful?