Skip to main content

March 2018 Release Notes


March 2018 Release Notes

Welcome to the release notes for the Zuora March 2018 Release, R222. This release includes new Zuora features, enhancements, resolved issues, and improvements to the Knowledge Center.

For more information about the current product version, see Product Versions and Release Dates.

Release Schedule

The schedule for R222 deployment.

 The release dates are subject to change.


  • APISandbox Release Date: March 16, 2018
  • Production Release Date: March 21, 2018


  • APISandbox Release Date: March 28, 2018
  • Production Release Date: March 28, 2018


  • APISandbox Release Date: April 4, 2018
  • Production Release Date: April 5, 2018


  • APISandbox Release Date: April 9, 2018
  • Production Release Date: April 10, 2018


  • APISandbox Release Date: April 11, 2018
  • Production Release Date: April 11, 2018


  • Enhancements to Order Metrics
  • Subscription Management Using Orders UI 


See API Changelog for a summary of REST API updates and documentation updates in the API Reference.


Enhancements to Order Metrics

This feature is only available if you have the Order Metrics feature enabled. As of Zuora Billing Release 284, Orders is generally available and the Order Metrics feature is no longer available as a standalone feature. If you are an existing Subscribe and Amend customer and want Order Metrics only, you must turn on Orders Harmonization. Join the Orders Harmonization Community group for more information. You can still keep the existing Subscribe and Amend API integrations to create and manage subscriptions. 

Order Metrics has been enhanced to support revenue recognition via the new ELP feature (in the calculation of standalone selling price) and via the new Order Item feature (in the calculation of performance obligations and allocations). See more information in Orders Object Model.

The following new data sources are now available:

Additionally, two new fields called Generated Reason and Order Item ID are added to the following data sources:

If you have the Order Metrics feature enabled prior to March 2018, you can submit a request at Zuora Global Support to migrate the Order Metrics to the latest version.

Subscription Management Using Orders UI

If you are an existing Zuora Subscribe and Amend customer, we recommend you enable Orders Harmonization to access the Orders feature. With Orders, you can access both existing functions for subscription and billing management and the new features on Zuora Billing.

Zuora now provides the capability to manage subscriptions in Orders UI. The following types of order actions are supported:

  • Create Subscription
  • Terms And Conditions
  • Renewal
  • Cancellation
  • Owner Transfer
  • Add Product
  • Update Product
  • Remove Product

See Orders Tutorials for more information.


Support for ACH Non-Referenced Refund for Merchant e-Solutions

Previously, Zuora did not support non-referenced refund operations for the Merchant e-Solutions payment gateway. From this release, you can leverage the non-referenced refund operations for ACH payment methods for the Merchant e-Solutions payment gateway. A new option is available in the gateway instance setting page, which allows you to select the SEC code to use for the non-referenced refund transactions. See Merchant e-Solutions Payment Gateway for more information.

Support for Credit Card Non-Referenced Refund for

Previously, Zuora did not support credit balance refund or non-referenced refund operations for the payment gateway. From this release, you can create non-referenced refunds using credit cards for the gateway in Zuora. You must turn on the Expanded Credit-Return Capabilities on the gateway side to use this feature. See Gateway for more information.

PMU Batch Notification Email Enhancement

In this release, Zuora enhances the Payment Method Updater (PMU) Batch notification email feature. You can configure the following fields in the email template for the Payment Method Updater Batch Completed event:

  • Status
  • Submit Response Message
  • Retrieve Response Message

With these fields configured, you can see the PMU batch processing status and response message in the notification email. This enhancement gives you the capability to monitor your PMU batch processing status and to keep failures in sight. See Monitor Payment Method Updater Batch for more information.

New Setting to Avoid AVS Field Overflow

In this release, Zuora provides a new field in the Chase Paymentech Orbital Gateway instance setting page. With this field selected, Zuora will truncate the value of the AVS request fields sent to the gateway based on the supported field length of Orbital. This avoids the transaction failures that result from AVS field overflow. 

See Chase Orbital Version 7.0.1 Integration for more information.

Connect Marketplace

See Zuora Connect Release Notes for detailed information about Connect new features, enhancements, and documentation updates.

Zuora CPQ Release

The following articles describe the latest features of Zuora for Salesforce:


The following articles describe the latest features of Zuora Reporting and the Zuora Insights add-on:


Current WSDL version: 90

See Zuora WSDL for information on how to check your version and download the latest version.

SOAP API Change History

See Zuora SOAP API Version History for a summary of updates made to the SOAP API in recent Zuora releases.

Knowledge Center

We have updated the following Knowledge Center articles based on your feedback: