Skip to main content
Step 1: What Are Plans?
Plans in Orb represent a template of prices to which you’ll subscribe customers. An example set of plans might be:
Free Plan : Limited features, free of charge.
Starter Plan : Basic paid plan.
Growth Plan : More features, higher pricing.
Step 2: Creating a New Plan
Go to the Plans Page in Orb and click Create Plan .
Name the Plan : For example, you can name it “Starter.”
Optional External Plan ID : This ID can be used in the API if you need to reference the plan externally, but you can skip this for now.
Step 3: Defining Pricing Types
In Orb, you can choose between two types of pricing models for your plan:
Usage-based Pricing : Powered by billable metrics that track usage (e.g., API calls).
Fixed Pricing : A flat fee charged regardless of usage.
Usage-Based Pricing
Select Usage-Based Pricing and choose a Billable Metric to track usage. In this example, we’ll use a metric that counts API calls.
Billing Cycle : Set how often customers will be charged (e.g., monthly).
Optional Additions :
Minimum Spend : Set a minimum charge (e.g., customers must pay at least $10 regardless of usage).
Maximum Spend : Cap the amount a customer can be charged.
Discounts : Add a discount by percentage, fixed amount, or usage amount.
Step 4: Pricing Models
Orb supports several pricing models:
Unit Pricing : Charge a flat rate per unit (e.g., $1 per API call).
Tiered Pricing : Charge different rates based on tiers of usage (e.g., $0.50 per call for the first 1,000 calls, then $1 after that).
Package Pricing : Charge in increments, where partial usage of a package is considered a full package until the next one is reached.
Bulk Pricing : Unlock a different rate for all units after a threshold has been reached
Matrix Pricing : Set prices based on multiple factors (e.g., region and machine size).
For simplicity, we’ll choose Unit Pricing and set the price to $1 per API call .
Step 5: Adding a Fixed Price
If your plan also includes a fixed charge, such as a platform fee:
Choose Fixed Price and name it (e.g., “Platform Fee”).
Set the price (e.g., $10 per month ).
Choose whether this charge will be billed in advance or in arrears .
In advance : The fee is charged upfront at the start of the billing cycle.
In arrears : The fee is charged at the end of the billing cycle, along with usage charges.
Step 6: Additional Options
Payment Terms : Choose when payment is due (e.g., on issue, net 7 days, net 30 days).
Trial Period : Offer a trial period where customers are charged 0% for a set number of days (e.g., the first 7 days are free).
Discounts, Minimum Spend, and Maximum Spent : You can add plan-level discounts or define minimum/maximum spend limits across multiple prices.
Step 7: Finalizing the Plan
Preview : Before creating the plan, review a preview of how it will appear.
Create Plan : Once everything is set up, click Create to publish the plan.
With these steps, you’ve successfully set up a pricing plan in Orb that combines usage-based and fixed pricing. This allows you to flexibly bill your customers based on how they use your service while maintaining the ability to charge fixed fees.