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 monthly included usage

Add monthly included usage

Give subscribers a monthly quota inside a recurring plan.

PreviousLaunch a request-counted productNextAdd subscription plus overage

On this page

ExampleStepsHard stop behaviorTest the limitUpgrade path

Included usage lets subscribers pay a recurring fee for a monthly allowance.

Example

Starter
$29 / month
10,000 requests included
No overage

Steps

  1. Open the product plan.
  2. Choose a recurring billing interval.
  3. Add an included usage amount.
  4. Select the meter, such as requests.
  5. Decide what happens after the included amount.
  6. Publish the plan.
  7. Test with a subscriber near the limit.

Hard stop behavior

If the plan has no overage, the gateway denies requests after the included usage is exhausted.

Document this clearly:

This plan includes 10,000 requests per month. Requests above the included amount
are denied until the next billing period or plan upgrade.

Test the limit

Use a test subscriber and generate enough usage to cross the limit. Confirm:

  • allowed requests count toward the included amount
  • requests after the limit return a gateway denial
  • the response code matches a limit failure
  • usage totals match expected request count

Upgrade path

Give subscribers a clear recovery path:

  • wait for the next billing period
  • upgrade to a higher plan
  • switch to a plan with overage
  • contact support if usage looks incorrect