Skip to content

Billing Plans

ComputeStacks uses billing plans as a rule set for determining the real time price for a given resource. We also use this for generating the price matrix on order forms.

You can create as many billing plans as you want, but only one may the default. This is useful for creating custom or special pricing for a different set of users.

If no price rule exists for a given scenario (e.g. currency + region + quantity), ComputeStacks will default to a price of zero.

Products & Packages

A product is a separate object from Billing Plans, which allow you to define it once, and use it in multiple plans.

Creating a Product

Products are the base for packages, so you must define this first prior to creating a package.

External ID

This is available in WebHooks and API Calls. This is generally used by billing integrations to identify this product.

Kind

Package or Metered Resource

  • Package: Container package
  • Metered Resource: Bandwidth, Storage.

Resource

Only applies of ‘Kind’ is ‘Metered Resource’

This tells ComputeStacks what kind of resource this is. When we’re calculating pricing on the hour, we will use this value to find the price for a given resource.

Unit

This should almost always be 1.

Unit Type

CORE for CPU, MB for Memory, and GB for bandwidth and storage.

Aggregated Usage

Currently only used for Bandwidth.

When checked, we will compare the result from the last usage period and subtract that from the current reading.

Creating a Package

Once you’ve created your product with type Package, you will see an option to create a package on the product list.

CPU

How many CPU Cores to assign. These can be fractional units of 0.25.

Memory

Memory is stored in MB.

Included Storage

Anything over this amount will be charged at the current storage rate set in the users billing plan.

Included Bandwidth

Up to this amount is included, anything else will be charged as overage.

Included Backup Storage

Anything beyond this will be charged as overage.

Billing Phases

Phases are a way to describe the current state of a subscription. There are three possibilities: Trial, Discount, and Final.

Phases only move forward and never backwards. The transition to the next phase is automatic and based on the duration of that phase.

The duration defined in the phase is the maximum amount of time the subscription will stay in the phase. The actual time frame will depend on the billing_start field for a given user. The billing start is automatically set when a user places their first order. This can also be set manually by an administrator at any time.

For example, if a trial phase is set to last for 14 days and a user placed their first subscription for a different order 7 days ago, they will get a free trial for 7 more days.

So for Trial and Discount phases, the time frame not only applies to how long a given subscription will be in that phase, but also the total amount of time they have access to that phase.

Pricing

Prices are unique to their parent phase, and can be customized for specific regions, currencies, and quantity.

There is a global default currency set during the installation process, however each user can have a different currency set by Administrators. This, along with billing plans, offers the ability to support multiple currencies under the same installation.

Tiers

By adding a maximum allowed quantity, you can create tiered pricing. This is popular for storage and bandwidth.


Last update: 2020-07-16