Skip to main content

Zuora Release 2022.05.R4


Zuora Release 2022.05.R4

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

here_black.png Global Search

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 Central Sandbox and 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: 

here_black.png Orders and Subscriptions

New field in Subscription data source to indicate related ramp

The Ramp ID field is now available in the Subscription data source to indicate the ramp that is related to the subscription. This field is only available if you have enabled the Ramps feature.

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:

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."

See Custom Scheduled Events for more information.

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.