Skip to main content

Zuora Billing Release 285, September 2020


Zuora Billing Release 285, September 2020

Welcome to the release notes for Zuora Billing Release 285 (R285), September 2020

For more information about the release notes of other Zuora products, see Zuora Release Notes.

Release schedule

Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Billing releases.


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

Usage and Rating

Changes to on-demand usage rating

Zuora now introduces a behavior change to on-demand usage rating for usage-based charges. If the charge through date of a usage charge is later than the target date of a bill run, the charge is not picked up for rating and billing in the bill run.

Invoicing and Invoice Settlement

Support for more company codes in Avalara integration and third-party tax connectors

Currently, you can use at most 40 company codes defined for integration between Zuora and Avalara and for integration with a third-party tax engine via tax connector apps. Previously, the limit was 20 on the maximum number of company codes.


Refreshing changes to the payment run details page

This feature is only available if you have Invoice Settlement enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memos, and Invoice Item Settlement. If you want to have access to the feature, see Invoice Settlement Enablement and Checklist Guide for more information.

Zuora now introduces a behavior change to the payment run details page. If a payment run is in Completed status, a refreshing icon is now displayed in the Payment Run Summary area for you to reload summary information.

First Data Payeezy supports stored credentials transactions of American Express

The First Data Payeezy gateway integration has been enhanced to support the Stored Credential Transaction framework of American Express. For more information, see First Data Payeezy Gateway and Support for stored credential transactions overview.

Vantiv (Now Worldpay) now supports stored credential transactions for Credit Card Reference payment methods 

The Vantiv (Now Worldpay) gateway integration now supports the Stored Credential Transactions framework for Credit Card Reference (CCRef) payment methods.

With this feature, you can create new CCRef payment methods with Zuora’s Vantiv (Now Worldpay) gateway integration. A network transaction ID will be stored on the Second Token ID (SecondTokenId) field, which will be used for future payments. 

Note that the support for stored credential transactions is enabled as the default behavior for CCRef transactions. No additional configuration is required. 

CyberSource supports stored credential transactions for Apple Pay payment methods

We now support stored credential transactions for Apple Pay payment methods on the CyberSource Payment API v2.0 gateway integration. You can use the Create an Apple Pay payment method API operation to create stored credential profiles when creating the Apple Pay payment methods. For the existing Apple Pay payment methods, you can add stored credential profiles for them through APIs or UI.

For more information, see Support for stored credential transactions overview and Configuration procedures for stored credential transaction support.


Create custom object definition API can now filter out the system fields in the request schema

Previously, when you tried to use the response schema of the Get custom object definition operation as the request schema and made a Create custom object definition request, the call failed due to the presence of the system fields in the schema. These system fields will now be filtered out automatically and you can successfully create a custom object definition by using the Get custom object definition response schema as the request schema.

Filterable fields can now be changed through Update custom object definition API

Previously, you cannot change the filterable value of a custom field once the field is created. You can now change a filterable field to non-filterable and vice versa though Update custom object definition API.


Current WSDL version: 105

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.