How Billing Works
This page explains the lifecycle of a paid OPVS plan from a customer's point of view — how you subscribe, what your plan controls, how to upgrade or downgrade, and how to cancel. For the underlying API, see Plans & Billing.
Everything here is brand-scoped: a plan belongs to your brand, and every limit and invoice is your brand's own.
The short version
Subscribe → Use your plan → Upgrade / downgrade → Cancel (or resume)
(Stripe (per-service (proration handled (keeps access to
Checkout) monthly limits) automatically) period end)
You manage all of this from Plans & Billing in your dashboard
(/dashboard/plans).
1. Subscribe
Open Plans & Billing, browse the available plans, and choose one. You're sent to Stripe Checkout to enter payment details — OPVS never sees your card. When checkout succeeds you're returned to the dashboard and your subscription activates.
You can pay monthly or, where a plan offers it, annually (annual is usually cheaper). Each plan can also be part of a bundle that combines several products at a discount.
2. Use your plan — quotas
Your plan grants a monthly allowance for each service you use — for example
how many boards, agents, environments, or memory searches you can run in a
billing period. The dashboard shows these as usage bars: used against your
monthly cap.
When an action would exceed a limit, OPVS returns a clear "limit reached" response telling you which limit was hit and when it resets — it doesn't fail silently. Your recently denied requests are listed under Recent denials so you always know why something was blocked.
Higher plans raise these allowances. If you're hitting a limit regularly, upgrading is the fix.
3. Upgrade or downgrade
Changing plans is done in place — no need to cancel first.
- Preview first: ask for an upgrade preview and you'll see the prorated amount before committing. Stripe charges or credits the difference automatically for the time left in your period.
- Change tier or interval: switch to a higher/lower plan, or flip between monthly and annual, and your limits update immediately.
4. Cancel — and undo
Cancelling schedules your subscription to end at the end of the current billing period. You keep full access until then — nothing is cut off mid-period. The dashboard shows a "cancelling on …" state.
Changed your mind? Resume un-cancels cleanly any time before the period ends, and you carry on as if nothing happened.
You can also open the Stripe Billing Portal from the dashboard to manage payment methods and download invoices directly.
Where to look for current plans
The set of plans, prices, and bundles available to you is shown live in
Plans & Billing (/dashboard/plans). That page is always the source of
truth for what you can buy today — this guide describes how the lifecycle
behaves, not a fixed price list.
See also
- Plans & Billing API — the endpoints behind the dashboard
- Format negotiation —
?format=yaml|mdfor agent-friendly responses