Skip to main content

Zuora Billing Release 270, March 2020


Zuora Billing Release 270, March 2020

Welcome to the release notes for Zuora Billing Release 270 (R270), March 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.

Orders and Subscriptions

The migration to full Orders is in Limited Availability. We are actively soliciting feedback from a small set of early adopters before releasing as generally available.

New options when specifying accounts through the Orders UI

A pair of radio buttons has been added to the Account field in the Orders UI to ease specifying an account. When specifying the invoice owner or subscription owner for a subscription, you can now toggle between the following options to select the way of specifying an account: 

  • Search by Account Name
  • Specify complete Account Number

Order description field now available in the Orders UI

A new field called Description has been added to the Orders UI. When creating an Order through the Zuora UI, you can provide a description of the Order in this field.

Invoicing and Taxes

Support for new barcode types in invoice templates

Zuora now supports Code 39 and ITF barcode types in invoice templates. When you define invoice templates, you can now set the barcode merge field to any of the following values:

  • BarCode.Code39
  • BarCode.Code39Extended
  • BarCode.ITF6
  • BarCode.ITF14

Support for selecting multiple batches of accounts to include in bill runs

You can now select specific batches of customer accounts to be included in bill runs through both the Zuora UI and SOAP API. Previously, you could only select either one batch or all batches.

When creating bill runs by using the New Bill Run page or the "New Scheduled or Recurring Bill Run" page, you can now click Specific Batch(es) and then select multiple batches from the list in the Multiple Customer Accounts tab.

Through the API, you can use the Batches field of the BillRun object to specify specific batches of customer accounts to be included in bill runs.

Numeric merge fields can now be formatted for invoices based on communication profiles

When defining invoice templates, you can now format numeric merge fields based on your customers' communication profile locales.

Invoice Settlement

UI change to prefix and numbering configuration for billing documents

You can now perform the following steps to manage billing document sequence sets through the Zuora UI: 

  1. Click your username at the top right, and navigate to Billing > Define Numbering and SKU Formats.
  2. In the Define Prefixes, Numbers and Sequence Sets area, configure prefixes and starting number sequences for billing documents.

Previously, you had to make the configurations in the Prefix & Numbering tab after navigating to Billing > Manage Billing Document Configuration.

Due date now available on the debit memo 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.

The Due Date field is now displayed in the Basic Information area on the debit memo details page. You can use this field to view and edit the due date of debit memos through the Zuora UI.


Behavior change of Gateway Reconciliation for Orbital Paymentech gateway integration

All versions of Zuora's Orbital Paymentech gateway integration now support multiple Gateway Reconciliation (GR) settlement report files for each day:

  • If no file is returned, the Source Not Present message will be displayed in the Source Name column on the GR Job details page.
  • If multiple files are returned, you can view and download each individual file in the Source Name column on the GR Job details page.

Previously, only one settlement report file could be processed on a daily basis.

New fields available for Payment Pages 2.0

The CAPTCHA challenge feature for Payment Pages 2.0 in Zuora is implemented based on the Google reCAPTCHA service. The following fields specific to Payment Pages 2.0 are now available by navigating to Payments Settings > Setup Hosted Pages in the Zuora UI:

  • Site Key
  • Secret Key

Both fields are Google reCAPTCHA v2 keys that you can obtain from your Google reCAPTCHA Admin Console. With both fields specified, you can monitor the traffic on your site in the Admin Console analytics page and identify potential security issues at an early stage.

See Configure Payment Pages 2.0 for more information. gateway integration now supports 3D Secure 2.0

To comply with PSD2, Zuora’s gateway integration now supports 3D Secure 2.0 using's hosted solution. You can enable this feature in the configuration page of Payment Pages 2.0.

Currently, the 3D Secure 2.0 feature for works with the following credit card brands:

  • Visa
  • Mastercard
  • American Express

See payment gateway integration and Enable 3DS2 for gateway integration for more information.


Data Query now generally available

Data Query is a new SQL-based querying service to access your objects in real-time with unlimited joins. Using customized reports of Data Query, you can get the exact insights that you are looking for to uncover new monetization opportunities.

You can use Data Query in the following ways:

Settings API now generally available 

Settings API allows you to automate your tenant settings management process. See Settings API for an overview and tutorials.

See Settings for the API reference.


Current WSDL version: 102

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.