Skip to main content

Zuora Billing Release 307, August 2021


Zuora Billing Release 307, August 2021

Welcome to the release notes for Zuora Billing Release 307 (R307), August 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.

Development Tools

Zuora SDK for Java now generally available

The Zuora SDK for Java provides a language idiomatic programming interface to Zuora Billing, which reduces integration effort without sacrificing the power or flexibility of Zuora's platform. With the Zuora SDK, you can start developing with Zuora in minutes.

To get started with it, refer to the following resources:

The Zuora SDK for Java remains under active development as Zuora continually releases new versions of the SDK to extend its coverage and add new features.

Join the Zuora Developers Community to discuss the SDK, report any issues, and connect with other developers.

Orders and Subscriptions

Behavior change in the account deletion function for the Subscribe and Amend tenants

Zuora has changed the behavior in the account deletion function for the Subscribe and Amend tenants so that the account deletion behavior is consistent with that of the Orders (and Orders Harmonization) tenants. In this change, the following limitations are added:

  •  An account cannot be deleted when: 
    • The account is an invoice owner or subscription owner of a subscription; and
    • The subscription's invoice owner and subscription owner are two different accounts.
  • An account cannot be deleted if this account has ever been involved in an Owner Transfer amendment, either as the current owner or as the previous owner. 

Invoicing and Invoice Settlement

Applied tax amount now available on the credit memo details page

In the Document area of the credit memo details page, a new column called Applied Tax Amount is now available to show the sum of the tax amounts of all applied credit memo items. This update improves the information clarity of the applied amounts of credit memos.

See View information of credit and debit memos for more information.

Support for creating multiple Connect Tax Engines

You can now create multiple Connect Tax Engines for tax apps you purchased through Zuora Marketplace. Previously you could only create one Connect Tax Engine.

After creating a new Connect Tax Engine, you can set up a new tax code that refers to the Connect Tax Engine. This enhancement allows you to use different tax apps to process tax for various charges in your product catalog.

You can create at most 10 Connect Tax Engines for one tenant, including creating multiple Connect Tax Engines for the same tax app.

See Connect tax engines for more information.

Setting for allowing invoice splitting now available

A new setting for allowing invoice splitting is now available in Billing rules to all Zuora customers. This setting is disabled by default. With this setting enabled, you can split an invoice into multiple ones with different payment schedules on a percentage basis. 

Previously, you had to submit a request at Zuora Global Support to access the invoice splitting feature.

See Splitting invoices for more information.

Enhancements for the invoice-level rounding feature

This feature is in Limited Availability. If you want to have access to the feature, submit a request at Zuora Global Support

Zuora has enhanced the invoice-level rounding feature. When you write off or reverse an invoice, credit memo items with matching Rounding processing type are now generated for Rounding invoice items, instead of the previous Charge processing type.  

See Invoice-level rounding for more information.

New merge fields available on the InvoiceItem object in invoice templates 

The following merge fields are now available on the InvoiceItem object of standalone or consolidated invoices:

  • InvoiceItem.PurchaseOrderNumber
  • InvoiceItem.ItemType

You can use the merge fields to display the purchase order number and the type of non-subscription invoice items on the invoice PDF files. These merge fields have values only for the non-subscription invoice items of standalone or consolidated invoices when the Unified Invoicing feature is enabled. 

See Merge fields for invoices for more information.


Setting for validating credit card expiration date now available

A new setting for validating credit card expiration date is now available in Define Payment Rules to all Zuora customers. This setting is enabled by default, validating whether the expiration month and year of the credit card are earlier than the current month and year.

Previously, if you wanted to disable validation of the credit card expiration date, you had to submit a request at Zuora Global Support. Now you can easily disable or enable it through the self-service configuration setting.

See Define payment rules for more information.

More flexibility on configuring Export Compliance for CyberSource v2.0

When you edit the gateway configuration page of CyberSource, Payment API v2.0, the Use Export Compliance setting is now a dropdown list with the following options:

  • Enable for Auth & Payment Capture (default)
  • Disable Export Compliance
  • Only Enable for Auth

Previously, it was a checkbox that only allowed enabling or disabling Export Compliance in all requests to the gateway. This enhancement provides more flexibility for you to manage your costs when using the Export Compliance service with Cybersource.

See CyberSource payment gateway for more information.


Current WSDL version: 110

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.