Skip to main content

Zuora Release 2022.05.R4


Zuora Release 2022.05.R4

This is a preview of our upcoming release. These release notes are a work in-progress and are subject to change. Some of the articles that the release notes link to might not yet be updated for the upcoming release.

Welcome to the release notes for Zuora Release 2022.05.R4. This article is a consolidated page of all release notes for the following Zuora products:

For the latest release notes of Zuora Revenue, see Zuora Revenue release notes.

We welcome and appreciate your feedback on this release notes article. Please use the Feedback button to let us know what you think about the new release notes.

Release schedule

For the planned schedule of upcoming Zuora releases, see Zuora Release Management in Zuora Community.

Join Release Notifications in Zuora Community to receive timely notifications about Zuora Billing, Collect, and Central Platform.

UI enhancement

From this release, the Global Search feature is introduced to Zuora UI by adding a search bar to the UI header. You can use this search bar to help you quickly find what you are looking for. As an initial launch, the Global Search feature can support only the Account, Order, Subscription, Invoice, and Payment objects with the following characteristics:

  • The search bar in the UI header uses a simple lookup search and returns the results that contain or exactly match the search keywords in the searchable fields across all supported objects. For example, if you are looking for a specific account by using the account ID, not only the account but also the related objects such as invoices, orders, subscriptions, and payments will be returned. 

  • The typeahead functionality is used to display recent searches and presents a preview of search results to top hits for easier access. You can directly open the individual UI page from the top hits, or you can open the search results page to get a comprehensive view of everything related to the search. 

  • On the search results page, all results on this page are categorized by the object type. Filtering and sorting functionalities are provided on the search results page to help narrow down the search results. The search results are updated in near real-time upon creation, update, or deletion of objects in most cases. However, sometimes it might take up to one minute. Note that the filter called Payment Applied for the Invoice object is used to filter the invoiced with 100% of payment applied.

The Global Search feature is in the Beta phase and will not be deployed to Production environments until further notice.

Zuora Billing

here_black.png Product Catalog

REST API enhancements for retrieving products or product rate plans

The following API operations have been enhanced to support retrieving products or product rate plans by SKU: 

  • "Retrieve a product": You can now use this API operation to retrieve a specific product by SKU. 
  • "List all product rate plans of a product": You can now use this API operation to list all product rate plans of a specific product by SKU.

here_black.png Usage and Rating

Enhancements to Prepaid with Drawdown

To improve the usability of the Prepaid with Drawdown feature, the following order actions are now supported any time during the term of a subscription:

  • Remove a prepayment product
  • Cancel a prepayment subscription
  • Add a one-time prepayment product
  • Shrink a prepayment subscription

Previously, they were only allowed at the beginning of a validity period during the term of a subscription.

up-arrow.png Back to Table of Contents

Zuora Collect

here_black.png Payments

Creation of Indian recurring mandates through one-time payment flows no longer supports Credit Card payment methods

In accordance with the Reserve Bank of India’s (RBI) regulation for storage of payment system data, the payment transaction data including the credit card information shall be stored in systems located only in India. Hence, we no longer support the storage of credit card data and consequently the one-time payment flows for processing local recurring payments with credit cards in India.

To create Indian recurring mandates, you can implement one-time payment flows through Payment Pages 2.0 for Credit Card Reference Transaction payment methods on the Stripe v2 integration. For more information, see Implement Payment Pages 2.0 to support processing payments in India.

up-arrow.png Back to Table of Contents

Zuora Central Platform

here_black.png Custom Objects

Limitation imposed on precision for decimal values in custom object records

A limitation has been imposed on the precision for decimal values in custom object records. Custom object records support up to 13 digits to the left of the decimal point, and up to 9 digits to the right.

here_black.png Events and Notifications

Custom scheduled events and notifications now available

Custom scheduled events are now introduced as a new event type. You can now trigger notifications by using custom scheduled events, based on the combinations of the key date fields of the objects and the specific count of days before or after the date. For example, you can trigger custom scheduled event notifications such as "3 Days before Term End Date" and "5 Days after Subscription Updated Date."

Enhancement on custom event notifications to provide timezones in date type fields

The custom event notifications now provide timezones in date type fields for consistency with the standard event notifications.

up-arrow.png Back to Table of Contents


For a summary of REST API updates and documentation updates in the Zuora API Reference, see 2022 API Changelog


Current WSDL version: 122

For information about how to check your version and download the latest version. see Zuora WSDL.

SOAP API change history

For a summary of updates made to the SOAP API in recent Zuora releases, see Zuora SOAP API Version History.