Usage-based billing recipes/Included usage with hard caps

Build a hard-cap model that gives customers certainty and creates upsell signals

Your customers buy a fixed pool of usage and know exactly what they'll pay at renewal. When the pool runs out, the feature stops. No surprises, no disputes, no unexpected charges. Chargebee meters against the ceiling in real time and alerts your team the moment it's time to upgrade the conversation.

Model
Included usage, hard cap
Complexity
Low
Building blocks
3
Reference
Phrase
Phrase · Business plansphrase.com/pricing
Team
$1,245/mo
Business
Custom
Enterprise
Custom
Capacity metric
Team
Business
Enterprise
TMS Processed Words
2.5M / yr
12M / yr
Custom
Strings Managed Words
1,200,000
3,000,000
Custom
MTUs (AI translation)
12M / yr
50M / yr
Custom
AI Units (AIUs)
25,000 / yr
100,000 / yr
Custom
Capacity add-ons
Available on all plans at additional cost
Source: phrase.com/pricing and Platform Pricing Terms · Illustrative customer below is not a real Phrase account.
The model

The allowance is the deal.
The limit opens the next one.

Your customer buys a fixed pool of usage with their plan and pays a flat fee for the term. When the pool runs out, the feature stops. There is no overage line on the invoice and no automatic top-up. The price is settled on day one, and that is still the price at renewal.

When an account hits the ceiling, it has outgrown its plan. That moment is the cleanest upgrade conversation you will have. You are pointing at a number everyone agreed on at signing, not presenting a surprise bill.

This works when
  • The value metric has a natural ceiling customers plan around: words, API calls, documents
  • Your buyers treat surprise invoices as a trust problem, not a billing inconvenience
  • The sales motion depends on contract clarity at signing rather than end-of-month reconciliation
  • Hitting the limit is a useful commercial signal: the account has grown into a larger tier
The recipe

Three building blocks: the plan, the entitlement, the ceiling

Three objects in the Chargebee catalog. Define them once and they carry your commercial logic through every deal.

1
PlanThe anchor
Business/annual term

The subscription tier your customer commits to for the year. Billed flat on the annual term. The plan carries default allowances for each usage metric. Those defaults are the starting point for every deal.

2
Quantity featuresThe allowance
2 metricsper term

Two value metrics that match Phrase’s model: TMS Processed Words (words submitted to translation jobs, resets each term) and Strings Managed Words (words stored in Phrase Strings, concurrent). Independent ceilings, metered separately against each entitlement.

3
Entitlement limitsThe ceiling
Restrictat allowance

One entitlement per metric, set to “Restrict access” at the allowance value. When consumption
reaches the ceiling, Chargebee surfaces the limit through the entitlements API. Your product enforces it.

01 Set up

The allowance is the deal. The limit opens the expansion conversation.

You define each plan’s default allowances once in Chargebee. TMS Processed Words and Strings Managed Words each get a default value and an entitlement set to “Restrict access.” Every new subscription starts from those defaults. Where your sales team negotiates a larger pool for a specific account, you override the entitlement on that subscription at signing. The plan stays clean and the override lives on the customer’s record.

Product Catalog Phrase BusinessLive
Phrase BusinessAnnual plan · two metered features · hard ceiling on each
EditManage entitlements
ChargesEntitlementsPricingValue metrics
FeatureTypeIncludedAt limit
TMS Processed Wordsfeat_tms_words · resets each term
Quantity
4,000,000 /term
Restrict access
Strings Managed Wordsfeat_strings_words · concurrent stored
Quantity
1,200,000 /term
Restrict access
02 Sell

The deal puts the ceiling in writing.

Your sales team quotes the deal in Chargebee CPQ, natively or through HubSpot or Salesforce. Northwind Labs translates at high volume and negotiates a larger TMS allowance. The quote carries both the plan price and the entitlement overrides, so the contract states the exact ceiling Northwind is buying before the subscription goes live.

On e-signature, Chargebee creates the subscription with the negotiated entitlements already attached. Every other Business customer keeps the catalog defaults. No new plan needed.

Quotes Q-2026-0194Accepted
Q-2026-0194Northwind Labs, Inc. · 12 month term, effective May 1, 2026
DownloadConvert to subscription
ItemTermNet amount
Phrase Businessplan_phrase_business
12 months
$24,000.00
Entitlement overridePlan defaultThis deal
TMS Processed Words4,000,0006,000,000
Strings Managed Words1,200,0002,000,000
Prepared by
Sales
Approved by
Deal Desk
Signed
Northwind Labs · Apr 27, 2026

Illustrative figures. Overrides live on the subscription. Catalog defaults are unchanged for all other accounts.

03 Meter

Send the events. Chargebee keeps the count.

Every time Northwind submits a translation job, your product sends a usage event to Chargebee. Chargebee accumulates the count against the subscription entitlement in real time. Each event carries a deduplication_id, subscription_id, and millisecond usage_timestamp. If the same event arrives twice due to a retry or a pipeline failure, Chargebee records it once. You never overbill a customer because of your own infrastructure.

Before accepting a new job, your runtime reads the remaining TMS balance from the entitlements API. If the balance covers the word count, proceed. If not, your product can queue the job, show an upgrade prompt in-app, or block processing entirely based on your usage policy.

