Skip to main content

Zuora Billing Release 297, March 2021


Zuora Billing Release 297, March 2021

Welcome to the release notes for Zuora Billing Release 297 (R297), March 2021

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

Resolved: A suspended subscription could not be resumed on a specific date through Orders

Previously, a suspended subscription could not be resumed on a specific date through the Orders API or UI. This issue has now been resolved. The data format of the resumeSpecificDate field has been corrected from string<dateTime> to string<date> in the resume order action of the Create order operation.

Invoicing and Invoice Settlement

Support for hiding empty tables in PDF files generated for billing documents

Zuora now supports the TableNameTable.Size merge field in the invoice or memo template to control the visibility of an empty table in the PDF file generated for a billing document. Billing documents include invoices, credit memos, and debit memos; credit and debit memos are available only if you have the Invoice Settlement feature enabled.

For example, the following IF clause can be used to hide an empty tax summary table from the PDF files generated for billing documents.

{ IF {MERGEFIELD TaxSummaryTable.Size \* MERGEFORMAT}  = "0" "" "
[Tax summary table]

See Merge Fields Supported in IF Fields on Invoice Templates and Conditional Logic (IF Fields) for more information.

This enhancement was rolled back on March 26 to fix some related issues, and will be announced in a future release.


Upcoming Visa brand logo change

On March 31, 2021, Visa will begin to enforce that their new logos be used anywhere their brand is displayed. In accordance with this requirement, Zuora will update the logos of Visa within the Zuora UI and Payment Pages.

You need to replace the current logos with the new ones if you:

  • Host your own payment pages
  • Display Visa logos on your website

Refer to Visa’s website to download the new logos and learn about Visa’s brand guidelines. 

New field added for's stored credential transactions support introduced a new field called merchant_initiated that indicates whether the transaction is initiated by a merchant. To accommodate this change, Zuora has also added this field to the stored credential transaction requests sent to the gateway.

See’s documentation for more information.


Current WSDL version: 107

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.