Skip to main content

Zuora Billing Release 298, April 2021


Zuora Billing Release 298, April 2021

Welcome to the release notes for Zuora Billing Release 298 (R298), April 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.


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 a billing document PDF file, including 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 a billing document PDF file.

{ 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.

Enhancement on bill run status cascading update

To improve the system stability and performance, when the last draft invoice is posted in a bill run, Zuora now does not automatically update the bill run status to Posted asynchronously.

Support for regenerating PDF files upon invoice posting

To enforce the visibility of PDF file generation for a posted invoice, Zuora now supports regenerating a PDF file asynchronously upon invoice posting.

This enhancement does not apply to the following scenarios:

  • Billing document file generation is disabled in billing settings. 
  • The limited available feature "Don't Generate PDF Files When Invoices Are Created or Changed" is enabled.


General availability of support for creating custom payment runs through REST API

Support for creating custom payment runs through Zuora REST API is now generally available for all Zuora customers, allowing you to specify the records of accounts and billing documents to be collected in the data field with flexibility.

See Create custom payment runs through Zuora REST API for more information. 

Access Worldpay now supports ACH

Zuora’s Access Worldpay gateway integration now supports the ACH payment method. You can now process the following transactions using ACH payment methods through Access Worldpay:

  • Payment
  • Cancel payment

See Access Worldpay gateway integration for more information.

Support for automatically capturing IP address from Payment Pages for Adyen Integration v2.0 

A new setting named Auto-capture IP Address is now available on the gateway configuration page of Adyen Integration v2.0.

With this setting enabled, Zuora will automatically capture shoppers’ IP addresses from Payment Pages for Adyen Integration v2.0 and send them to the gateway if the IP addresses have not been passed through existing fields.

See Adyen Integration v2.0 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.