Skip to main content

Zuora Release 2022.04.R4


Zuora Release 2022.04.R4

Welcome to the release notes for Zuora Release 2022.04.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 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

From this release, a new survey widget is introduced to replace the previous NPS survey, which was presented on the homepage banner in the Zuora application. The new survey widget will display for randomly selected users after the user logs in to Zuora. Use this new survey widget to provide feedback about Zuora products without navigating away from the current UI page.

Zuora Billing

here_black.png Orders and Subscriptions

Behavior change in Flexible Billing feature

We have made a change in the Flexible Billing feature. We have disabled the ability to directly update the bill-to contact and payment term for a subscription through the Subscription details page or the Update a subscription API operation. You must only update the two billing attributes through the Orders UI or API in a Terms & Conditions order action or Renewal order action. Previously, you could also update the two billing attributes through the Subscription details page or the "Update a subscription" API operation.

here_black.png Usage and Rating

New field in Prepaid Balance Fund data source

A field called Consumption Amount is now available in the Prepaid Balance Fund data source. If you use the Prepaid with Drawdown feature, this field helps you determine how much revenue to recognize while your subscribers consume their prepaid units.

here_black.png Invoicing and Tax

Support for posting invoices through REST API

You can now use a new API operation called Post invoices to post a maximum of 50 invoices in one single request. Additionally, you can also update invoice dates while posting the invoices.

New objects in Invoice Item Adjustment data source

The following objects are now available in the Invoice Item Adjustment data source: 

  • Bill To Contact Snapshot
  • Sold To Contact Snapshot

To have values for both objects, you must set the Preserve snapshot of bill-to and sold-to contacts when billing documents are posted? billing rule to Yes.

here_black.png Zuora CPQ

Zuora Quotes 

The latest Zuora Quotes version is 10.5.

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

up-arrow.png Back to Table of Contents

Zuora Collect

here_black.png Payments

General availability of support for Google reCAPTCHA Enterprise Interactive Test mode for Payment Pages 2.0

The support for Google reCAPTCHA Enterprise Interactive Test mode for Payment Pages 2.0 is now generally available to all Zuora customers. Previously, you had to submit a request at Zuora Global Support to enable this feature.

Support for self-configuration of Google reCAPTCHA Enterprise checkbox site key

We now support using Google reCAPTCHA Enterprise Interactive Test mode with your own Google Cloud Enterprise account. When configuring the tenant-level Hosted Pages settings, you can configure your own account credentials, including Enterprise Checkbox Site Key, Google Cloud API Key, and Google Cloud Project ID. Previously, only Zuora’s Google Cloud Enterprise account for the checkbox-based interactive test can be used.

For more information, see Configure Payment Pages 2.0.

Enhancements on stored credential transaction support for multiple payment gateway integrations

We have expanded the support for stored credential transactions for different card brands on the following payment gateway integrations:

  • Ingenico ePayments
  • Stripe v2

For more information, see Support for stored credential transactions overview.

Support for passing indicator of requesting 3DS2 challenge to

We have enhanced our gateway integration to support passing the indicator of requesting a cardholder challenge to the gateway. A new setting called 3DS Challenge Indicator is now available on the gateway setting page for the ​​ integration. You can select one of the following indicator options to indicate your preference for whether or not a 3DS challenge should be performed.

  • Challenge Requested
  • Challenge Requested Mandate
  • No Challenge Requested
  • No Preference

For more information, see Payment Gateway.

Support for account holder names with ampersand characters for ACH transactions through CyberSource 2.0

We have enhanced the CyberSource v2.0 gateway integration to support passing in account holder names containing the ampersand (&) characters for ACH transactions. For more information, see Field mappings between Zuora and CyberSource.

Enhancements on error codes in API responses

We have enhanced the error codes and messages to be more effective for unknown errors that occur in the following scenarios:

API Operation Scenario Previous error code Current error code
Apply the payment to unposted invoices.  UNKNOWN_ERROR REQUEST_REJECTED

Specify a non-electronic payment method for the PaymentMethodId field.


Specify an inactive account ID for the AccountId field.

Specify a negative value for the Amount field. UNKNOWN_ERROR REQUEST_REJECTED
The Payment object with the create() call Specify null for the PaymentMethodId field. UNKNOWN_ERROR


Note that this update only applies to WSDL version 121 or later versions.

Generate a credit memo PDF file Specify an invalid value for the creditMemoId field. 50000060 50000040

Specify a date for the RefundDate field which is earlier than the date when the payment was applied.


If you have any questions about compatibility with this update, submit a request at Zuora Global Support.

up-arrow.png Back to Table of Contents

Zuora Central Platform

here_black.png Custom Objects

Increased maximum length limit for text fields of custom objects

The maximum length limit for text fields of custom objects is now increased to 8,192 characters. Previously, the limit was 4,096 characters.

here_black.png Events and Notifications

Support for resending notifications through API with partial success responses

After resending notifications through the following API operations, if one or more notifications are resent successfully, you can now receive 202 Accepted HTTP responses with the error code and error message of each failed notification:

Details about the responses of these API operations are as follows:

Scenario Status code Response content
Success for all notifications 202 Accepted (blank)
Success for at least one notification 202 Accepted Error code and error message of each failed notification
Failure for all notifications 400 Bad Request Error code and error message of each failed notification

here_black.png Workflow

Support for modifying active workflow versions

You can now modify the settings of active workflow versions directly without having to create an inactive version first. Except for the Version Details field and the Mapped Input Fields and Params section, all fields in the Setting tab of an active version can be updated.

Note that in Mapped Input Fields and Params, the Default values that can be input on prompt during manual execution of the active versions can still be modified.

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

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.