Orders
An Order is a transactional event that creates or modifies a subscription. Every subscription change in BillHive — from initial creation to plan changes, addon additions, renewals, and cancellations — is driven by an order.
Order Types
| Event Type | Trigger | Description |
|---|---|---|
| New Subscription | Creating a subscription | Places an order for a new subscription with the selected product, plan, currency, and addons. |
| CHANGE PLAN | Changing rate plan | Creates an order to switch the subscription to a different plan, with prorated credits and new charges. |
| FREQUENCY CHANGE | Changing billing frequency | Creates an order to update the billing period (e.g., Monthly → Annually). |
| ADD ADDON | Adding an addon | Creates an order to attach a new addon to the subscription with prorated charges. |
| Subscription Renewal | Renewing a subscription | Creates an order to start a new term for an expiring or expired subscription. |
| Cancellation | Cancelling a subscription | Creates an order to terminate the subscription with credit/refund handling. |
Order Structure
Each order contains:
| Field | Description |
|---|---|
| Source System | Where the order originated (e.g., “BillHive Web App”) |
| Event Type | The type of change (see table above) |
| Currency | Billing currency for the order |
| Cart Items | Line items: subscription, addons, and their quantities |
| Personal Info | Customer account ID |
| Coupons | Applied coupon or offer codes (optional) |
Order Estimates
Before any order is confirmed, BillHive calculates a real-time order estimate showing:
- Credits — Prorated refunds for unused portions of the current plan/period
- Charges — New charges for the updated plan, addons, or renewal
- Adjustments — Coupon discounts or promotional offers
- Net Amount — The final charge or credit to be invoiced
This gives admins full visibility into the financial impact before committing the change.
Viewing Orders
Orders are visible on the subscription details page under the Orders tab. Each order shows:
- Order ID
- Event type
- Date created
- Amount
- Status
Orders are also reflected in the Activity Log for audit purposes.
How Orders Drive Billing
- An admin or system triggers an action (plan change, addon addition, renewal, etc.).
- BillHive’s pricing engine calculates the order estimate.
- On confirmation, the order is placed and processed through the facade’s order orchestration.
- An invoice is generated for any net charges.
- Payment is collected via the configured payment method.
- The subscription’s state and terms are updated accordingly.