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
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.
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.
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.
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.
Zuora Collect
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:
- Checkout.com
- Ingenico ePayments
- Stripe v2
For more information, see Support for stored credential transactions overview.
Support for passing indicator of requesting 3DS2 challenge to Checkout.com
We have enhanced our Checkout.com 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 Checkout.com 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 Checkout.com 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 |
UNKNOWN_ERROR |
REQUEST_REJECTED |
|
Specify an inactive account ID for the |
UNKNOWN_ERROR |
INVALID_VALUE |
|
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 |
UNKNOWN_ERROR |
REQUEST_REJECTED |
If you have any questions about compatibility with this update, submit a request at Zuora Global Support.
Zuora Central Platform
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.
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 |
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.
REST API
For a summary of REST API updates and documentation updates in the Zuora API Reference, see 2022 API Changelog.
SOAP API
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.