How minimum commitments work
A minimum commitment guarantees a floor of revenue per period: if a customer’s usage-based charges fall below the committed amount, Recurso true-ups the difference on the invoice. Above it, they simply pay for what they used.Concept detail: Commitments. Pairs with
usage-based billing.
Prerequisites
- An API key for the API call below, or dashboard access.
- An existing subscription, typically with usage-based charges — the commitment sets its per-period floor.
Step 1: Set the commitment on the subscription
In the dashboard, open the subscription’s billing panel and set Commitment (the per-period minimum, in your currency); or via the API:Step 2: Let the true-up run at period close
At the end of each period, if metered + fixed charges are below the commitment, a true-up line brings the invoice up to the committed minimum. Above it, no true-up is added.Verify your setup
1
The commitment is set
The subscription shows its per-period minimum.
2
Low usage trues up
A period with usage below the commitment invoices at the committed amount, with
a true-up line.
3
High usage doesn't
A period above the commitment bills actual usage, no true-up.