How Valqio works
The hosted control plane and data plane that let your app decide before billable work runs.
Valqio has two public surfaces: Console for configuring how your product should be monetized, and the runtime data plane for answering decisions from your application.
The hosted path
- Model product actions, meters, limits, credits, plans, customers, and environments in Console.
- Publish the runtime configuration for the environment your app uses.
- Install the SDK package from npm in your server application.
- Create a runtime client from the API key, project, environment, and hosted data plane URL shown in Console.
- Call Valqio before the product action runs.
- Run the work only when Valqio allows it.
- Inspect the decision evidence in Console.
What runs where
| Surface | Purpose | Public developer responsibility |
|---|---|---|
| Console | Configure monetization rules and inspect outcomes. | Model the product action, publish changes, create API keys, and review evidence. |
| SDK | Add Valqio to app code. | Bind the subject, send request identity, call the action or runtime method, and handle allow or deny results. |
| Data plane | Answer runtime decisions from the published environment state. | Send server-side runtime calls using the hosted URL and a server runtime key. |
| Billing provider | Invoice and collect payment. | Keep billing sync configured if invoice or finance systems need usage outcomes. |
Valqio manages the transaction lifecycle around usage. Your app still owns the actual product work, local database writes, user experience, and error handling.
Mental model
A product action is the thing your app wants to do: generate text, export a report, render media, call a marketplace API, invite a seat, or write storage.
Before that work starts, ask Valqio:
Can customer workspace_acme run generation-runs once for request req_123?Valqio returns a runtime decision. If the decision allows the action, your app runs the work. If it denies the action, your app returns the right product response, such as a quota message, payment prompt, or upgrade path.
What Valqio replaces
Teams usually build this themselves:
- usage counters and windows
- credit balances and quota checks
- reservation records for async work
- retry and idempotency handling
- allow and deny reason logs
- support evidence for customer questions
- finance evidence for billing sync and audits
Valqio provides that runtime monetization infrastructure as a hosted service.