Usages sub_NL_4471Live
Northwind Labs · Usage logTMS Processed Words · term May 1, 2026 to Apr 30, 2027
Deduplication IDUsage timestampfeat_tms_wordsRunning total
dedup_4820f3a
1736863320123
142,800
5,842,100
dedup_4820c1e
1736845620000
96,200
5,699,300
dedup_481fa44
1736779800000
218,000
5,603,100
ingest a usage event (Chargebee usage events API)
POST /usage_events
{ "deduplication_id": "dedup_4820f3a",
  "subscription_id":  "sub_NL_4471",
  "usage_timestamp":  1736863320123,  // milliseconds
  "feat_tms_words":   142800 }
When the ceiling approaches

The ceiling is reached. Sales adds capacity mid-cycle.

By October 2026, Northwind’s running total has reached the 6,000,000 TMS ceiling. New translation jobs are gated. Your sales team creates a mid-cycle capacity add-on directly on the subscription in Chargebee. No new quote is needed for a straightforward expansion. The additional 2,000,000 words are provisioned immediately and pro-rated for the remaining six months of the term.

Add-on · mid-cycle capacity purchaseIllustrative figures
Subscriptionsub_NL_4471 · Northwind Labs
Add-on itemTMS Processed Words · +2,000,000
New TMS ceiling8,000,000 for remainder of term
Pro-rated periodNov 1, 2026 – Apr 30, 2027 (6 months)
Add-on charge$2,800.00
BillingAdded to next invoice automatically
04 Alert

Know who is close to the ceiling before they hit it

Configure usage alerts in Chargebee at 80 and 90 percent per metric. When a subscription crosses the threshold, Chargebee fires a webhook. Your product can warn the customer in-app, flag the account to the sales team, or queue jobs for later processing instead of blocking them outright. The earlier your team knows, the cleaner the upgrade conversation.

Alerts TMS 80% · Business tierActive
80% TMS Processed Words / Business tierActive
Metered feature
TMS Processed Words (feat_tms_words)
Alert type
Usage exceeds
Threshold
80% of included usage
Applies to
All Business tier subscriptions
Channel
Webhook
Status summary
● Within limits
265
Subscriptions below 80% of TMS allowance
▶ In alarm
47
Subscriptions above 80% of TMS allowance
You can configure different alert behaviour by plan tier
Subscription hits 80% of TMS allowance
Business tier
In-app upgrade prompt shown
Customer sees a nudge to expand their plan before jobs are gated
Enterprise tier
CSM notified via webhook
Account manager gets the signal before the customer notices the ceiling
Chargebee · Schema-flexible metering

Meter everything now.
Price what matters later.

In this example, Phrase's billing model tracks TMS Processed Words and Strings Managed Words. But translation pricing can evolve. Language pair complexity, source file size, character-based language premiums, or AI translation units could each become a pricing lever as your product matures.

Because Chargebee ingests raw usage events without a fixed schema, every dimension you send now is a monetization option you can switch on later, without rebuilding your instrumentation or redeploying your metering layer.

Metered dimensions
TMS Processed WordsWords submitted to translation jobs · resets each term
Priced
Strings Managed WordsWords stored in Phrase Strings at any point in term
Priced
Language pairSource → target language combination per job
Tracked
Source file sizeKB per uploaded document
Tracked
AI translation unitsGenerative AI calls per job
Not yet
05 Bill

The price was agreed on day one. So is the invoice.

At renewal, the plan charge is unchanged. But because Northwind purchased a mid-cycle capacity add-on in October, the invoice carries two lines: the annual plan and the pro-rated add-on charge. Chargebee handles both automatically. When the add-on was created on the subscription, it was scheduled for the next billing date. No manual invoice editing, no separate charge to chase.

The consumption summary below the total shows what Northwind used against their expanded ceiling. It is informational and does not affect the amount due.

Invoices INV-2027-0084Paid
INV-2027-0084Issued May 1, 2027 · Northwind Labs, Inc. · Renewal + add-on
DescriptionPeriodAmount
Phrase BusinessAnnual plan charge
May 2026 – Apr 2027
$24,000.00
TMS Processed Words add-on+2,000,000 words · pro-rated 6 months
Nov 2026 – Apr 2027
$2,800.00
Total due$26,800.00
Entitlements consumed · full term Informational. Not billed.
TMS Processed Words7,209,400 of 8,000,000 (incl. add-on)
Strings Managed Words1,931,400 of 2,000,000
Step 06 · Report

Your account team sees who to call

Every usage alert in Chargebee carries a Status Summary: subscriptions Within Limits and subscriptions In Alarm. For an account manager, the In Alarm list is the shortlist for this quarter’s expansion conversations.

TMS Processed Words · December 2026
84.2M
9% vs. November
Subscriptions Within Limits
265 of 312
below 80% of TMS allowance
Subscriptions In Alarm
47 of 312
ready for expansion conversations
Top accounts by TMS consumptionDecember 2026 · sorted by words used
AccountTMS consumed / allowed
Northwind Labs5,842,100 / 6,000,000
Meridian Health7,890,000 / 8,500,000
Brightwave Systems3,784,800 / 4,000,000
Cobalt Systems3,080,400 / 4,000,000
Apex Commerce2,256,000 / 4,000,000
Solaris Media4,320,000 / 8,500,000
Driftwood Tech1,140,000 / 2,500,000
Vantage Retail1,782,000 / 3,000,000
Start building

Certainty becomes your competitive edge.

When customers know their usage limits upfront, they buy with confidence and scale predictably. Chargebee meters usage in real time, alerts you when customers are close, and handles mid-cycle purchases without manual work.