Skip to main content

Zuora Billing Release 293, February 2021


Zuora Billing Release 293, February 2021

Welcome to the release notes for Zuora Billing Release 293 (R293), February 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

Enhancement to the Subscribe and Amend actions for payment processing retries

Zuora has now provided an automatic retry mechanism for the payment processing feature on the Subscribe and Amend actions. When the ProcessPayments parameter is used to collect payments, if a temporary error that Zuora cannot create or submit a payment to the gateway is seen, Zuora will automatically retry the action.

You can contact Zuora Global Support to set the maximum number of retries that Zuora can perform. The number can range from 0 to 2 with a default value of 0. However, retrying the request can make the API calls take longer than expected. Zuora does not guarantee the retry could be completed within the timeout limit.

This retry mechanism does not support the preview mode of the Subscribe or Amend action and so the EnablePreviewMode parameter is irrelevant to this enhancement. Also, for the Subscribe action, the retry mechanism only supports the case that one single subscription is created by the action.

Invoicing and Invoice Settlement

Changes to the limits on the operations of payments and credit memos

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 has introduced changes to the limits on the following operations of payments and credit memos through the Zuora UI and API:

  • Applying credit memos
  • Refunding credit memos
  • Unapplying credit memos
  • Creating payments
  • Applying payments
  • Unapplying payments

See Known Limitations in Invoice Settlement for the corresponding limits on different operations.


Support for Future Dated Credit Balance Adjustment

This feature is only available if you have the Credit Balance feature enabled. If you want to have access to Credit Balance, submit a request at Zuora Global Support

The Future Dated Credit Balance Adjustment feature is now supported for Credit Balance. With this feature enabled, you can process credit balance adjustment from or to a future dated invoice, including:

  • Transferring credit balance from a future dated negative invoice
  • Applying credit balance to a future dated invoice
  • Refunding credit balance that is transferred from a future dated negative invoice through either external refund or electronic refund

To enable the Future Dated Credit Balance Adjustment feature, you must enable the Credit Balance feature and set the newly introduced Enable future dated credit balance adjustment? payment rule for this feature.

See Future Dated Credit Balance Adjustment for more information.

Worldpay Gateway Reconciliation now supports DART reports

This feature is in the Early Adopter phase. We are actively soliciting feedback from a small set of early adopters.

Data Analytics Reconciliation Tool (DART) contains information that is available for collection from FIS, in a data file format. DART files are available to merchants acquired by FIS. Worldpay Gateway Reconciliation now supports the following DART reports:

  • 330 - Used for chargebacks.
  • 312 - Used for payment and refund settlements, and payment rejection.
  • 313 - Used for final settlement of records from 312.

See Configure Worldpay Gateway Reconciliation 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.