Skip to main content

Zuora Release 2023.05.R2


Zuora Release 2023.05.R2

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.

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, Payments, and Central Platform.

Zuora Billing

The Zuora Billing features and enhancements will be deployed to Production environments no earlier than 8 June 2023.

here_black.png Invoicing and Tax

Flexible Billing Attributes feature generally available

The Flexible Billing Attributes feature is now generally available. If you want to access this feature, submit a request at Zuora Global Support.

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.

up-arrow.png Back to Table of Contents

here_black.png 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 TCVTODAY'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.

up-arrow.png Back to Table of Contents

Zuora Payments

The Zuora Payments features and enhancements will be deployed to Production environments no earlier than 8 June 2023.

here_black.png Payments

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 email field in any of the following REST API operations to pass email to the gateway and map to shopperEmail:

Previously, you could only use the gatewayOptions field in Create a payment method or Create a payment to pass shopperEmail to Adyen.

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.

up-arrow.png Back to Table of Contents

Zuora Central Platform

Zuora Central Platform has only internal enhancements and resolved issues in this release.​​​​

up-arrow.png Back to Table of Contents


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:

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.

Quickstart API 

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.