Farther ShoreDocs
Go to Farther Shore
Getting startedCore conceptsLaunch checklist
ProductsUpstream routingEnvironmentsDeveloper portals
Billing strategiesPlans and limitsSubscribersAPI keys
Gateway enforcementUsage meteringLimits and creditsGateway sharding
Launch a request-counted product15mAdd monthly included usageAdd subscription plus overageCreate a prepaid credits productMeter AI token usageAdd a custom meterIssue and test an API keyDebug a denied requestUpdate product docsPrepare for launch
TroubleshootingGateway response codesMeter namingPlatform docs publishing
Status
Docs/Cookbook/Add subscription plus overage

Add subscription plus overage

Let subscribers exceed quota and bill the extra usage.

PreviousAdd monthly included usageNextCreate a prepaid credits product

On this page

ExampleStepsGateway behaviorProduct docs languageValidation

Subscription plus overage gives subscribers a predictable base plan with room to grow.

Example

Pro
$99 / month
100,000 requests included
$0.50 per 1,000 extra requests

Steps

  1. Create or edit a recurring plan.
  2. Add included usage for the primary meter.
  3. Enable overage for the same meter.
  4. Set the overage unit and price.
  5. Update portal copy so subscribers understand the extra cost.
  6. Publish the plan.
  7. Test usage below and above the included amount.

Gateway behavior

With overage enabled, the gateway should continue forwarding requests after the included quota is exhausted. Usage events mark the extra usage for billing.

Product docs language

Use explicit language:

The Pro plan includes 100,000 requests per month. Additional requests are billed
at $0.50 per 1,000 requests.

Avoid vague language:

Extra usage may apply.

Validation

Confirm:

  • usage below quota is included
  • usage above quota is allowed
  • overage usage is visible in billing calculations
  • subscribers can see the overage rule before subscribing