Skip to main content

Zuora Release 2022.07.R2


Zuora Release 2022.07.R2

Welcome to the release notes for Zuora Release 2022.07.R2. 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 release schedule details, see this release notification.

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

Restyled UI rolled out to all users by default

The Restyled UI has been an opt-out feature until now, which means you can choose to disable the restyled UI experience in favor of the legacy UI. The restyled UI has been generally available in Production environments for several months. Now, we are ready to make it the default UI experience for all users. Meanwhile, we are going to sunset the legacy UI from all environments in the next few months. The user-level setting called New Style, which is used to switch between legacy UI and restyled UI, is deprecated in this release. If you still want to revert to the legacy UI during this transition period, please contact Zuora Global Support. After the transition is done, the legacy UI is no longer available.

We continue to make progress in revamping and enhancing the user experience of Zuora's applications. In the past few months, these new UI experiences, such as Reinvented list views and Global Search, have been built and delivered to Sandbox environments and remain under active development as we continuously make improvements based on your feedback. A new user-level setting called Enable New Zuora Experience is introduced to the user profile, which can be used to enable or disable these new enhancements and functionalities. You can revert to the restyled UI without these new enhancements and functionalities by clearing this setting.

For UI enhancements that are introduced to a specific product, refer to the product sections below.

Zuora Billing

here_black.png Product Catalog

Resolved: Formula Injection vulnerability issue when exporting product data

Previously, Formula Injection vulnerability existed when you exported product data files in Excel (.xls) by clicking the more options icon icon-more-options.png and then clicking Export this product on the product details page through the Zuora UI.

