Addon Pricing
An Addon Price defines the actual monetary amount, pricing model, and billing frequency for an addon. Each addon can have multiple prices — one for each combination of currency and billing frequency.
Pricing Dimension
Unlike rate plan prices (which use a full billing strategy with term length), addon prices are dimensioned by currency + billing frequency only:
| Entity | Pricing Dimension | Example |
|---|---|---|
| Rate Plan Price | Currency + billing strategy (frequency × term) | “$29/month, 12-month commitment” |
| Addon Price | Currency + billing frequency | “$49/month” or “₹999/month” |
| Charge Price | Currency only | “$199 USD” |
When a billing strategy like “Annually” (Monthly × 12) is selected on the product page, the addon resolves to the strategy’s underlying billing frequency (Monthly).
Creating an Addon Price
- On the product details page, click Set Price on an addon card (if no price exists), or click the dollar icon (Add Pricing) button.
- Fill in the form across four sections:
General Information
| Field | Required | Description |
|---|---|---|
| External Name | No | Customer-facing label shown on pricing tables, invoices, and the self-serve portal. |
| Internal Name | Yes | Auto-generated from the addon name, currency, and billing frequency. Read-only. |
| Addon Price Key | Yes | Unique API identifier. Auto-generated. Read-only. |
Pricing
| Field | Required | Description |
|---|---|---|
| Pricing Model | Yes | How the price is calculated. See Pricing Models below. |
| Price | Yes | The monetary amount. Displayed with currency symbol and flag. |
| Price already includes tax / Add tax on top of price | INR only | Choose how GST applies to this price. See Taxation Settings. |
| Tax profile | INR only | The GST rate and HSN/SAC for this price. Required when tax is added on top (the default profile counts); optional when the price includes tax, and then the default is used. Hidden for other currencies and when India is Handled by you. |
| Included Quantity | No | Number of units included in the base price. Only shown when Volume Pricing is selected. |
| Overage Price | Yes* | Per-unit price charged beyond the included quantity. Only shown and required when Volume Pricing is selected. |
Customer Facing Info
| Field | Required | Description |
|---|---|---|
| Description | No | Appears on invoices, quotes, and the self-serve portal. |
| Show Description in Invoices | No | Whether to include the description on generated invoices. |
| Show Description in Quotes | No | Whether to include the description on generated quotes. |
| Invoice Note | No | A standard note that appears on all invoice PDFs for this price. |
Usage-Based Billing (Per Unit / Volume Pricing)
When Per Unit Pricing or Volume Pricing is selected, additional usage-based billing fields appear:
| Field | Required | Description |
|---|---|---|
| Event Type | No | The usage event type to aggregate for billing (e.g., api_call, storage_gb). |
| Aggregation Method | No | How usage events are combined: SUM, COUNT, MIN, MAX, or AVG. |
| Aggregation Property | No | The event property to aggregate on (e.g., quantity, bytes_transferred). Hidden when aggregation is COUNT. |
| Filters (JSON) | No | Optional JSON filter applied to usage events (e.g., {"region": "us-east"}). |
- Click Create Addon Price.
Editing an Addon Price
- On the product details page, click the Set Price or Add Pricing button on the addon card.
- The edit form opens pre-populated with all existing values.
- Make changes and click Update Addon Price.
After saving, you are redirected back to the product details page.
Deleting an Addon Price
- On the addon card, click the trash icon (only visible when a price exists for the current currency/frequency selection).
- Confirm the deletion when prompted.
- After deletion, the card reverts to showing a Set Price button.
How Addon Pricing Displays on the Product Page
Addon prices respond to the currency and billing strategy selectors at the top of the product details page:
- Currency toggle (e.g., USD → INR) — Shows the addon price for the selected currency.
- Strategy toggle (e.g., Monthly → Annually) — Shows the addon price matching the strategy’s base billing frequency. For example, selecting “Annually” (Monthly × 12) displays the Monthly addon price.
If no price exists for the current currency/frequency, a Set Price button appears on the addon card.
Pricing Models
| Model | Description |
|---|---|
| Flat Fee | A fixed amount per billing cycle. |
| Per Unit Pricing | Price multiplied by quantity consumed. |
| Volume Pricing | All units priced at the tier matching total quantity, with included quantity and overage. |