Addon Management
Addons are optional features or services attached to a subscription. BillHive supports two types of addon applicability and allows adding addons to active subscriptions mid-term.
Addon Applicability
| Type | Behavior |
|---|---|
| Mandatory | Automatically included when the subscription is created. Cannot be removed by the customer. |
| Recommended | Shown as optional during subscription creation and can be toggled on/off. Can be added later. |
Addon Details on Subscription
Each addon on a subscription displays:
| Field | Description |
|---|---|
| Addon Name | Name of the addon |
| Applicability | Mandatory or Recommended |
| Pricing Model | How the addon is priced (Flat Fee, Per Unit, Volume, etc.) |
| Quantity | Number of units (for quantity-based models) |
| Price | Per-unit or total price |
| Status | Active or Inactive |
Adding Addons to an Existing Subscription
Available when: Status = Active, Paused, or Trial
Form Fields
| Field | Required | Description |
|---|---|---|
| Change Option | Yes | When the addon takes effect: Immediately, End of Term, or Specific Date |
| Change Date | Conditional | Only required when Change Option = “Specific Date” |
Workflow
- Click Add Addon on the subscription details page.
- The modal shows available addons (excludes addons already on the subscription and filters by “Recommended” applicability).
- Toggle the addons you want to add.
- Optionally apply a coupon or offer code.
- Review the order estimate showing the addon’s price and dates.
- Confirm to place the order.
What Happens
- An order is created with event type ADD ADDON.
- The addon’s dates and price are set by the Billing Frequency setting. See How an addon added mid-term is priced.
- An invoice is generated for that amount.
- The addon appears on the subscription’s home tab with its pricing details.
- Subsequent billing cycles include the addon’s recurring charges.
How an addon added mid-term is priced
| Billing Frequency | Addon runs | Charged |
|---|---|---|
| Plan Based Billing | From today to the end of the subscription’s current term, then renews with the plan | Only for the part of the term left: the addon’s price for the whole term × the unused share of the term |
| Multi Frequency Billing | One full addon billing cycle, starting today | The addon’s full price for one cycle |
Under Plan Based Billing, “the addon’s price for the whole term” is its price converted to the plan’s billing period. For example, a monthly addon on a yearly plan is 12 × its monthly price. The unused share of the term is counted with your Proration Method, the same rule used for plan changes and cancellations.
Examples under Plan Based Billing, with Actual days. A ₹500/month addon is added Immediately:
| Subscription | Added | Addon runs | Charged |
|---|---|---|---|
| Monthly plan, term 1 – 30 Jun | 1 Jun (first day) | 1 – 30 Jun | ₹500, the full month |
| Monthly plan, term 1 – 30 Jun | 16 Jun (15 of 30 days left) | 16 – 30 Jun | ₹500 × 15/30 = ₹250 |
| Yearly plan, term 1 Jan – 31 Dec | 17 Nov (45 of 365 days left) | 17 Nov – 31 Dec | ₹6,000 × 45/365 = ₹739.73 |
At the next renewal, the addon is charged its normal price for the new term.
If your Proration Method leaves nothing to prorate while days of the term remain, the addon is charged its full price for the term rather than nothing. This happens with Whole months when no complete month is left in the term, which is every mid-term addition on a monthly plan.
If the plan changes later in the term, the addon is credited for the unused part of the term on the same basis, so it is never credited more than it was charged. See Proration & Credits.
Addons During Plan Changes
When changing plans, the new plan may have a different set of available addons:
- Mandatory addons on the new plan are automatically included.
- Recommended addons are shown for optional selection.
- Addons from the old plan that are not available on the new plan may be removed (with prorated credits).
Addons During Frequency Changes
When changing billing frequency with Add-on Alignment set to Plan Based, you have the option to include recommended addons at the new frequency’s pricing. This ensures addon prices align with the updated billing cycle.