Spending controls

How spending caps and automatic bandwidth top-ups behave.

ByteKit has two distinct spending controls: a credit-overage cap and automatic bandwidth top-ups.

Credit-overage spending cap

No standard plan is overage-enabled: Starter, Growth and Scale stop at the included credit allowance with 402 quota_exceeded, so this cap never applies to them. It applies only to a custom plan arranged with ByteKit that carries an overage agreement.

For a credit-metered request on such a plan, ByteKit compares the calculated overage cost with the account's max_overage_spend_cents. When the request would cross that limit, the API returns HTTP 402 with spending_cap_reached.

The current billing page does not expose a self-service control for this account-level overage cap. Contact support if it must be changed.

Automatic bandwidth top-ups

The billing page lets an account administrator enable or disable auto-top-up and configure:

  • the remaining-bandwidth threshold that triggers a purchase;
  • the amount of bandwidth to purchase; and
  • a monthly cap on automatic top-up spending, from $1 to $1,000.

All three are required when auto-top-up is enabled, and the account must have a Stripe customer. When remaining included bandwidth falls below the configured threshold, ByteKit queues a top-up — unless that purchase would take this month's automatic top-up spending past the cap, in which case it is skipped until the next month. An account that has never stored a cap is uncapped, and the API reports its cap as null.

These controls do not configure purchased-balance expiration. See Top-ups for the expiry and rollover rules enforced by the billing ledger.