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.
Removing an Addon or Changing Its Quantity
Available when: Status = Active
Each addon on the subscription page has Remove and Change quantity. Remove is hidden for mandatory addons. Both are hidden for addons whose price is included in the plan, and Change quantity is available only for Flat Fee addons, so it is hidden for addons billed by usage and for Volume or any other pricing model (the credit or charge would be wrong). Remove still works for them. Mandatory addons can be raised, and lowered down to the plan’s quantity.
Pick when the change happens:
| Option | Removing | Changing the quantity |
|---|---|---|
| Immediately | The addon ends today (status Inactive, end date today). | Up: the extra units are billed for the rest of the term, like a new addon. Down: the dropped units stop today. |
| End of Term | The addon stays until the term ends. | The addon keeps its quantity until the term ends. |
Either way, the next renewal is rebuilt without the addon, or with the new quantity. If the renewal invoice has already been raised, it is voided, or credited if it was paid.
Credits
An Immediately remove or drop gives a credit note for the unused days, when prorated billing is on. It is worked out with your Proration Method, plus GST if the invoice charged it. The credit note is account-wide, so it can pay any open invoice on the account. With prorated billing off there is no credit. End of Term never gives a credit.
For example, removing a 300 addon Immediately on day 10 of a 30-day term (20 days left, Actual days) credits 200.
A new change replaces any plan or frequency change that was still scheduled. The customer gets one “Add-ons updated” email. Customers can do this from the self-serve portal only when the enableManageAddons feature flag is turned on for the product. It is off by default.
Addons During Plan Changes
A plan change (Immediately or Specific Date) ends, bills and attaches addons as follows.
The old plan’s addons
| Addon | What happens |
|---|---|
| Plan based (Add-on Alignment = Plan Based) | Ends on the change date: status Inactive, end date the day before the change. The unused part is credited when prorated billing is on. With it off there is no credit, but the addon still ends. |
| On its own billing cycle, and the new plan offers it as an optional or recommended addon (price not included) | Carries over unchanged: no credit and no new charge. |
| On its own billing cycle, and the new plan doesn’t offer it | Ends on the change date, with a credit for the unused part of its own period when prorated billing is on. |
| On its own billing cycle, and the new plan makes it mandatory (price not included) | Ends and starts again under the new plan: credited as above, and billed with the new plan’s mandatory addons from the same day, so no day is billed twice. |
| On its own billing cycle, and the new plan includes its price | Ends, with a credit as above when prorated billing is on. It isn’t charged again: the new plan’s price covers it. |
The new plan’s addons
- Mandatory addons with price not included are billed like the plan: prorated over the days left when the term is kept, or in full × cycles when a new term starts (another billing period, or prorated billing off).
- Addons picked in the change are priced the same way. A picked addon that the new plan makes mandatory is billed once, with the mandatory ones; one whose price the new plan includes isn’t charged.
- Both are attached to the subscription on the new term, for the dates they were billed for. The next renewal carries them instead of the old plan’s addons.
The change-plan form pre-selects the subscription’s addons that the new plan also offers; you can clear them before confirming.
For example, on day 10 of a 30-day monthly term (20 days left, daily proration), a change from a plan with a 100 plan-based addon to one with a 200 mandatory addon credits 66.67 for the old addon and charges 133.33 for the new one.
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.