The Formula Injection vulnerability has now been resolved. If you export a product data file using the abovementioned method, some fields in the exported data might now begin with an apostrophe character ('). 

For more information, see Notes and limitations in data exports.

here_black.png Orders and Subscriptions

New REST API operation for deleting subscription

A REST API operation called "Delete a subscription by number" is now available. You can use this operation to delete a subscription of the specified subscription number.

New field on Subscription object to indicate the latest version

The isLatestVersion field is now available on the Subscription object to indicate whether the current subscription object is the latest version.

The Zuora API, data source, and data query have been enhanced to support this field.

Enhancement to lastBookingDate field on Subscription object

The lastBookingDate field is now made writable on the Subscription object. Previously, this was a read-only field.

The field is available as lastBookingDate in the data source, data query, and all the GET subscription REST and SOAP API. This field is available asBookingDate in the subscription creation UI (non-orders), the value from which is stored in the lastBookingDate field. Both the Booking Date and lastBookingDate fields map to the lastBookingDate field on the subscription object.

The field has the following limitations:

  • This field is writable only when the subscription is newly created as a first version subscription.
  • You can override the date value when creating a subscription through the Subscribe and Amend API or the subscription creation UI (non-Orders). Otherwise, the default value today is set per the user’s timezone.

For example, a new subscription version A1 is generated when the first subscription version A is modified. Version A’s lastBookingDate remains the same, while A1’s lastBookingDate will be either the Amendment.bookingDate or Order.orderDate.

New fields on Rate Plan and Rate Plan Charge objects

The following fields are now available on the Rate Plan object:

  • Subscription Owner Id: the subscription owner ID of the subscription that contains the rate plan
  • Invoice Owner Id: the invoice owner ID of the subscription that contains the rate plan

The following fields are now available on the Rate Plan Charge object:

  • Subscription Id: the ID of the subscription that contains the rate plan charge
  • Subscription Owner Id: the subscription owner ID of the subscription that contains the rate plan charge
  • Invoice Owner Id: the invoice owner ID of the subscription that contains the rate plan charge

The Rate Plan data source, Rate Plan Charge data source, and SOAP API have been enhanced to support these fields.

here_black.png Usage and Rating

Support for adding recurring prepayment charges to subscriptions at any time

You can now add recurring prepayment charges to subscriptions anytime. Previously, you could only add a recurring prepayment charge at the beginning of a validity period. This enhancement enables your customers to purchase recurring prepaid products whenever they want.

In order for a recurring prepayment charge to be able to be added to a subscription at any time, you must configure the following fields:

  • Select Term Start Date from the Billing Day list.
  • Select Align to Term Start from the Billing Period Alignment list.

If you use the “CRUD: Create a product rate plan charge” REST API or the “Create ()” SOAP API to create recurring prepayment charges, make sure to set the BillCycleType field to TermStartDate and the BillingPeriodAlignment field to AlignToTermStart in the request body.

Note the following behaviors of the recurring prepayment charges that are added in the middle of a validity period:

  • The Start Date of the newly added fund is the Effective Date of the charge.
  • There is no proration for the first partial billing period, which means the charge amount of the first partial billing period should be the same as that of a full billing period.
  • Recurring prepayment charges cannot be added to a shrunk subscription term.

The Prepaid with Drawdown feature is in the Early Adopter phase. If you want to join this early adopter program, submit a request at Zuora Global Support.

here_black.png Invoicing and Tax

REST API enhancements for object key support

The following API operations have been enhanced to support managing billing documents, taxation items, and invoices by object numbers: 

Previously, these API operations only supported object IDs.

Enhancements to Sum function

The Sum function has been enhanced to support a list of numeric text inputs in HTML templates

Previously, this function only supported a list of numeric inputs.

here_black.png Zuora CPQ

Zuora Quotes 

The latest Zuora Quotes version is 10.8.

For the latest changes of Zuora Quotes, see Zuora Quotes version 10 release notes.

up-arrow.png Back to Table of Contents

Zuora Collect

here_black.png Payments

Deprecation of Hosted Payment Method Pages 1.0

Hosted Payment Method Pages (HPM) 1.0 will be deprecated on July 15th, 2022 PDT. Starting from July 15th, payment pages and components implemented through HPM 1.0 will not work, such as HPM 1.0 pages, Checkout Pages, and CPQ components built on HPM 1.0. We will not provide support for any issues with HPM 1.0 and components or pages built on HPM 1.0. Payment Pages 2.0 are the replacement for HPM 1.0.

To get to know the version of a payment page in Zuora, navigate to Settings > Payments > Setup Hosted Pages, and the version information is available in the Page List section. A tooltip is also available next to the page name to indicate the version 1.0 page and the action to take.

If you have any questions about HPM 1.0, submit a request at Zuora Global Support.

Opayo Direct gateway integration available

A new gateway integration called Opayo Direct is now available in Zuora. It integrates with the Elavon Opayo Direct API to provide the following payment operations for credit card payment methods:

  • Payment method validation
  • Payment
  • Payment void
  • Referenced refund

The Opayo Direct gateway integration also supports 3D Secure 2.0 and stored credential transactions.

This feature is in Limited Availability. If you want to have access to the feature, submit a request at Zuora Global Support.

For more information, see Opayo Direct Gateway.

Support for processing MOTO payment transactions on BlueSnap

We have enhanced our BlueSnap gateway integration to support processing Mail Order Telephone Order (MOTO) payment transactions with Credit Card payment methods. You can pass the MOTO payment indicator to the gateway through either of the following methods:

  • Select MOTO for the newly introduced setting called Transaction Order Source on the gateway setting page.
  • Specify the newly supported TransactionOrderSource gateway option field through APIs or the client parameter of Payment Pages 2.0.

For more information, see Transaction Order Source configuration field and Supported gateway option fields for BlueSnap gateway integration.

REST API enhancements for payment run and refund management 

The following API operations have been enhanced to support retrieving and managing payment runs by using either the payment run number or payment run ID:

The following API operations have been enhanced to support retrieving and managing refunds by using either the refund number or refund id:

Previously, you could only specify payment runs or refunds in the above operations using the payment run ID or the refund ID.

Increased the maximum number of reason codes for the supported payment transaction types

We have increased the number of the reason codes you can define for a supported payment transaction type from 200 to 300. You can now create up to 300 reason codes for the following payment transaction types:

  • Payment Refund
  • Credit Balance Refund
  • Invoice Item Adjustment
  • Invoice Adjustment
  • Credit Memo
  • Debit Memo
  • Credit Memo Refund

up-arrow.png Back to Table of Contents

Zuora Central Platform

here_black.png Central Sandbox

Refresh or reset of testing configurations is deprecated

To prevent overwriting any testing configurations you have enabled, we no longer refresh or reset the following previously configured settings in Central Sandbox:

  • Notifications (callout credentials-username/password)

here_black.png Custom Objects

Support for specifying unique constraints on custom fields

You can now create custom fields with unique constraints for custom objects to store unique values such as unique identifiers or names. Note that unique constraints apply only to filterable custom fields.

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: 124

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.