Design and operate commerce
Connect plans, measurement, pricing, funding, admission and subscriber release pins.
Commerce connects measurements to customer obligations. Keep the plan's access grants, structural bounds and monetary controls distinct; they answer different questions.
Define the commercial model
Choose a declared plan kind: free, flat, usage, prepaid, hybrid, trial or custom. Define measurements with measures and dimensions, attach meters to routes, and connect a pricing catalog. Catalogs contain exact rates, selectors, tiers and modifiers. A backend reports measured values through its verified context; the platform rates them.
Funding buckets pay rated usage from included, prepaid, promotional or referral value. Exhaustion policy either blocks or selects an overage binding. Monetary admission bounds work before the gateway forwards it. A displayed allowance is not permission to bypass admission.
Use economic agreements for negotiated subscription terms. Checkout promo codes are operational customer offers; they are distinct from repository-defined funding buckets.
Change a live offering
Inspect the semantic diff and commercial release. A release is immutable; subscriptions retain their served commercial identity and pricing binding. Read plan transitions before promising a migration. The operation catalog states which migration operations are actually available.
Test a free path, a funded path, exhaustion, an upgrade and an existing subscriber on an older pin. Use the same environment when comparing results. Publish the reviewed artifact through the release workflow.
Read and explain money
Use the bill preview for customer usage money. Honor transparent versus opaque disclosure and unavailable values. Do not calculate a bill in the browser by multiplying usage counts by a current price: pins, funding, modifiers and corrections can change the result.
When numbers disagree, follow billing diagnosis and ledger and settlement. Preserve request, subscription and release identifiers. An admission reservation, measured usage, a rated ledger entry and Stripe settlement represent different stages.