Zuora 2025.Q2 release notes
Learn about new features, changes, fixes, and deprecations delivered in Zuora 2025.Q2 product release and subsequent release updates for Zuora Billing, CPQ, Payments, Platform, Revenue, and Zephr.
Zuora publishes release notes in advance of delivery to sandbox environments to allow additional time to review and test new and changed features before they are released to production environments. These release notes are subject to changes and additions after publishing. Any changes or additions that occur after the initial publish for a particular release version are noted with a date in the Updated column in each release note table.
Customer-impacting changes delivered after the initial major release, as part of minor or patch releases during the quarter, are also added to the release notes. The minor and patch release notes are listed in order starting from the most recent release version at the top of each table. The specific minor or patch release version is noted in the Updated column. An empty Updated column indicates that the release note applies to the major release and was not added or changed after the initial publish date.
For more information about Zuora releases, see Zuora releases explained.
Billing
New and changed features
Feature | Description | Updated |
---|---|---|
Billing permissions
|
We have made the following changes to billing permissions:
These three new permissions apply to both the Zuora UI and REST API. |
|
Invoicing and Tax
|
You can now detach subscription rate plan charges from invoice schedules. This enhancement offers more flexibility in managing charges and generating billing documents via the Billing Schedule feature. For example, you can detach early renewed subscriptions from their planned invoice schedules and generate credit memos for these subscriptions separately. Previously, credit memos could only be generated when the next planned invoice schedule item was processed. |
|
Invoicing and Tax
|
The following Object Query API operations are now available for you to retrieve the Invoice Schedule object:
You can expand the following related objects through these operations:
|
|
Invoicing and Tax
|
We have enhanced the rounding mechanism in Zuora Billing. When charges are removed from subscriptions or detached from invoice schedules, minor overcharges or undercharges might occur due to rounding, particularly for annual list prices with specific billing periods. To address this, we now generate additional invoices or credit memos for these discrepancies, ensuring alignment between Zuora Billing and Zuora Revenue. Previously, billing documents were not generated for these rounding differences. |
|
Invoicing and Tax
|
You can now reverse invoices containing less than 50,000 items, including invoice items, discount items, and taxation items. For invoices with more than 2,000 items, the reversal action is performed asynchronously via the Zuora UI or REST API to prevent timeouts. Previously, invoice reversal was not supported for invoices containing more than 2,000 items. |
|
Invoicing and Tax
|
You can now define ship-to contacts, a third type of contact in addition to the existing bill-to and sold-to contacts. Use the ship-to contact to specify the destination for shipping goods. You can specify the ship-to contact on Accounts, Subscriptions, Order Line Items, and Standalone Invoices. You can turn on this feature through the self-service interface for Feature Management. |
|
Invoicing and Tax
|
You can now configure product filters based on product attributes to specify which products are eligible for standalone billing documents, such as invoices, credit memos, and debit memos. This enhancement gives you greater flexibility and control in managing standalone billing documents. |
|
Invoicing and Tax
|
You can now view the actual amount of each invoice schedule item directly in the Zuora UI. This value is displayed in the Actual Amount to Bill column within the Scheduled Items section of the Invoice Schedule detail page. Previously, this information was only accessible through the REST API. |
|
Invoicing and Tax
|
Zuora has upgraded its Direct Avalara Integration from SOAP to REST API to provide a more seamless and modernized experience. All customers have already been upgraded to the REST API-based integration on Sandbox. Zuora plans to upgrade all customers on Production environments by the end of 2025. This enhancement ensures that customers can leverage Avalara’s latest features while maintaining a robust integration. |
|
Invoicing and Tax
|
The Configurable Tax Apps have been enhanced to support direct integration tax apps, which offer pre-built integrations to handle various tax types and rules. These apps also provide the flexibility to customize configurations using Tax Templates and Flexible Tax Mappings. The available configurable tax apps are:
This enhancement provides a single, consistent interface for managing all tax engines, making it easier to configure and maintain your tax setup. |
|
Invoicing and Tax
|
The Direct Integration Tax Apps in Configurable Tax Apps now include support for custom fields on Product and ProductRatePlan. These fields can be configured directly in the Tax Engine UI, integrated into the Tax Template, and passed to the vendor for processing. Currently, the following tax engines are part of the Direct Integration Tax Apps: |
|
Invoicing and Tax
|
The following updates have been made to formula validation when saving mapping formulas via the UI or API:
|
|
Invoicing and Tax
|
As part of the e-invoice rejection process, a new action is now available to resync the e-invoice status. You can trigger this action either via REST API or manually from the Invoice, Credit Memo, or Debit Memo detail view. Also, the E-invoices field in these screens now displays two new statuses, Approved by Authority and Rejected.
|
|
Orders and Subscriptions
|
You can now schedule cancellations, suspensions, or resumptions for subscriptions in the Zuora UI. You can do this in either of the following ways:
When the dates arrive, the system automatically creates orders with the corresponding order actions to cancel, suspend, or resume the subscription. Previously, scheduling these actions was only available via the API. |
|
Orders and Subscriptions
|
We have improved the discount detail information returned in the response body of the "Preview a subscription by subscription key" API operation:
|
|
Orders and Subscriptions
|
We have added support for returning invoice item summaries in the following API operations:
summarizeInvoiceItem query parameter set to true , the previewResult > invoices > invoiceItemSummary field is returned in the response. The aggregated invoiceItemSummary field provides a forecast of the number of future invoices in the preview period, and the following information on each invoice:
|
|
Orders and Subscriptions
|
The subscribeToProducts API is now deprecated, and we have introduced support for subscribeToRatePlans for standalone orders. For more details on how to create a subscription using a standalone order, see Create a subscription. | |
Orders and Subscriptions
|
A new field, OriginalListPrice, has been added to the RatePlanCharge Data object in Data Query under Reporting. This field represents the initial price of a product or service as set by the manufacturer or retailer for sale. | |
Orders and Subscriptions
|
You can now create an order under either an existing subscription owner account or an existing invoice owner account using the Orders API. Specify the target account in the existingAccountNumber field of the API payload, which can be either the subscription owner account or the invoice owner account. | |
Orders and Subscriptions
|
A new field, Order ID, has been added under the Subscription object in the Data Sources screen (Reporting > Data Sources). |
Billing 2025.Q2 fixes
For the list of resolved issues, see Zuora Billing 2025.Q2 Fixes in the Support Center. Additional logon information may be required to access the Zendesk portal.
CPQ
New and changed features
There are currently no new and changed features reported for CPQ in 2025.Q2.
Payments
New and changed features
Feature | Description | Updated |
---|---|---|
Payments
|
Our API operations now allow you to map the failed payment error codes to the applicable response codes. This change aims to reduce your transaction processing cost by allowing you to customize routing rules based on payment failure mappings. Currently, this feature is only compatible with the gateway routing. |
|
Payments
|
In addition to the reconciliation for credit card transactions, Chase Orbital gateway integration now supports reconciliation for the following payment methods:
|
|
Payments
|
We have introduced the following Bank Identification Number (BIN) conditions for payment method condition in gateway routing condition shape:
|
|
Payments
|
Earlier, the Activate Payment Gateway Routing toggle button enabled gateway routing to all the billing accounts in your tenant. With this release, Zuora has added a Gateway Routing Eligible toggle to help you include only the applicable billing accounts to gateway routing for controlled adoption. Additionally, you can enable or disable gateway routing for specific accounts by using our API operations and updating the Gateway Routing Eligible field on the customer object. |
|
Payments
|
We have enhanced the write-off operation to support invoices and debit memos at the line item level. Previously, write-offs were possible only at the billing document level. | |
Payments
|
We have enhanced the payment allocation rules. Previously, the 'Configure Application Rule' was only applied at the item level. With this enhancement, the allocation rule will now also be effective at the billing document level, providing greater flexibility and managing how payments are allocated. You can apply the rule to billing documents like invoices, debit memos, and corresponding line items. | |
Payments
|
We have enhanced the Async Credit Memo (CM) allocation API to support applying and unapplying CM to invoices or debit memos with more than 100,000 items. This enhancement allows a fully automated flow to handle large invoice write-offs management. |
Payments 2025.Q2 Fixes
There are currently no fixed issues reported for Payments in 2025.Q2.
Platform
New and changed features
Feature | Description | Updated |
---|---|---|
Analytics
|
Consumption Insights is now available for early adopters. It supports all usage-based pricing model users. Consumption Insights is a machine learning-powered feature designed to help your businesses optimize revenue by providing deep analytics on usage-based metrics. |
|
Central Sandbox
|
Central Sandbox now supports selective scrubbing via the Object Manager interface. Selective scrubbing helps you easily manage PIIs and field-level data protection and helps you protect your PII and other sensitive data from unauthorized access in the sandbox environment. While initiating a Central Sandbox refresh, you can specify the fields that should be considered PII and hidden in a sandbox environment. | |
Data Loader
|
Data Loader now supports nullifying of fields. Nullifying fields refers to the process of clearing the value of a field in records during a data operation. This action sets the field to a "null" state, which means the field has no value or is blank. |
|
Data Loader
|
We have added the following object templates to the Data Loader:
|
|
Deployment Manager
|
Deployment Manager now supports pre-validation, allowing you to verify deployments before applying changes to the target tenant. This early feedback mechanism helps identify misconfiguration, missing dependencies, and potential issues upfront, ensuring smoother deployments. By detecting errors early, Pre-Validation saves time, reduces deployment failures, and prevents disruptions in the target environment. |
|
Deployment Manager
|
You can now configure the Workflow version state in Deployment Manager by defining the state of a workflow version as Active or Inactive during deployment by selecting the Deployment Preferences in the Compare screen. |
|
Events and Notifications
|
The Reusable Blocks feature for email templates is now available. It allows you to define reusable email components, such as headers and footers, and embed them into different email templates. Updates made to a reusable block are automatically applied across all linked templates. This feature eliminates the need to recreate common elements manually and enhances consistency and efficiency in email template management. Currently, the Deployment Manager does not support Reusable Blocks. To ensure proper email template rendering after the migration, you must manually create reusable blocks in the target environment using the same block numbers as in the source environment. |
|
Events and Notifications
|
You can now copy reusable blocks during Central Sandbox or Developer Sandbox data refreshes. This applies only to newly created blocks in source environments. Existing blocks in target environments will not be overwritten or deleted, ensuring data consistency and allowing you to conduct unique tests within these sandbox environments. |
|
Events and Notifications
|
Previously, the Notification System Health Dashboard displayed the "Unable to get attachments for email" error when email notifications were triggered before the billing document PDF was generated, even though the system would retry sending the emails. We have improved the alerting mechanism so that this error now appears only if the final retry fails, ensuring more accurate and efficient error handling. |
|
Zuora Connectors
|
The Zuora Connector for Clickhouse is now available for early adopters. This connector allows you to integrate Clickhouse as a destination to transfer data from our system. For more information, contact your Customer Success representative or Account Executive. | |
Zuora OneID
|
Unified Permission Management in OneID for Zuora Billing is now available for early adopters. It provides a centralized and streamlined approach to manage user roles, permissions, and access controls across Zuora Billing tenants. It ensures a consistent and secure framework for defining and enforcing permissions, reducing complexity and improving compliance. | |
Zuora OneID
|
Zuora OneID now supports Multifactor Authentication (MFA). MFA enhances security by integrating Time-based One-Time Password (TOTP) authentication for users, enabling them to authenticate using third-party TOTP authenticator apps like Google Authenticator, Microsoft Authenticator, or Authy. |
Zuora Platform 2025.Q2 fixes
There are currently no fixed issues reported for Platform in 2025.Q2.
Revenue
New and changed features
Feature | Description | Updated |
---|---|---|
Manage Mass Actions | The following mass actions will be made available for transactions originated from Zuora Billing:
|
|
Subscription with "Pending Activation" status | In Billing, if the charge is pending, the whole subscription created out of it remains in pending status. Revenue consumes the subscription and the subscription participates in all the Revenue-related activities, that is, Contract Modification (upsell and downsell). The subscription does not get released in Revenue as the revenue hold is applied based on the status of the subscription. Once the subscription status changes and when it gets collected again into Revenue, the hold that was applied on the subscription is removed and revenue is released. | |
Revenue Contract | When you delinked a line in a Revenue Contract, the accounting treatment of the contract was always forced into retrospective for allocation. Now, if the line that you delink is not eligible for allocation, then the RC is not forced to change the accounting treatment. The existing allocation treatment stays as is. |
Zuora Revenue 2025.Q2 fixes
For the list of resolved issues, see Zuora Revenue 2025.Q2 Fixed Issues in the Support Center. Additional logon information may be required to access the Zendesk portal.
Zephr
New and changed features
Feature | Description | Updated |
---|---|---|
Identity
|
You can now integrate Zephr with external authentication providers to manage sign-in and registration with Zephr’s User Store. This enhancement allows you to use Zephr's out-of-the-box forms and pages while connecting to third-party auth providers. Zephr now has an out-of-the-box integration with Auth0 for authentication. For other providers, a custom extension can be developed with the support of Global Services. This update enhances flexibility and simplifies integration for a broader range of customers Note: This release supports authentication only. It does not support syncing or managing user metadata or attributes from external identity providers. |
|
Dynamic Offers
|
All relevant fields from the Billing object query are now surfaced in the Dynamic Offers (DO) API response, retrieved directly from the Catalog. This enhancement ensures more comprehensive data retrieval, improving the accuracy and flexibility of dynamic offer configurations and integrations. | |
Users
|
Zephr now allows customers using a Customer Data Platform (CDP) to add users directly to static segments via API, bypassing rules-based flows. This update eliminates delays caused by predefined workflows and enables proactive segmentation. | |
Users
|
We've added a new bulk action, create-user-grant, to the Update Users in Bulk API, allowing the assignment of grants to multiple users in a single call. |
Zephr 2025.Q2 fixes
There are currently no fixed issues reported for Zephr in 2025.Q2.
REST API
For the detailed API documentation, see API Reference.
For a summary of REST API updates and documentation updates in the Zuora API Reference, see 2023 API Changelog.
Quickstart API
From 2022.09.R1, the Quickstart API is available to you if you have the Orders (or Order Harmonization) and Invoice Settlement features enabled in your tenant. The QuickstartAPI allows new integrators to swiftly integrate with Zuora, and it supports essential business use cases.
SOAP API
Current WSDL version: 151
For information about how to check your version and download the latest version. see Zuora WSDL.
SOAP API change history
For a summary of updates made to the SOAP API in recent Zuora releases, see Zuora SOAP API Version History.