Usage-based billing
Overview
With usage-based billing, you charge for what your customers actually consume – API calls, storage, working hours or any other unit. Kyvento collects the usage per billing period and bills it automatically with the next invoice.
Product prerequisites
- Select a quantity-based pricing model: "Per unit", "Tiered" or "Volume-based".
- Define the "Quantity aggregation" – how multiple reports within a period are combined:
- Sum – all reports are added up (e.g. API calls consumed)
- Maximum – the peak value counts (e.g. maximum number of users)
- Last value – the most recent meter reading counts (e.g. storage in use)
Reporting usage
- Automatically via the API – your system reports usage via
POST /api/v1/usage-data(including retroactively). You'll find details and examples in the API documentation. - Manually – on the subscription detail page, the "Usage" tab, via "Record usage manually". With the "Sum" aggregation, you correct incorrect entries using "Record correction" (an offsetting entry).
Billing the usage
All open usage in a period automatically flows as a line item into the next regular subscription invoice. The usage history shows each entry with its status – Open, Billed (with an invoice reference) or Cancelled. For immediate interim billing, use "Bill usage now".
Special case: cancellation
For an immediate cancellation with open usage, you decide in the dialog: "Create a final invoice, then cancel" or "Discard usage and cancel immediately" – so that no revenue is accidentally lost.
Transparency for the customer
In the customer portal, the end customer can view their reported usage, provided you have enabled the "View usage" portal permission.
Next steps
- Choosing the right price tiers – see "Pricing models: monthly, yearly, usage-based"
- Set up API access – see "Creating and managing API tokens"