Concepts
How credits, entitlements, metering, reservations and the rest work under the hood. Every page ships a .md twin for your agent.
Credits
How QuotaStack stores, grants, debits, and tracks credits using millicredits, credit blocks, and an append-only ledger.
Read →Entitlement Management
Entitlement management for usage-based products — check whether a customer can perform an action with sub-millisecond, cached checks on the hot path.
Read →Metering
How to define billable metrics, configure metering rules with flat/per-unit/tiered pricing, and record usage events that debit credits.
Read →Reservations
How to hold credits during long-running operations using the reserve/commit/release lifecycle, with TTL-based auto-expiry and concurrency safety.
Read →Topups and Wallets
How to grant credits after payment, model wallets and credit packs, configure topup packages, and control burn order with priority.
Read →Subscriptions
Optional recurring billing state management with prepaid and postpaid modes, credit grants on renewal, rollover, and contract lifecycle.
Read →Payment Connectors
Connect hosted payment gateways to QuotaStack while keeping money movement, subscription state, credits, usage, and entitlements under explicit ownership.
Read →Idempotency
How QuotaStack prevents duplicate operations using the Idempotency-Key header, server-side locks, and deterministic key conventions.
Read →Webhooks
Event delivery from QuotaStack to your application, with HMAC-SHA256 signing, retry schedule, and event catalog.
Read →Customer Identification
Two identifier types and two URL forms for customers — when to use each, and how to avoid mixing them.
Read →API Conventions
Environments, authentication, rate limits, pagination, error format, and retention — the cross-cutting details every integration needs.
Read →Overage
What happens when a customer spends past their balance — the three policies, the overage record, and how to reconcile arrears.
Read →Plans & Variants
How a sellable plan is put together — variants, credit grants, and what retiring one actually does.
Read →Plan-Variant Entitlements
How to attach billable metrics to plan variants with type-shaped values, giving each tier different feature access, caps, and configurations.
Read →Subscription Overrides
Give one customer a different entitlement value from the rest of their plan, without building a plan for one person.
Read →Environments & the Shared Catalog
What sandbox and live keep apart, what they share, and why editing a plan in sandbox can change a live customer's bill.
Read →Audit Log
Every mutation, who did it, and what the record looked like before and after — plus the dashboard stats endpoint.
Read →