Skip to main content

Minimum Commitment


Minimum Commitment

You can use the Minimum Commitment charges to create subscription services that require the customers to consume a minimum amount. The customers will be automatically charged a true-up to meet the minimum commitment if they don't spend enough by the end of the service period. In this case, an invoice item will be generated automatically to collect the difference between the actual consumption and the contracted commitment.

With Minimum Commitment, you can set a competitive price for the services to attract more subscribers and at the same time guarantee a minimum revenue for each subscription.

Minimum Commitment is part of the Advanced Consumption Billing feature. You need to purchase the feature to use it. Contact your Zuora Customer Success Manager for assistance.

Minimum Commitment concepts

To set up a Minimum Commitment subscription service, you need to make sure to include one recurring charge with the Charge Function field set to Commitment True-up, and one or more usage charges with the Credit Commitment checkbox selected.

Refer to the following information to understand the relevant concepts:

  • Commitment True-up charge: Defines the minimum commitment. If the customer doesn't reach the committed amount, this charge will generate an invoice item that will charge the difference between the actual amount and the minimum commitment.
  • Credit Commitment: Defines the unit price and tracks actual usage. Usage records should be uploaded against the Credit Commitment charges. 
  • Commitment Period: The period by the end of which the customer will be charged with a true-up if they fail to spend the minimum amount. The commitment period is defined on the Commitment True-up charge through the Validity Period field. A validity period can contain one or more Billing Periods. See Validity Period for more information.

Example Use Case for Minimum Commitment

The following diagram shows an example use case for Minimum Commitment:

In this example, the customer signed a 1-year contract with a minimum commitment of $12,000. The customer is billed quarterly. As the customer's total spend this year is only $10,000, which doesn't meet the committed amount, a $2,000 true-up charge was generated at the end of the term.

Note that the commitment period can also be set to any period if it is a multiple of the billing period.


The following requirements need to be met before you can use this feature:

  1. Orders or Orders Harmonization should be enabled.
  2. If you are using Orders Harmonization,
    • You must turn on the "Auto-renew by Order" Billing setting.
    • You must use an order to create prepaid with drawdown subscriptions.
  3. If you are using Zuora CPQ, you must turn on the “Enable Order for CPQ” Billing setting.

Supported charge models 

When the Minimum Commitment feature is enabled, the following usage charge models are supported:

  • Per Unit Pricing
  • Tiered Pricing
  • Volume Pricing
  • Tiered with Overage Pricing

Create minimum commitment charges

To create a minimum commitment rate plan, you need to set up a Commitment True-up charge and some Drawdown and Credit Commitment charges. See Minimum Commitment concepts for explanations of how this feature works.

Commitment true-up charge specific settings

A commitment true-up charge must be a recurring charge. Make sure the following fields are specified during the creation of the charge:

  • Charge Function: This field needs to be specified as Commitment True-up.
  • Commitment Type: Currency only.
  • Validity Period: This field specifies the commitment period, during which the customers commit to a minimum spending.
  • Billing Day: This field cannot be set to Default to Customer Account, or a specific day in a month or week.

Credit commitment charge specific settings

A credit commitment charge must be a usage charge. Make sure the following fields are specified during the creation of the charge:

  • Credit Commitment: This checkbox needs to be selected.
  • Commitment Type: Currency only.
  • Billing Day: Cannot be set to Default to Customer Account, or a specific day in a month or week.

Note: You can include more than one credit commitment charge in a minimum commitment product rate plan. If a usage charge is both a drawdown charge and a credit commitment charge, select both the Credit Commitment and Drawdown checkboxes. The prepaid balance will be consumed first.

After creating the product that contains minimum commitment charges, you can set up integrations to use Orders to create subscriptions in Zuora whenever a customer subscribes.

Upload usage records for the usage charges

To track the usage of minimum commitment subscriptions, you need to upload the usage records to the corresponding usage charges.

See Import Usage Data for how to upload usage records.

You can use Unbilled Usage to view usage records and rating results before charges are billed.

Generate invoices for minimum commitment subscriptions

For minimum commitment subscriptions, when billing at the end of a commitment period, Zuora will compare the total usage of the period with the commitment amount. 

If the customer didn't spend the committed amount, a true-up invoice item would be generated to collect the difference between actual usage and the committed amount.

If the customer spent more than the committed amount, Zuora would generate invoices that collect the actual amount.

If you are not familiar with billing at Zuora, see Bill your customers for more information about how to bill and generate invoices.

Cancel minimum commitment subscriptions

When canceling a minimum commitment subscription,  if the validity period is equal to the subscription term, Zuora will check and generate the true-up amount based on the consumed usage

If the validity period is not the same as the subscription term, canceling is not allowed.

Top up commitment subscriptions

You can increase the minimum commitment by adding an additional committed amount. This can be done by adding new commitment charges to the relevant rate plans. Both one-time and recurring charges can be added as commitment increases.

Notes and limitations

The following notes and limitations apply when using the Minimum Commitment feature:

  • When setting up the commitment charges in Product Catalog:
    • Only recurring charges are supported. One-time charges cannot be used as commitment charges.
    • Billing Day cannot be set to Default to Customer Account, or a specific day in a month or week. This is to prevent a mis-match between billing and validity periods, which could make tracking difficult. 
    • Billing Timing can only be In Arrears.
    • Billing Period and Validity Period of the recurring commitment charge must be set to the same length.
    • Credit Option is set to Consumption Based by default and cannot be changed.
    • List Price Base cannot be set to Week, as a week doesn’t evenly multiply into most Billing Periods.
    • Deferred Revenue G/L account should be maintained the same for commitment charges and usage charges.
  • When using Orders to create and manage minimum commitment subscriptions:
    • Cannot create a prepayment charge & a commitment charge
    • Cannot remove/cancel/change a commitment charge if validity period is not sub term
    • The Suspend and Resume actions are not supported.
    • Evergreen subscriptions are not supported.
    • If the commitment charge's validity period is set to Subscription Term, List Price Base must be Per Billing Period.
  • For minimum commitment subscriptions: Subscription preview is not accurate as it doesn't contain the true-up information.