This page explains the concepts. To turn it on step by step, follow the commitments setup guide.
Minimum commitments and true-ups
A commitment is a per-period minimum, in minor units, on a subscription. At period close, if the invoice subtotal — flat fee + add-ons + metered usage — falls short of the floor, Recurso adds a “Minimum commitment true-up” line for exactly the difference, taxed at the plan’s HSN like the base fee. Usage beyond the floor simply bills normally: overage needs no configuration. This is the standard shape for sales-led contracts: “₹50,000/month minimum, usage-based above that.”Set a commitment
0 clears the commitment.
What the invoice looks like
With a ₹10,000 flat plan, ₹22,000 of metered usage, and a ₹50,000 commitment:
At or above the commitment, no true-up line appears — an invoice never
bills more than max(actual, commitment) plus tax.
Preview the projected true-up
GET /v1/subscriptions/{id}/usage-amount includes the commitment fields
mid-period:
projected_true_up is what the true-up would be if the period closed now
— it shrinks toward zero as usage grows.
Boundary semantics are exact and covered by tests: a subtotal exactly at
the commitment adds nothing; one paisa below adds a one-paisa true-up.
Next steps
Usage-based billing
The metering these commitments apply to
Set up commitments
Step-by-step configuration