Product Catalog

Konnect Metering & Billing’s Product Catalog lets you centrally define the different plans and plan features that make up your offering—so you can manage pricing, entitlements, and packaging in one place.

Each Product Catalog plan consists of:

• Features that you want to price or govern. Can be metered or static.
• Rate cards that determine which features (entitlements) and how much of the feature a subscriber can access (pricing models)
• Optional add-ons that allow customers to purchase additional usage or features on demand

For example, say you’re metering API Gateway requests for your API and you want to charge customers based on API usage, you might configure your plans like the following:

 
flowchart TB
 subgraph free-plan["Free Plan"]
    direction TB
        subgraph feature-free["Feature"]
            direction TB
            meter-free["Meter
(API requests)"]
        end
        rate-card-free["Rate Card
(10 requests/month)"]
        entitlement-free["Entitlement (Metered)"]
  end
  
 subgraph premium-plan["Premium Plan"]
    direction TB
        subgraph feature-premium["Feature"]
            direction TB
            meter-premium["Meter
(API requests)"]
        end
        rate-card-premium["Rate Card
(1000 requests/month)"]
        entitlement-premium["Entitlement (Metered)"]
        addon["Add-on
 (1000 additional requests)"]
  end
  
    meter-free ~~~ rate-card-free
    rate-card-free ~~~ entitlement-free
    
    meter-premium ~~~ rate-card-premium
    rate-card-premium ~~~ entitlement-premium
    entitlement-premium ~~~ addon
  

Features are part of your product offering and the building blocks of your plans and entitlements. They are the resource you want to govern and invoice for. For example, LLM Models, tokens, storage units. Features are associated with a meter, so that you can connect usage to a feature that you can then charge for.

Features are the building blocks of your product offering, they represent the various capabilities of your system. Practically speaking, they typically translate to line items on your pricing page and show up on the invoice.

The feature set between plans can vary in terms of what features are available, what configurations are available for a given feature, and what usage limits are enforced.

The following table details an example for a fictional AI startup:

Features can be archived, after which no new entitlements can be created for them, but the existing entitlement are left intact. You can think of this as deprecating a feature, removing it from the pricing page, or migrating it to a new name (key).

Plans are a core component of the Product Catalog. Plans define the pricing and entitlements your customers receive in Konnect Metering & Billing. They act as reusable templates that describe what a customer gets and how they are charged. Each plan can include multiple phases, prices, and entitlements, and can be versioned.

Plans can take different forms, for example:

• $99 per month for 1 million API requests
• 10 GB storage included
• SAML or SSO support

Rate cards

Plans are built from rate cards, which determine which features a plan can access, the price, and how much of a feature they can use (called entitlements). Rate Cards define the configuration of features that subscribers will be entitled to and charged for.

For example, to set up the previous example plan, you’d use the following rate cards:

Rate cards can be configured with or without a feature:

• With a feature: Rate cards with features can be priced as recurring, one-time flat, or usage-based. Rate cards with features can have an entitlement to control access. When the associated feature has a meter, the rate card can describe usage limits.
• Without a feature: Rate cards without features can only have a flat-fee price. Rate cards without features don’t have an entitlement to control access.

Add-ons

Add-ons let you extend your plans with optional features or capacity that customers can purchase on demand. They are versioned and consist of one or more rate cards defining pricing, entitlements, and billing cadence independently of the base plan. Add-ons allow you to sell extra features, overage packs, or services without changing the core plan.

Pricing models

Rate cards offer several different pricing models, listed in the following table:

Besides the Free pricing model, other models require configuration that you can see from the Konnect UI.

Tax calculations

Metering & Billing doesn’t calculate taxes itself. Instead, it configures external services to do so with Product Catalog. Currently, Metering & Billing supports Stripe Tax.

Metering & Billing supports the following tax settings:

• Inclusive: The listed price already includes tax. A 10% inclusive tax on a $500 item still results in a $500 invoice.
• Exclusive: Tax is added on top of the listed price. A 10% exclusive tax on a $500 item raises the invoice total to $550.
• Tax codes: Apply a tax code to a feature. Some payment providers, like Stripe, apply their own default tax code. In those cases, you can leave Metering & Billing’s tax settings blank.

You can enable tax collection from a Rate Card or the billing profile settings.

In Metering & Billing, you can define the tax behavior on multiple levels, from lowest to highest precedence:

We recommend setting the tax behavior on the payment provider level if you use Stripe for tax calculation. Tax behavior is optional at the billing profile, plan rate card, and subscription rate card levels.

When tax enforcement is enabled, Metering & Billing prevents you from starting a subscription if automatic tax calculation isn’t supported. When enforcement is enabled, the following actions are blocked:

• Creating a paid subscription when tax cannot be calculated
• Finalizing an invoice when tax cannot be calculated
• Validation logic also varies by tax service. For example, with Stripe Tax, Metering & Billing uses Stripe’s APIs to verify whether tax calculation is supported for the customer. In that case of Stripe, the customer must have a valid tax location.

Entitlements

Entitlements are used to control access to different features, they make it possible to implement complex pricing scenarios such as monthly quotas, prepaid billing, and per-customer pricing.

Entitlements can help you implement various monetization strategies:

• Enforce usage limits, like monthly token allowances.
• Sell plans with various feature sets.
• Offer custom quotes and per-customer pricing.
• Adopt prepaid billing and grant usage, and handle top-ups.
• Define and track pre-purchase commitments.

There are three different types of entitlements:

Plan versions

Plans are versioned to allow you to make changes without affecting running subscriptions. Each plan can have one published and one draft version. Editing already published plans will create a new draft version. Once you are ready, you can publish the draft version.

Subscriptions are bound to a specific version of the plan and can be migrated to a new version.

Plan phases

A plan can have multiple phases, such as a free trial for the first 30 days and then converting to a paid plan after the 30 days are up. Each phase can have a different price and entitlement. Phases can be used to create automatic time-based offering changes, like trials, reverse trials, ramp-up phases.

Example for reverse trials with plan phases:

• Phase 1 (Trial): limited to 100,000 tokens, premium features included
• Phase 2 (Free): limited to 1,000 tokens

Rate Cards discounts and commitments allow you to adjust the price of a feature in a plan.

The following table describes the discounts and commitment types:

Konnect Metering & Billing subscriptions link your Customers to plans, and meters.