Welcome to the release notes for Zuora Release 2023.05.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.
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, Payments, and Central Platform.
The Zuora Billing features and enhancements will be deployed to Production environments no earlier than 8 June 2023.
Invoicing and Tax
Flexible Billing Attributes feature generally available
This feature provides you the flexibility to manage billing, taxation, and payment at a more granular level other than the account level.
- Flexible subscription management provides you the capability to have different bill-to contacts, sold-to contacts, payment terms, invoice templates, and sequence sets for subscriptions.
- Flexible invoicing provides you the capability to bill subscriptions according to the same billing attributes.
Sold To Contact available at subscription level through Zuora UI
When creating a subscription through the Zuora UI, you can now specify a sold-to contact in the Sold To Contact field in the Billing and Payment section. Additionally, you can view related contact information from the Sold To field in the Billing & Payment subsection of the Basic Information section on the subscription details page.
The Flexible Billing Attributes feature now provides you the capability to have different sold-to contacts for subscriptions through the Zuora UI, while REST API support has been available since the 2023.04.R1 release in April. Therefore, you can sell products and services with different tax addresses for different subscriptions in the same order.
Orders and Subscriptions
Support for viewing offer information on subscription details page
Previously, to retrieve information about the offers and the included product rate plans and charges after adding offers to subscriptions through the Create an order API operation, you could only view the information through API operations, for example, Retrieve a subscription by key.
You can now view the information on the subscription details pages.
- If the Enable New Zuora Experience is checked in Profile > Manage Your Profile, the information about the offers, nested product rate plans, and charges is displayed in the Included Products > Offers section. For more information, see View details of subscriptions through the reinvented UI.
- If the Enable New Zuora Experience is unchecked, the information about the nested product rate plans and charges is displayed in the Product & Charges section. For more information, see View subscriptions.
Metrics enhancements on reinvented subscription details page
We have enhanced metrics sections on the reinvented subscription details page as follows:
- Add a new CMRR section.
- Rename the Current MRR section to TODAY'S MRR.
- Display Gross and Net values in the TCV, TODAY'S MRR, and ENDING MRR sections, and only display Gross value in the CMRR section.
For more information, see View details of subscriptions through the reinvented UI.
The Zuora Payments features and enhancements will be deployed to Production environments no earlier than 8 June 2023.
Update in integration endpoint for Helix
We have updated the production endpoint for the Helix payment gateway integration:
For more information about the Helix payment gateway integration, see Helix payment gateway.
ANB payment gateway integration available
A new payment gateway integration called ANB is now available in Zuora. It integrates with Mastercard Payment Gateway Services to handle credit card reference transactions in Saudi Riyal currency, in compliance with the regulations for processing transactions in the Kingdom of Saudi Arabia.
This feature is in the Early Adopter phase. We are actively soliciting feedback from a small set of early adopters.
For more information about the ANB payment gateway integration, see ANB payment gateway.
Enhancement in passing emails to Adyen when creating Apple Pay or Google Pay payment methods with REST APIs
When creating Apple Pay or Google Pay payment methods on Adyen v2.0, you can now use the
General availability of Moneris payment gateway integration
A payment gateway integration called Moneris is now generally available to all Zuora customers. It supports payment processing for Credit Card and Credit Card Reference Transactions payment methods. It also supports stored credential transactions.
Previously, you had to submit a request at Zuora Global Support to enable this payment gateway integration.
For more information, see Overview of Moneris payment gateway integration.
Support for passing device ID information to Braintree
On the Braintree gateway integration, you can now pass the device ID information to the Braintree gateway by using the Gateway Options field through Payment Pages 2.0 or the Create a payment REST API operation.
For more information, see Overview of Braintree gateway integration.
Support for passing in Stripe Radar session ID
For Credit Card and Credit Card Reference transactions on the Stripe v2 payment gateway integration, you can now pass the Stripe Radar session ID to the gateway through the
gatewayOptions field of the Create a payment API operation.
For more information, see Overview of Stripe payment gateway integration.
Zuora Central Platform
Zuora Central Platform has only internal enhancements and resolved issues in this release.
For the detailed API documentation, see API Reference.
For a summary of REST API updates and documentation updates in the Zuora API Reference, see 2023 API Changelog.
HTTP response status code change for the Delete action and DELETE calls to CRUD operations
In line with REST API best practices, we have introduced an HTTP status code change to the following operations:
- The DELETE calls made to CRUD operations ( operations with the
/v1/object/*endpoint), such as CRUD: Delete a contact
- The Delete action
If you use the preceding operations to delete an object with an invalid ID, the 200 HTTP status code is now returned because the result of getting an object deleted has been achieved and DELETE calls should be idempotent by nature.
Previously, the 400 HTTP response code was returned for this case.
The change is currently live in Sandbox and Central Sandbox environments. It will be deployed to Production environments no earlier than 3 June 2023.
From 2022.09.R1, the Quickstart API is available to you if you have the Orders (or Order Harmonization) and Invoice Settlement features enabled in your tenant. The QuickstartAPI allows new integrators to swiftly integrate with Zuora, and it supports essential business use cases.
For the detailed Quickstart API documentation, see Quickstart API Reference.
For a summary of REST API updates and documentation updates in the Quickstart API Reference, see Quickstart API Changelog.
Current WSDL version: 133
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.