home

Zuora Billing

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Billing

Overage smoothing pricing

Allowed changes when amending subscriptions

You can amend subscription rate plan charges by changing the Included Units and Number of Periods options, with specific conditions for Zuora user interface and SOAP API usage.

You can only change the Included Units and Number of Periods options on a rate plan charge from either the Zuora user interface or through SOAP API with the following conditions:

  • You are making an Add Product or Update Product amendment.

  • The product includes a Usage Charge of the Overage Pricing charge model.

  • For the Zuora SOAP API, you can only change IncludedUnits and NumberOfPeriods with a single create() or amend() call. You cannot change the options when using an update() call.

Note:

You must be on WSDL version 54.0 or higher to use this SOAP feature. See Zuora WSDL for information about downloading the current version.

For the Rolling Window model, the following table describes the additional changes allowed on subscription amendments.

Overage Option when Smoothing

New Product Amendment

Update Product Amendment

Apply overage as soon as it occurs

Can override both Number of Periods and Included Units

Cannot override Number of Periods or Included Units

Apply overage at the end of smoothing period

Can override both Number of Periods and Included Units

Can override both Number of Periods and Included Units

Last updated: October 10, 2025