New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model Context Protocol)

Developer Resources


  • Developer Resources Overview
  • Articles and FAQ

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • eInvoicing
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Product Catalog
  3. Articles and FAQ
  4. Addons
  1. Billing
  2. Product Catalog
  3. Articles and FAQ
  4. Addons

Billing cycle for recurring addons

Problem Statement

This article helps you understand billing cycle for recurring addons.

Summary

If you only want the addon to stay attached to the subscription for a fixed number of billing cycles, you can set the addon billing cycle parameter for the addon while creating or updating a subscription.

Solution

Set up a recurring addon.

To add the addon to a new subscription, navigate to Subscriptions and click on Create New Subscription. Click Add Recurring Addon. Here you choose the addon and mention the billing cycle as well.

image

The addon will be added to the invoice for the new subscription. As the term progresses and more invoices are generated for each billing cycle, the billing cycle will decrement to become zero and the addon will be removed after.

To add the addon to an existing subscription, locate the subscription and click Edit Subscription.

Then click on the edit icon for an addon to change the number of billing cycles.

image

For the existing subscriptions, when an addon is added, a prorated invoice is generated based on the subscription term. The prorated period will be considered as one billing cycle as far as the add-on is concerned. If you add a billing cycle to an existing addon linked to a subscription, no charge will be raised. However, the billing cycles for the addon against the subscription will be increased by 1.

If there is a change of term for the subscription (for example, you change the subscription from monthly to quarterly) and the change is done via API, ensure that the billing cycle of the addon is passed as well. If not, the billing cycle of the addon will be reset to 'forever', i.e., the customer will be charged for the addon indefinitely.

Related Articles

Error- Non-recurring addon cannot be added now as invoice is not raised immediately
How to restrict certain addons for specific plans?
My customers cannot add addons to their existing subscription
The addon trial details are not reflecting when I cancelled and reactivated the subscription
Can I set trial period for addons?
Where can I export non-recurring addons or charges in Chargebee?
Limitations of addon trial
How will invoices be generated for addons in trial?
How to override or set different price for an Addon/Charges in Latest Product Catalog?
Unable to delete an addon/charge in Latest Product Catalog
Where can I view the addon and charges associated to a plan in Latest Product Catalog?
How to map an addon/charge to a plan?
What is an addon? How to create it in Latest Product Catalog?
How to edit the addon and its price points? - Latest Product Catalog
How to set differential pricing for Addons in Latest Product Catalog?
What are non-recurring addons?

Show more

Was this article helpful?