Knowledge Base

Subscription Tiers and Billing Architecture

Subscription Tiers and Billing Architecture

StateWarden subscriptions operate at the Realm level: every device paired to a Realm inherits the quotas and capabilities of that Realm's active plan. Self-service billing is processed by Stripe as Merchant of Record; contract customers (Enterprise) and integrator-managed Realms are billed via manual invoicing outside Stripe.

All billing operations are performed from the Subscription & Billing page (/billing) and require the realm.manage_billing permission.


1. Plans

Four tiers exist: Free, Pro, Business, and Enterprise.

A plan defines the Realm's resource limits: the maximum number of devices, the maximum storage quota, and the daily operation caps for backups and security scans (see Understanding Quotas and Fair Use).

  • Free: The base tier. Every new Realm starts on the Free plan.
  • Pro / Business: Paid self-service tiers with higher limits, activated via checkout.
  • Enterprise: Manual invoicing with individually negotiated limits (custom device and storage ceilings). Enterprise subscriptions are provisioned by platform administrators; the Subscription & Billing page then displays your contract (SLA) overview instead of the self-service configurator. For upgrades, additional storage, or renewals, contact your account manager at [email protected].

2. Self-Service Operations

2.1. Changing Your Plan

  1. Open Subscription & Billing.
  2. Select a plan and any add-ons, and choose the Business (B2B) or Personal (B2C) context.
  3. Before you confirm, the Dashboard displays a billing preview: your current monthly total, the new monthly total, and the prorated amount due now.
  4. On confirmation:
    • If the Realm already has an active Stripe subscription, it is updated in place and proration is applied.
    • Otherwise, you are redirected to a Stripe Checkout Session to complete payment.
  5. Activation is confirmed automatically as soon as Stripe completes the checkout. The Realm's quotas are recalculated at that moment and take effect immediately.

Billing cycle: plans publish both a monthly and a yearly price, but checkout currently creates monthly subscriptions only.

B2B / B2C: the context toggle selects which Stripe product is billed for the line items. Taxes are calculated and collected by Stripe as Merchant of Record.

2.2. Add-ons

  • Storage block: +1 TiB of storage quota and +20 device endpoints per unit.
  • Endpoint: +1 device endpoint per unit.

Add-ons can be adjusted at any time from the billing page; the Realm's effective limits are recalculated immediately.

2.3. Promo Codes

Promotion codes can be applied from the billing page. Codes are validated server-side: active status, validity window, redemption caps, and a limit of one redemption per Realm. Stripe promotion codes are also accepted during checkout.

3. Failed Payments and Downgrades

Downgrade behavior depends on the billing track. Note that the self-service track has no grace period.

Stripe (Self-Service) Track

If the Stripe subscription becomes inactive - payment failed, canceled, paused, or expired - the Realm is immediately downgraded to the Free plan. From that point, new operations are constrained by Free-tier limits.

Manual-Invoice (Contract) Track

When a manually invoiced subscription passes its expiry date, it is marked as past due. If the subscription remains unresolved for 14 days, it is canceled and the Realm is downgraded to the Free plan. Integrator-managed Realms carry no subscription expiry and are exempt from this mechanism.

Data Preservation

A downgrade never deletes data. Only the Realm's plan and forward-going limits change; existing backups remain stored on the Driad storage nodes.


StateWarden: Resilience Engineered.

Was this article helpful?