Changelog for Zuora client libraries

• Added queryBundleByKey and queryBundles methods to the ObjectQueriesApi class to support querying bundles.
• Added a soldToInfoId field to the ExpandedOrderLineItem class, allowing developers to retrieve this information.

For more detailed changes, see Java client library changelog.

• Updated the ZuoraClient behavior when fetching an OAuth bearer token. Based on the existing HttpClient, a new ApiClient is now generated to fetch a bearer token. With this change, only the headers required by ApiClient are used while other headers are ignored.
• For the CommitmentInput class:
  • Renamed the taxCodeName field to taxCode, and renamed segments to periods.
  • Added new fields: associationRules, accountReceivableAccountingCode, revenueRecognitionTiming, revenueAmortizationMethod.
• For the CommitmentOutput class:
  • Replaced segments field with periods. This change will require developers to update their code to use the new periods field instead of segments.
  • Added new fields: startDate, endDate, and amount, providing additional information about the commitment.
• For the ObjectQueriesApi class, renamed methods and classes related to CommitmentCycle to CommitmentPeriod. This includes method names, class names, and API paths.
• For the PaymentMethodsApi class, added support for specifying bankAccountType in the PAD (Pre-Authorized Debit) payment method.
• Added a skipTax field to the PreviewOptions class, allowing developers to bypass tax calculation during order preview, which can improve performance for customers using external tax engines.

For more detailed changes, see Java client library changelog.

• The global zuoraVersion property in ZuoraClient has been changed to 2025-08-12 (the latest Zuora version).
• Added the pricingAttributes field to each of the following classes to support dynamic pricing:
  • ChargeOverride
  • ChargeUpdate
  • CreateOrderChargeUpdate
  • ExpandedRatePlan
  • ExpandedRatePlanCharge
  • GetChargeOverride
  • RatePlanChargeSegment
  • RatePlanChargeSegmentInfo
• Added the cryptogram field to each of the following classes, allowing developers to include a cryptogram value supplied by the token provider:
  • CollectDebitMemoRequestPayment
  • CreateAuthorizationRequest
  • CreateCreditCardPaymentMethod
  • CreatePaymentRequest
  • VerifyPaymentMethodRequest
• For the Quickstart API model, changed the revenue_recognition_rule field in Price, PricePatchRequest, and PriceCreateRequest classes from Enum to String type.

For more detailed changes, see Java client library changelog.

• Introduced the includeNullFields parameter to all query methods in the ObjectQueriesApi class. This parameter is used to control whether to include fields with null values in the response.
• Added a the originalListPrice field to the UsageOveragePricingOverride and UsageOveragePricingUpdate classes.
• For the BulkUpdateInvoicesRequest class, the type of the invoices field has been changed from List<UpdateInvoiceRequest> to List<InvoiceForBulkUpdate>.
• Refactored the CreatePaymentMethodRequest and UpdatePaymentMethodRequest classes to more intuitive type-specific classes for different payment method types, such as CreateCreditCardPaymentMethod and UpdateCreditCardPaymentMethod.

  Now you can use the corresponding payment method class depending on the payment method type you want to create or update. For example:

  Copy

  Copied

  CreateCreditCardPaymentMethod creditCardPaymentMethod = new CreateCreditCardPaymentMethod();
  creditCardPaymentMethod.type("CreditCard");
  ...
  CreatePaymentMethodRequest createCreditCardRequest = new CreatePaymentMethodRequest(creditCardPaymentMethod);

  Previously, CreatePaymentMethodRequest supported all types of payment methods in a single class, containing all possible fields across all payment method types. You had to instantiate the payment method type using the following format, which were more prone to errors:

  Copy

  Copied

  CreatePaymentMethodRequest creditCardRequest = new CreatePaymentMethodRequest()
        .type("CreditCard")
        ...;

For more detailed changes, see Java client library changelog.

• For the ObjectQueriesApi class, added support for querying ContactSnapshots with filters, expands, and sort capabilities.
• For the ObjectQueriesApi class, added the fields parameter to allow specifying which fields are returned in the response.
• For the SubscriptionsApi class, added the asOfDate parameter for chargeDetail when chargeDetail is SPECIFIC_SEGMENT.
• Added the billToContactSnapshot, soldToContactSnapshot, and shipToContactSnapshot fields to the ExpandedInvoice, ExpandedCreditMemo, and ExpandedDebitMemo classes, respectively.

For more detailed changes, see Java client library changelog.

• Added asynchronous methods for applying credit memos with applyCreditMemoAsync and ApplyCreditMemoAsyncApi to the CreditMemosApi class.
• Added asynchronous methods for unapplying credit memos with unapplyCreditMemoAsync and UnapplyCreditMemoAsyncApi to the CreditMemosApi class.
• Added getApplyCreditMemoAsyncJob and GetApplyCreditMemoAsyncJobApi to the CreditMemosApi class for retrieving information about async credit memo apply jobs.
• Added getUnapplyCreditMemoAsyncJob and GetUnapplyCreditMemoAsyncJobApi to the CreditMemosApi class for retrieving information about async credit memo unapply jobs.
• Changed the type of productCategory from ProductCategory to String for the GetSubscriptionRatePlanChargesWithAllSegments class. This change requires developers to update the code to handle productCategory as a String instead of a ProductCategory object.

For more detailed changes, see Java client library changelog.

• Added the communicationProfileId field to the multiple classes, allowing developers to associate a communication profile with an object such as order line item, subscription, and invoice.
• Added the clearingExistingCommunicationProfile field to allow clearing the existing communication profile at the subscription level. This field is mutually exclusive with communicationProfileId.
• Added the REVERSE operation job type to the OperationJobType class.

For more detailed changes, see Java client library changelog.

• Introduced a Builder pattern for ZuoraClient, allowing for more flexible and readable client configuration.
• Changed the type of relationships of CustomObjectDefinitionSchema from List<Object> to List<CustomObjectDefinitionRelationship>, which may require developers to update the code to handle the new type.
• Added support for expanding invoiceschedulebookings, invoiceschedulebookings.order, and invoiceschedulebookings.subscription to the query methods for InvoiceSchedule.

For more detailed changes, see Java client library changelog.

• Introduced support for APAC environments: CSBX_AP and PROD_AP.
• Added DataLabelingApi API integration to support the Multi-Org feature.
• Added new API integrations, DeploymentApi and DeploymentConfigurationTemplatesApi, to support the Deployment Manager feature.
• Added OmniChannelSubscriptionsApi API integration for omni-channel subscription management.
• Added CreatePredebitNotificationApi class and createPredebitNotification method to support triggering a pre-debit notification for an invoice.
• Added the retryOnConnectionFailure method to configure HTTP client behavior regarding connection failures.
• Added field condition of type Condition and objectType of type ObjectTypeEnum to the BillRunFilter class to support bill run advanced filters.
• Fixed issue: The OrdersApi.previewOrderApi() method throws errors when high-volume concurrent requests are submitted.
• Fixed issue: The UsageRecordsApi.createUsage() method could not parse response and throws exceptions.

For more detailed changes, see Java client library changelog.