2023 Changelog
This page summarizes the changes that are made to the API Reference for Billing, Payments, and Central Platform in 2023.
For release notes for all Zuora products, see Latest releases.
May 26, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.05.R2. For release notes for all Zuora products, see Latest releases.
API updates for Adyen Apple Pay and Adyen Google Pay payment methods
The following items are the API updates specific to using the email
field to pass email information to Adyen for Apple Pay and Google Pay payment methods.
-
Payment Methods
- In the request body of the "Create a payment method" operation, added Adyen Apple Pay and Google Pay to the description of the
email
field. -
Accounts
- In the request body of the "Create an account" operation, added Adyen Apple Pay and Google Pay to the description of the
paymentMethod
>email
field. -
Orders
- In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
Added Adyen Apple Pay and Google Pay to the description of each of the following fields:
-
newAccount
>paymentMethod
>email
-
subscriptions
>orderActions
>createSubscription
>newSubscriptionOwnerAccount
>paymentMethod
>email
Other API updates
The following items are the other general API updates included in this release:
-
For CRUD operations and the
Delete
action, the HTTP response status code is now updated to 200 from 400 in the case that you attempt to delete an object with an invalid ID. Note that this change is currently live in Sandbox and Central Sandbox environments, and it will be deployed to Production no earlier than June 3, 2023.
For more information about this change, see the 2023.05.R2 Release Notes . -
Subscriptions
- Made the following updates:
-
In the response body of each of the following operations, added the
property name *
andproductOfferName
nested fields to theoffers
field:- Retrieve a subscription by key
- Retrieve a subscription by key and version
-
In the response body of the "List subscriptions by account key" operation, added the
property name *
andproductOfferName
nested fields to thesubscriptions
>offers
field.
-
In the response body of each of the following operations, added the
-
Orders
- Made the following updates:
-
In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
- Update an order
Updated the description of each of the following fields to clarify that custom fields are available for subscription offers:
-
subscriptions
>orderActions
>createSubscription
>subscribeToProducts
-
subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>customFields
-
subscriptions
>orderActions
>addProduct
-
subscriptions
>orderActions
>addProduct
>customFields
-
subscriptions
>orderActions
>updateProduct
-
subscriptions
>orderActions
>updateProduct
>customFields
-
In the response body of each of the following operations:
- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
Updated the description of each of the following fields to clarify that custom fields are available for subscription offers:
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>customFields
-
orders
>subscriptions
>orderActions
>addProduct
-
orders
>subscriptions
>orderActions
>addProduct
>customFields
-
orders
>subscriptions
>orderActions
>updateProduct
-
orders
>subscriptions
>orderActions
>updateProduct
>customFields
-
In the response body of the "Retrieve an order" operation, updated the description of each of the following fields to clarify that custom fields are available for subscription offers:
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>customFields
-
order
>subscriptions
>orderActions
>addProduct
-
order
>subscriptions
>orderActions
>addProduct
>customFields
-
order
>subscriptions
>orderActions
>updateProduct
-
order
>subscriptions
>orderActions
>updateProduct
>customFields
-
-
In the request body of each of the following operations:
-
Settings
- Made the following updates:
-
Added the
number
parameter for each of the following settings:-
AllCommunicationProfiles
-
CommunicationProfile
-
-
Added the following enum values to the
billingCycleTypes
parameter of theBillingCycleType
setting:-
TermStartDay
-
TermEndDay
-
-
Added the
-
Payment Schedules
- Made the following updates:
-
For the "Update a payment schedule item" operation, made the following updates:
-
Removed the version control information from the description of each of the following fields:
-
linkPayments
andunlinkPayments
fields in the request body -
psiPayments
field in the response body
-
-
Updated the description of the
zuora-version
request header.
-
Removed the version control information from the description of each of the following fields:
-
In the response body of each of the following operations, updated the description of
zuora-version
request header and removed the version control information from the description of theitems
>psiPayments
field:- Create a payment schedule
- List payment schedules by customer account
- Retrieve a payment schedule
- Update a payment schedule
- Preview the result of payment schedule updates
- Cancel a payment schedule
- Retrieve a payment schedule item
- Cancel a payment schedule item
- Skip a payment schedule item
- Retry failed payment schedule item
- Update a payment schedule item
- Add payment schedule items to a custom payment schedule
-
For the "Update a payment schedule item" operation, made the following updates:
-
In the "Minor Version History" table of the "API Versions" section, removed the following fields and their corresponding entries:
-
linkPayments
-
unlinkPayments
-
psiPayments
-
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
Doc updates for the Annual List Price feature
The following items are the documentation updates specific to the Annual List Price feature.
-
In the request body of the "Create an account" operation, updated the description of each of the following fields for better clarity:
-
subscription
>subscribeToRatePlans
>chargeOverrides
>listPriceBase
-
subscription
>subscribeToRatePlans
>chargeOverrides
>specificListPriceBase
-
-
In the request body of the "Create an offer" operation, updated the description of the
productRatePlans
>chargeOverrides
>prices
>listPriceBase
field for better clarity. -
In the response body of the "Retrieve an offer" operation, updated the description of the
productRatePlanCharges
>priceBookItems
>listPriceBase
field for better clarity. -
In the response body of the "List price book items" operation, updated the description of the
offers
>productRatePlanCharges
>priceBookItems
>listPriceBase
field for better clarity. -
In the request body and response body of each of the following operations, updated the description of the
listPriceBase
field for better clarity.- Create a price book item
- Update a price book item
-
In the response body of the "Retrieve a price book item" operation, updated the description of the
listPriceBase
field for better clarity. -
In the response body of the "List price book items" operation, updated the description of the
priceBookItems
>listPriceBase
field for better clarity. -
In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
- Preview an order
- Preview an order asynchronously
- Update an order
Updated the description of each of the following fields for better clarity:
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
- Update an order
Updated the description of each of the following fields for better clarity:
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
In the response body of each of the following operations:
- Retrieve an order
- List order metrics for an evergreen subscription (in the Older API Reference)
Updated the description of each of the following fields for better clarity:
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
order
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
In the response body of each of the following operations:
- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
Updated the description of each of the following fields for better clarity:
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
orders
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
orders
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
orders
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
orders
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>changePlan
>newProductRatePlan
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
In the request body of each of the following operations:
- Create a subscription
- Preview a subscription
Updated the description of each of the following fields for better clarity:
-
subscribeToRatePlans
>chargeOverrides
>listPriceBase
-
subscribeToRatePlans
>chargeOverrides
>specificListPriceBase
-
In the request body of the "Update a subscription" operation, updated the description of each of the following fields for better clarity:
-
add
>chargeOverrides
>listPriceBase
-
change
>chargeOverrides
>listPriceBase
-
add
>chargeOverrides
>specificListPriceBase
-
change
>chargeOverrides
>specificListPriceBase
-
-
In the response body of each of the following operations:
- Retrieve a subscription by key
- Retrieve a subscription by key and version
Updated the description of each of the following fields for better clarity:
-
ratePlans
>ratePlanCharges
>listPriceBase
-
ratePlans
>ratePlanCharges
>specificListPriceBase
-
In the response body of the "List subscriptions by account key" operation, updated the description of each of the following fields for better clarity:
-
subscriptions
>ratePlans
>ratePlanCharges
>listPriceBase
-
subscriptions
>ratePlans
>ratePlanCharges
>specificListPriceBase
-
-
In the request body of each of the following operations in the Older API Reference:
- CRUD: Create a product rate plan charge
- CRUD: Update a product rate plan charge
Updated the description of each of the following fields for better clarity:
-
ListPriceBase
-
SpecificListPriceBase
-
In the response body of the "CRUD: Retrieve a product rate plan charge" operation, updated the description of each of the following fields for better clarity:
-
ListPriceBase
-
SpecificListPriceBase
-
-
In the response body of the "List all product rate plans of a product" operation, updated the description of each of the following fields for better clarity:
-
productRatePlans
>productRatePlanCharges
>listPriceBase
-
productRatePlans
>productRatePlanCharges
>specificListPriceBase
-
-
In the response body of the "Retrieve a rate plan" operation, updated the description of each of the following fields for better clarity:
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>listPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>specificListPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>specificListPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>specificListPriceBase
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>specificListPriceBase
-
The following updates applies to the Older API Reference:
-
In the request body of the "Amend" action, updated the description of each of the following fields for better clarity:
-
requests
>Amendments
>RatePlanData
>RatePlanChargeData
>RatePlanCharge
>ListPriceBase
-
requests
>Amendments
>RatePlanData
>RatePlanChargeData
>RatePlanCharge
>SpecificListPriceBase
-
-
In the request body of the "Subscribe" action, updated the description of each of the following fields for better clarity:
-
subscribes
>SubscriptionData
>RatePlanData
>RatePlanChargeData
>RatePlanCharge
>ListPriceBase
-
subscribes
>SubscriptionData
>RatePlanData
>RatePlanChargeData
>RatePlanCharge
>SpecificListPriceBase
-
-
In the request body of the "CRUD: Update a rate plan charge" operation, updated the description of each of the following fields for better clarity:
-
ListPriceBase
-
SpecificListPriceBase
-
-
In the response body of the "CRUD: Retrieve a rate plan charge" operation, updated the description of each of the following fields for better clarity:
-
ListPriceBase
-
SpecificListPriceBase
-
Other doc updates
The following items are the other general documentation updates included in this release:
-
In the response body of each of the following operations, updated the description of the
memos
>source
field for better clarity:- Create credit memos
- Update credit memos
-
In the response body of each of the following operations, updated the description of the
source
field for better clarity:- Create a credit memo from a charge
- Create a credit memo from an invoice
- Retrieve a credit memo
- Update a credit memo
- Apply a credit memo
- Unapply a credit memo
- Cancel a credit memo
- Post a credit memo
- Unpost a credit memo
-
In the response body of the "List credit memos" operation, updated the description of the
creditmemos
>source
field for better clarity. -
In the response body of the "List subscriptions by account key" operation, corrected the format and description of the
SpecificDayofMonth(# of the month)
enum value field for thesubscriptions
>ratePlans
>ratePlanCharges
>billingDay
field. -
In the response body of each of the following operations, corrected the format and description of the
SpecificDayofMonth(# of the month)
enum value field for theratePlans
>ratePlanCharges
>billingDay
field:- Retrieve a subscription by key
- Retrieve a subscription by key and version
-
In the request body and request sample of the "Generate a billing preview" operation, corrected the
accountKey
field toaccountNumber
. - Updated the description of the "Retrieve a billing preview run" operation for better clarity.
-
In the response body of the "Retrieve a refund" operation, removed the unsupported
PaymentId
field. This change applies to the Older API Reference.
May 19, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.05.R1. For release notes for all Zuora products, see Latest releases.
API updates for the Billing Schedule feature
The following items are the API updates specific to the Early Adopter announcement of the Billing Schedule feature.
Note: The Billing Schedule feature is in the Early Adopter phase. We are actively soliciting feedback from a small set of early adopters before releasing it as generally available. If you want to join this early adopter program, submit a request at Zuora Global Support.
-
Invoice Schedules
- Made the following updates:
-
Added the following operations:
- Pause an invoice schedule
- Resume an invoice schedule
-
In the response body of each of the following operations, added the
Paused
enum value to thestatus
field:- Create an invoice schedule
- Update an invoice schedule
- Retrieve an invoice schedule
- Execute an invoice schedule
-
In the request body and response body of each of the following operations:
- Create an invoice schedule
- Update an invoice schedule
Added the following fields:
-
consolidateBillingDocuments
-
additionalSubscriptionsToBill
-
nextRunDate
-
scheduleItems
>targetDateForAdditionalSubscriptions
-
In the response body of the "Retrieve an invoice schedule" operation, added the following fields:
-
consolidateBillingDocuments
-
additionalSubscriptionsToBill
-
nextRunDate
-
scheduleItems
>targetDateForAdditionalSubscriptions
-
-
In the request body and reresponse body of the "Update an invoice schedule" operation, added the
nextRunDate
field. -
In the response body of the "Create an invoice schedule" operation, added the
nextRunDate
field.
-
Added the following operations:
-
Credit Memos
- Made the following updates:
-
In the response body of the "Retrieve a credit memo item" operation, added the following fields:
-
invoiceScheduleId
-
invoiceScheduleItemId
-
-
In the response body of the "List credit memo items" operation, added the following fields:
-
items
>invoiceScheduleId
-
items
>invoiceScheduleItemId
-
-
In the response body of the "Retrieve a credit memo item" operation, added the following fields:
-
Invoices
- In the response body of the "List all items of an invoice" operation, added the following fields:
-
invoiceItems
>invoiceScheduleId
-
invoiceItems
>invoiceScheduleItemId
-
-
Subscriptions
- Made the following updates:
-
In the response body of the "List subscriptions by account key" operation, added the
invoiceScheduleId
nested field to thesubscriptions
>ratePlans
>ratePlanCharges
field. -
In the response body of each of the following operations, added the
invoiceScheduleId
nested field to theratePlans
>ratePlanCharges
field:- Retrieve a subscription by key
- Retrieve a subscription by key and version
-
In the response body of the "List subscriptions by account key" operation, added the
Other API updates
The following items are the other general API updates included in this release:
-
Accounts
- In the request body of the "Update an account” operation, added the following fields:
-
purchaseOrderNumber
-
customerServiceRepName
-
-
Credit Memos
- In the request body of the "Create a credit memo from a charge" operation, changed the behavior of the following fields that can now be both specified in a request:
-
accountId
-
accountNumber
-
-
Data Queries
- In the request body of the "Submit a data query" operation, made the following updates:
-
Removed the unsupported
DATAHUB
enum value from thesourceData
field. -
Updated the description of the
sourceData
field for better clarity.
-
Removed the unsupported
-
Billing Preview Run
- Made the following updates:
-
In the request body of the "Create a billing preview run" operation, added the
storageOption
field. -
In the response body of the "Retrieve a billing preview run" operation, made the following updates:
-
Added the
storageOption
field. -
Updated the description of the
resultFileUrl
field to reflect the effects of thestorageOption
field.
-
Added the
-
In the request body of the "Create a billing preview run" operation, added the
-
Orders
- Made the following updates:
-
In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
- Preview an order
- Preview an order asynchronously
- Update an order
Added the following fields:
-
orderLineItems
>billTo
-
orderLineItems
>ownerAccountNumber
-
In the response body of the "Retrieve an order" operation, added the following fields:
-
order
>orderLineItems
>billTo
-
order
>orderLineItems
>billToSnapshotId
-
order
>orderLineItems
>ownerAccountId
-
order
>orderLineItems
>ownerAccountNumber
-
order
>orderLineItems
>ownerAccountName
-
order
>orderLineItems
>invoiceOwnerAccountId
-
order
>orderLineItems
>invoiceOwnerAccountNumber
-
order
>orderLineItems
>invoiceOwnerAccountName
-
-
In the response body of each of the following operations:
- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
Added the following fields:
-
orders
>orderLineItems
>billTo
-
orders
>orderLineItems
>billToSnapshotId
-
orders
>orderLineItems
>ownerAccountId
-
orders
>orderLineItems
>ownerAccountNumber
-
orders
>orderLineItems
>ownerAccountName
-
orders
>orderLineItems
>invoiceOwnerAccountId
-
orders
>orderLineItems
>invoiceOwnerAccountNumber
-
orders
>orderLineItems
>invoiceOwnerAccountName
-
In the request body of each of the following operations, changed the behavior of the
orderLineItems
>soldTo
field:- Create an order
- Create an order asynchronously
- Preview an order
- Preview an order asynchronously
- Update an order
-
In the response body of the "Retrieve an order" operation, changed the behavior of the
order
>orderLineItems
>soldTo
field. -
In the response body of each of the following operations, changed the behavior of the
orders
>orderLineItems
>soldTo
field:- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
-
In the request body of each of the following operations:
-
Order Line Items
- Made the following updates:
-
In the request body of the "Update an order line item" operation, added the following fields:
-
billTo
-
ownerAccountNumber
-
-
In the request body of the "Update order line items" operation, added the following fields:
-
orderLineItems
>billTo
-
orderLineItems
>ownerAccountNumber
-
-
In the response body of each of the following operations:
- Update order line items
- Retrieve an order line item
Added the following fields:
-
orderLineItem
>billTo
-
orderLineItem
>billToSnapshotId
-
orderLineItem
>ownerAccountId
-
orderLineItem
>ownerAccountNumber
-
orderLineItem
>ownerAccountName
-
orderLineItem
>invoiceOwnerAccountId
-
orderLineItem
>invoiceOwnerAccountNumber
-
orderLineItem
>invoiceOwnerAccountName
-
In the request body of the "Update an order line item" operation, changed the behavior of the
soldTo
field. -
In the request body of the "Update order line items" operation, changed the behavior of the
orderLineItems
>soldTo
field. -
In the response body of each of the following operations, changed the behavior of the
orderLineItem
>soldTo
field:- Update order line items
- Retrieve an order line item
-
In the request body of the "Update an order line item" operation, added the following fields:
-
Communication Profiles
- In the 200 response body of the "CRUD: Retrieve a communication profile" operation, added the
ProfileNumber
field. This change applies to the Older API Reference.
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
Doc updates for clarifying the maximum length for the accountHolderName field
The following items are the documentation updates specific to clarifying a maximum of 60 characters are allowed for the accountHolderName
field:
-
In the request body of the "Create an account" operation, updated the description of the
paymentMethod
>accountHolderInfo
>accountHolderName
field. -
In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
Updated the description of each of the following fields:
-
newAccount
>paymentMethod
>accountHolderInfo
>accountHolderName
-
subscriptions
>orderActions
>createSubscription
>newSubscriptionOwnerAccount
>paymentMethod
>accountHolderInfo
>accountHolderName
-
In the request body of the "Create a payment method" operation, updated the description of the
accountHolderInfo
>accountHolderName
field.
Doc updates for the accountNumber field in memo API operations
The following items are the documentation updates specific to the accountNumber
field in credit memo and debit memo API operations, available only if you have the Invoice Settlement feature enabled.
-
In the request body of the "Create a credit memo from a charge" operation, changed the
accountId
field from required to conditionally required. -
In the request body of the "Create credit memos" operation, updated the
memos
>accountId
field from required to conditionally required. -
In the 200 response body and sample of each of the following operations, added the missing
memos
>accountNumber
field with its value.- Create credit memos
- Update credit memos
- Create debit memos
- Update debit memos
-
In the 200 response body and sample of each of the following operations, added the missing
accountNumber
field with its value:- Create a credit memo from a charge
- Create a credit memo from an invoice
- Retrieve a credit memo
- Update a credit memo
- Apply a credit memo
- Unapply a credit memo
- Cancel a credit memo
- Post a credit memo
- Unpost a credit memo
- Create a debit memo from a charge
- Create a debit memo from an invoice
- Retrieve a debit memo
- Update a debit memo
- Cancel a debit memo
- Post a debit memo
- Unpost a debit memo
-
In the 200 response body and sample of the "List credit memos" operation, added the missing
creditmemos
>accountNumber
field with its value. -
In the 200 response body and sample of the "List debit memos" operation, added the missing
debitmemos
>accountNumber
field with its value.
Doc updates for the Orders feature
The following items are the documentation updates specific to the Orders feature.
- Updated the description of the "Update an order" operation for better clarity.
-
In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
- Update an order
Updated the description of each of the following fields for better clarity:
-
subscriptions
>orderActions
>addProduct
-
subscriptions
>orderActions
>updateProduct
-
subscriptions
>orderActions
>removeProduct
-
In the response body of each of the following operations:
- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
Updated the description of each of the following fields for better clarity:
-
orders
>subscriptions
>orderActions
>addProduct
-
orders
>subscriptions
>orderActions
>updateProduct
-
orders
>subscriptions
>orderActions
>removeProduct
-
In the response body of the "Retrieve an order" operation, updated the description of each of the following fields for better clarity:
-
order
>subscriptions
>orderActions
>addProduct
-
order
>subscriptions
>orderActions
>updateProduct
-
order
>subscriptions
>orderActions
>removeProduct
-
-
In the request body of each of the following operations, updated the description of the
processingOptions
field for better clarity:- Create an order
- Create an order asynchronously
- Update an order
-
In the request body of each of the following operations, updated the description of the
previewOptions
>previewThruType
field for better clarity:- Preview an order
- Preview an order asynchronously
Other doc updates
The following items are the other general documentation updates included in this release:
- Updated the note description of the "Retry failed payment schedule items" operation because the conditions of the payment schedule items are changed.
-
In the request body of the "Upload a usage file" operation, updated the description of the
file
field for better clarity. -
In the description of the "Upload a usage file" operation, updated the description of the
UNIQUE_KEY
heading for better clarity in the Usage File Format section.
May 5, 2023
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
In the request body of the "Create a payment" operation, updated the description of the
authTransactionId
field to clarify that the Stripe v2 payment gateway integration support this field. -
In the request body of the "Create a payment" operation, added the missing
paymentMethodType
field. - Updated the note description of the "Retry failed payment schedule items" operation because the status options of the payment schedule items are changed.
-
In the request body of each of the following operations, added the missing
IsStackedDiscount
field, which is used to specify whether the discount percentage is to be calculated by stacking with other discount percentages:- CRUD: Create a product rate plan charge
- CRUD: Update a product rate plan charge
-
In the response body of the "List all product rate plans of a product" operation, added the missing
isStackedDiscount
nested field to theproductRatePlans
>productRatePlanCharges
field. -
For Settings API operations, made the following updates:
-
Added the support for the POST method to each of the following settings:
-
CreateGlobalTaxHubTaxCode
-
CreateGlobalTaxHubTaxEngine
-
-
Added the support for the GET, PUT, and DELETE methods to each of the following settings:
-
GlobalTaxHubTaxCode
-
GlobalTaxHubTaxEngine
-
See 200 response sample in JSON format and 200 response sample in CSV format.
-
Added the support for the POST method to each of the following settings:
- Updated the description of the "Reporting" section for better clarity. This change applies to the Older API Reference.
April 27, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.04.R2. For release notes for all Zuora products, see Latest releases.
-
Custom Object Definitions
- Made the following updates:
-
In each of the following operations, removed the
enableRecordMigration
field because the Deployment Manager will no longer support migrating custom object records:- List custom object definitions
- Create custom object definitions
- Retrieve a custom object definition
- Update a custom object definition
-
In the 200 response body of each of the following operations, added the
definitions
>property name
>schema
>auditable
field:- List custom object definitions
- Create custom object definitions
-
In the request body of the "Create custom object definitions" operation, added the
definitions
>property name
>auditable
field. -
In the 200 response body of the "Retrieve a custom object definition" operation, added the
schema
>auditable
field. -
In the request body and response body of the "Update a custom object definition" operation, added the
actions
>field
>auditable
field.
-
In each of the following operations, removed the
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
In the request body of each of the following operations, updated the description of the
processingOptions
field for better clarity:- Create an order
- Update an order
-
In the request body of each of the following operations, updated the description of the
subscriptions
>orderActions
>changePlan
>ratePlanId
field to clarify that the Change Plan order action supports the function of removal before future-dated removals:- Preview an order
- Preview an order asynchronously
- Create an order
- Create an order asynchronously
- Update an order
-
In the response body of each of the following operations, updated description of the
subscriptionNumbers
field for better clarity:- Create an order
- Update an order
-
In the request body of the "Update a subscription" operation, updated the description of the
change
>ratePlanId
field to clarify that the Change Plan amendment supports the function of removal before future-dated removals. -
In the request body of the "Update a subscription" operation, updated the description of the
change
>productRatePlanId
field for better clarity. - In the description of the “Create a payment schedule” operation, removed the Early Adopter note because the Payment Schedules feature has become generally available.
-
In the request body of the “Create a payment schedule” operation, updated the description of the
billingDocument
field. -
In the response body of the "List payment schedules by customer account" operation, added the missing
prepayment
field. -
In the response body of each of the following operations, updated the description of the
prepayment
field for better clarity:- Create a payment schedule
- Retrieve a payment schedule
- Add payment schedule items to a custom payment schedule
- Update a payment schedule
- Preview the result of payment schedule updates
- Cancel a payment schedule
-
In the request body of the "Create a payment schedule" operation, updated the description of the
prepayment
field for better clarity. - Renamed the Flexible Billing feature to Flexible Billing Attributes in all related operation.
-
In the request body of each of the following operations, updated the description of the
processingOptions
>applyCredit
field:- Create an order
- Create an order asynchronously
-
In the request body of each of the following operations, updated the description of the
applyCredit
field:- Cancel a subscription
- Create a subscription
- Renew a subscription
- Resume a subscription
- Suspend a subscription
- Update a subscription
-
In the request body of the “Amend” action in the Older API Reference, updated the description of the
requests
>AmendOptions
>ApplyCredit
field. -
In the request body of the “Subscribe” action in the Older API Reference, updated the description of the
subscribes
>SubscribeOptions
>ApplyCredit
field.
April 20, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.04.R2. For release notes for all Zuora products, see Latest releases.
API updates for the Prepaid Cash with Drawdown feature
The following items are the API updates specific to the Prepaid Cash with Drawdown feature.
-
Payments
- Made the following updates:
-
In the request body of the "Create a payment" operation, added the
prepayment
field. -
In the response body of each of the following operations, added the
prepayment
field:- Create a payment
- Update a payment
- Retrieve a payment
- Transfer a payment
- Apply a payment
- Cancel a payment
-
In the response body of the "List payments" operation, added the
payments
>prepayment
field.
-
In the request body of the "Create a payment" operation, added the
-
Payment Schedules
- Made the following updates:
-
In the request body of the "Create a payment schedule" operation, added the
prepayment
field. -
In the request body of the "Create multiple payment schedules at once" operation, added the
paymentSchedules
>prepayment
field. -
In the response body of each of the following operations, added the
prepayment
field:- Create a payment schedule
- List payment schedules by customer account
- Retrieve a payment schedule
- Update a payment schedule
- Preview the result of payment schedule updates
- Cancel a payment schedule
- Add payment schedule items to a custom payment schedule
-
In the request body of the "Create a payment schedule" operation, added the
-
Subscriptions
- In the request body of the "Create a subscription" operation, added the
prepayment
field. -
Accounts
- In the response body of the "Retrieve an account" operation, added the
metrics
>reservedPaymentAmount
field.
Other API updates
The following items are the other general API updates included in this release:
-
Accounts
- Made the following updates:
-
In the response body of the "List payment methods of an account" operation, updated the description of each of the following fields for a system behavior change:
-
returnedPaymentMethodTyp
>appleCardType
-
returnedPaymentMethodTyp
>googleCardTyp
-
-
In the response body of the "Retrieve the default payment method of an account" operation, updated the description of each of the following fields for a system behavior change:
-
appleCardType
-
googleCardTyp
-
-
In the response body of the "List payment methods of an account" operation, updated the description of each of the following fields for a system behavior change:
-
Payment Methods
- In the response body of the "Retrieve a payment method" operation, updated the description of each of the following fields for a system behavior change:
-
appleCardType
-
googleCardTyp
-
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
In the request body of each of the following operations, updated the description of the
subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
field for better clarity:- Create an order
- Create an order asynchronously
- Update an order
- Moved the "Mass Updater" section from the Older API Reference to REST API Reference.
- In the description of the "List records for a custom object" operation, clarified the scenarios where you might confront a latency when retrieving custom object records.
-
In the request body of the "Sign up" operation, updated the description of each of the following fields for better clarity:
-
customFields
>property name *
-
accountData
>customFields
>property name *
-
subscriptionData
>customFields
>property name *
-
-
In the response body of each of the following operations:
- Retrieve a payment method
- Retrieve the default payment method of an account
Added the following missing fields:
-
googleGatewayToken
-
googleCardType
-
googleCardNumber
-
googleBIN
-
googleExpiryDate
-
appleGatewayToken
-
appleCardType
-
appleCardNumber
-
appleBIN
-
appleExpiryDate
-
In the response body of the "List payment methods of an account" operation, added the following missing fields:
-
returnedPaymentMethodTyp
>googleGatewayToken
-
returnedPaymentMethodTyp
>googleCardTyp
-
returnedPaymentMethodTyp
>googleCardNumber
-
returnedPaymentMethodTyp
>googleBIN
-
returnedPaymentMethodTyp
>googleExpiryDate
-
returnedPaymentMethodTyp
>appleGatewayToken
-
returnedPaymentMethodTyp
>appleCardType
-
returnedPaymentMethodTyp
>appleCardNumber
-
returnedPaymentMethodTyp
>appleBIN
-
returnedPaymentMethodTyp
>appleExpiryDate
-
-
In the response body of each of the following operations:
- Create an invoice schedule
- Update an invoice schedule
- Retrieve an invoice schedule
Added the following missing fields:
-
actualAmount
-
scheduleItems
>actualAmount
-
In the response body of each of the following operations:
- Create an invoice schedule
- Update an invoice schedule
- Retrieve an invoice schedule
Updated the description of each of the following fields for better clarity:
-
totalAmount
-
scheduleItems
>amount
-
In the response body of each of the following operations, updated the description of the
invoiceScheduleId
field for better clarity:- Retrieve a subscription by key
- Retrieve a subscription by key and version
-
In the response body of the "List subscriptions by account key" operation, updated the description of the
subscriptions
>invoiceScheduleId
field for better clarity. - In each of the Orders operations, updated the general availability note about the Orders feature.
- In each of the Order Line Items operations, removed the general availability note about the Orders feature.
-
In the source YAML file of each of the following operations:
- List payment methods of an account
- Retrieve the default payment method of an account
Made the following changes:
-
Renamed the
GETPMAccountHolderInfo
definition toGETAccountPMAccountHolderInfo
. -
Renamed the
POSTPMMandateInfo
definition toPOSTAccountPMMandateInfo
.
-
In each of the Custom Object Records operations, added the length of the
Id
field. -
In each of the following operations, added the length of the
id
path parameter:- Retrieve a custom object record
- Update a custom object record
- Partially update a custom object record
- Delete a custom object record
-
In the description of the
ids
query parameter of the "List records for a custom object" operation, clarified that each ID must be a string of 36 characters.
April 14, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.04.R2. For release notes for all Zuora products, see Latest releases.
-
Orders
- Made the following updates:
-
In the request body of each of the following operations, added the
refundReasonCode
nested field to theprocessingOptions
field:- Create an order
- Update an order
-
In the response body of each of the "Create an order" and "Update an order" operations, added the following fields:
-
refunds
>refundInvoiceNumbers
-
writeOff
>writeOffCreditMemoNumber
-
-
In the request body of each of the following operations, added the
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
In the request body of the "Create a payment run" operation, updated the description of the
applyCreditBalance
field for better clarity. -
In the request body of each of the following operations, updated the description of the
newAccount
>paymentTerm
field for better clarity:- Create an order
- Create an order asynchronously
- Update an order
-
In the request body of the "Create an account" operation, updated the description of the
paymentTerm
field for better clarity. -
In the request body of the "Create an Apple Pay payment method" operation, updated the description of each of the following fields to clarify the payment gateway integrations that support the field:
-
mitConsentAgreementSrc
-
mitProfileAction
-
mitProfileType
-
- In the description of the "Update an order" operation, added a note to clarify that this operation does not support auto-refund and invoice write-off during subscription cancellation.
- Updated the description of the "Configuration Templates" section as the feature is now generally available to all Zuora customers.
April 10, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.04.R1. For release notes for all Zuora products, see Latest releases.
API updates for the Flexible Billing feature
The following items are the API updates specific to the Flexible Billing feature.
-
Credit Memos
- Made the following updates:
-
In the response body of the "Retrieve a credit memo item" operation, added the following fields:
-
soldToContactId
-
soldToContactSnapshotId
-
-
In the response body of the "List credit memo items" operation, added the following fields:
-
items
>soldToContactId
-
items
>soldToContactSnapshotId
-
-
In the response body of the "Retrieve a credit memo item" operation, added the following fields:
-
Debit Memos
- Made the following updates:
-
In the response body of the "Retrieve a debit memo item" operation, added the following fields:
-
soldToContactId
-
soldToContactSnapshotId
-
-
In the response body of the "List debit memo items" operation, added the following fields:
-
items
>soldToContactId
-
items
>soldToContactSnapshotId
-
-
In the response body of the "Retrieve a debit memo item" operation, added the following fields:
-
Invoices
- In the response body of the "List all items of an invoice" operation, added the following fields:
-
invoiceItems
>soldToContactId
-
invoiceItems
>soldToContactSnapshotId
-
-
Orders
- Made the following updates:
-
In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
- Preview an order
- Preview an order asynchronously
- Update an order
Added the following fields:
-
subscriptions
>orderActions
>createSubscription
>soldToContactId
-
subscriptions
>orderActions
>ownerTransfer
>soldToContactId
-
subscriptions
>orderActions
>ownerTransfer
>clearingExistingSoldToContact
-
subscriptions
>orderActions
>renewSubscription
>soldToContactId
-
subscriptions
>orderActions
>renewSubscription
>clearingExistingSoldToContact
-
subscriptions
>orderActions
>termsAndConditions
>soldToContactId
-
subscriptions
>orderActions
>termsAndConditions
>clearingExistingSoldToContact
-
In the response body of the "Retrieve an order" operation, added the following fields:
-
order
>subscriptions
>orderActions
>createSubscription
>soldToContactId
-
order
>subscriptions
>orderActions
>ownerTransfer
>soldToContactId
-
order
>subscriptions
>orderActions
>ownerTransfer
>clearingExistingSoldToContact
-
order
>subscriptions
>orderActions
>renewSubscription
>soldToContactId
-
order
>subscriptions
>orderActions
>renewSubscription
>clearingExistingSoldToContact
-
order
>subscriptions
>orderActions
>termsAndConditions
>soldToContactId
-
order
>subscriptions
>orderActions
>termsAndConditions
>clearingExistingSoldToContact
-
-
In the response body of each of the following operations:
- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
Added the following fields:
-
orders
>subscriptions
>orderActions
>createSubscription
>soldToContactId
-
orders
>subscriptions
>orderActions
>ownerTransfer
>soldToContactId
-
orders
>subscriptions
>orderActions
>ownerTransfer
>clearingExistingSoldToContact
-
orders
>subscriptions
>orderActions
>renewSubscription
>soldToContactId
-
orders
>subscriptions
>orderActions
>renewSubscription
>clearingExistingSoldToContact
-
orders
>subscriptions
>orderActions
>termsAndConditions
>soldToContactId
-
orders
>subscriptions
>orderActions
>termsAndConditions
>clearingExistingSoldToContact
-
In the request body of each of the following operations:
-
Subscriptions
- Made the following updates:
-
In the response body of each of the following operations, add the
soldToContact
field and its nested fields:- Retrieve a subscription by key
- Retrieve a subscription by key and version
-
In the response body of the "List subscriptions by account key" operation, add the
soldToContact
field and its nested fields to thesubscriptions
field.
-
In the response body of each of the following operations, add the
Other API updates
The following items are the other general API updates included in this release:
- Contact Snapshots - Added a resource called "Contact Snapshots", with the "Retrieve a contact snapshot" operation.
-
Orders
- In the request body of each of the following operations, added the
generateDraftInvoice
nested field to theprocessingOptions
>billingOptions
field:- Create an order
- Create an order asynchronously
- Update an order
-
Payments
- In the request body of the "Create a payment" operation, updated the description of the
mitTransactionSource
field for the support of MOTO transactions. -
Payment Authorization
- In the request body of the "Create authorization" operation, updated the description of the
mitTransactionSource
field for the support of MOTO transactions.
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
- Sorted all sections based on business logic and areas.
-
Created a new section called "Payment Authorization" that contains the following operations:
- Create an authorization
- Cancel an authorization
Previously, the preceding operations were in the "Payment Methods" section.
-
In the request body of each of the following operations, updated the description of the
processingOptions
field for better clarity:- Create an order
- Create an order asynchronously
- Update an order
-
In the request body of each of the following operations, added the missing
subscriptionOfferUniqueToken
nested field to thesubscriptions
>orderActions
>createSubscription
>subscribeToProducts
field:- Create an order
- Create an order asynchronously
- Update an order
- In the request body of the "Upload a file for a custom object bulk job" operation, clarified that the uploaded file must be encoded in UTF-8.
-
In the request body of the "Submit a data query" operation, updated the description of the
readDeleted
field by clarifying an exception when using this field.
March 31, 2023
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
Doc updates for canceling subscriptions with a refund and write-off
The following items are the documentation updates specific to canceling subscriptions with a refund and write-off:
-
In the request body of the "Create an order" operation, updated the description of the
processingOptions
field to clarify the following two behaviors:- The operation partially succeeds even if a refund or write-off fails.
- The cases in which the operation rolls back.
-
In the request body of the "Create an order" operation, updated the descriptions of the
processingOptions
>refund
andprocessingOptions
>writeOff
fields.
Doc updates for the Delivery Pricing charge model
The following items are the documentation updates specific to the Delivery Pricing charge model:
-
In the response body of the "Retrieve a rate plan" operation, added the following missing fields:
-
order
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringDelivery
-
order
>orderActions
>updateProduct
>chargeUpdates
>pricing
>recurringDelivery
-
-
In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
- Update an order
Added the following missing fields:
-
subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringDeliveryBased
-
subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringDeliveryBased
-
subscriptions
>orderActions
>updateProduct
>chargeUpdates
>pricing
>recurringDeliveryBased
-
In the response body of each of the following operations:
- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
Added the following missing fields:
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringDelivery
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringDelivery
-
orders
>subscriptions
>orderActions
>updateProduct
>chargeUpdates
>pricing
>recurringDelivery
-
In the response body of the "Retrieve an order" operation, added the following missing fields:
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringDelivery
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringDelivery
-
order
>subscriptions
>orderActions
>updateProduct
>chargeUpdates
>pricing
>recurringDelivery
-
Other doc updates
The following items are the other general documentation updates included in this release:
-
In the description of the "Create an account" operation, updated the note on the
invoiceDeliveryPrefsEmail
field for better clarity. -
In the source YAML file, renamed the
TaxInfo
definition toSignUpTaxInfo
in the "Sign up" operation. -
For each of the following operations, updated the description of each of request and response fields:
- Create a price book item
- Update a price book item
- List all price book items
- Retrieve a price book item
- Delete a price book item
-
In the "Minor Version History" table of the "API Versions" section, updated minor version from
196.0
to206.0
for the following fields:-
includeExistingDraftInvoiceItems
-
previewType
-
invoiceTargetDate
-
-
In the request body of each of the "Preview a subscription" and "Update a subscription" operations, added minor version
206.0
to the description of each of the following fields:-
includeExistingDraftInvoiceItems
-
previewType
-
-
In the request body and response body of the "Preview a subscription" operation, added minor version
206.0
to the description of theinvoiceTargetDate
field.
March 24, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.03.R2. For release notes for all Zuora products, see Latest releases.
API updates for the Offers feature
The following items are the API updates specific to the Offers feature.
-
Offers
- Added a resource called "Offers", with the following operations:
- Create an offer
- List all offers
- Retrieve an offer
- Delete an offer
-
Price Book Items
- Added a resource called "Price Book Items", with the following operations:
- Create a price book item
- Update a price book item
- List all price book items
- Retrieve a price book item
- Delete a price book item
API updates for the Delivery Pricing charge model
The following items are the API updates specific to the Delivery Pricing charge model.
-
Product Rate Plan Charges
- In the request body of each of the following operations:
- CRUD: Create a product rate plan charge
- CRUD: Update a product rate plan charge
Made the following updates:
-
Added the
DeliverySchedule
field and its nested fields. -
Added the
Delivery Pricing
enum value to theChargeModel
field.
-
Product Rate Plans
- In the response body of the “List product rate plans” operation, made the following updates:
-
Added the
productRatePlans
>productRatePlanCharges
>deliverySchedule
field and its nested fields. -
Added the
Delivery
enum value to theproductRatePlans
>productRatePlanCharges
>model
field.
-
Added the
Other API updates
The following items are the other general API updates included in this release:
-
Accounts
- In the request body of the "Create an account" operation, added the following fields:
-
paymentMethod
>ipAddress
-
paymentMethod
>accountHolderInfo
>country
-
-
Orders
- In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
- Update an order
Added the following fields:
-
newAccount
>paymentMethod
>ipAddress
-
newAccount
>paymentMethod
>accountHolderInfo
>country
-
subscriptions
>orderActions
>createSubscription
>newSubscriptionOwnerAccount
>paymentMethod
>ipAddress
-
subscriptions
>orderActions
>createSubscription
>newSubscriptionOwnerAccount
>paymentMethod
>accountHolderInfo
>country
-
Payment Methods
- In the request body of each of the following operations:
- Create a payment method
- Update a payment method
Added the following fields:
-
ipAddress
-
accountHolderInfo
>country
-
Sign Up
- In the request body of the "Sign up" operation, added the
ipAddress
nested field to thenewAccount
>paymentMethod
field.
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
In the source YAML file, made the following changes to the "Sign up" operation:
-
Renamed the
PaymentMethod
definition toSignUpPaymentMethod
. -
Renamed the
CreatePaymentMethodCreditCardReferenceTransaction
definition toSignUpCreatePaymentMethodCreditCardReferenceTransaction
. -
Renamed the
CreatePMPayPalECPayPalNativeEC
definition toSignUpCreatePMPayPalECPayPalNativeEC
. -
Renamed the
CreatePaymentMethodPayPalAdaptive
definition toSignUpCreatePaymentMethodPayPalAdaptive
. -
Renamed the
CreatePaymentMethodCreditCard
definition toSignUpCreatePaymentMethodCreditCard
. -
Renamed the
CreatePaymentMethodCommon
definition toCreatePaymentMethodCommon
. -
Renamed the
PaymentMethodObjectCustomFields
definition toSignUpPaymentMethodObjectCustomFields
. -
Renamed the
CreatePaymentMethodCardholderInfo
definition toSignUpCreatePaymentMethodCardholderInfo
.
-
Renamed the
-
In the request body of each of the following operations, aligned descriptions of the fields for creating stored credential profiles:
- Create a payment method
- Create a stored credential profile
-
In the description of the "Retrieve a rate plan" operation, added a note to clarify that you can only retrieve information about the following order actions:
-
addProduct
-
updateProduct
-
removeProduct
-
changePlan
-
- Updated the limitations for the "Delete an account" operation.
-
In the request body of the "Create an order" operation, updated the refunding requirements in the description of the
processingOptions
>refund
field.
March 17, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.03.R1. For release notes for all Zuora products, see Latest releases.
-
Adjustments
- In the request body of each of the following operations, added the
chargeNumbers
field:- Create an adjustment
- Preview an adjustment
-
Orders
- Made the following updates:
-
In the request body of each of the following operations:
- Preview an order
- Preview an order asynchronously
Added the following fields and their nested fields:
-
subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringFlatFee
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringPerUnit
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringTiered
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringVolume
>priceIntervals
-
subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>priceIntervals
-
subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>priceIntervals
-
subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>priceIntervals
-
subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>priceIntervals
-
In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
- Update an order
Added the following fields and their nested fields:
-
subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringFlatFee
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringPerUnit
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringTiered
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringVolume
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringDeliveryBased
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringFlatFee
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringPerUnit
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringTiered
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringVolume
>priceIntervals
-
subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringDeliveryBased
>priceIntervals
-
subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>priceIntervals
-
subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>priceIntervals
-
subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>priceIntervals
-
subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>priceIntervals
-
In the response body of each of the following operations:
- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
Added the following fields and their nested fields:
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringFlatFee
>priceIntervals
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringPerUnit
>priceIntervals
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringTiered
>priceIntervals
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringVolume
>priceIntervals
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringFlatFee
>priceIntervals
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringPerUnit
>priceIntervals
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringTiered
>priceIntervals
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringVolume
>priceIntervals
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>priceIntervals
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>priceIntervals
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>priceIntervals
-
orders
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>priceIntervals
-
In the response body of the "Retrieve an order" operation, added the following fields and their nested fields:
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringFlatFee
>priceIntervals
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringPerUnit
>priceIntervals
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringTiered
>priceIntervals
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
>chargeOverrides
>pricing
>recurringVolume
>priceIntervals
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringFlatFee
>priceIntervals
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringPerUnit
>priceIntervals
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringTiered
>priceIntervals
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToRatePlans
>chargeOverrides
>pricing
>recurringVolume
>priceIntervals
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringFlatFee
>priceIntervals
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringPerUnit
>priceIntervals
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringTiered
>priceIntervals
-
order
>subscriptions
>orderActions
>addProduct
>chargeOverrides
>pricing
>recurringVolume
>priceIntervals
-
- In the description of the "Create an order" operation, deleted a limitation for draft orders.
-
In the request body of each of the following operations:
-
Subscriptions
- Made the following updates:
-
In the request body of the "Update a subscription" operation, added the following fields:
-
bookingDate
-
add
>bookingDate
-
change
>bookingDate
-
remove
>bookingDate
-
update
>bookingDate
-
-
In the request body of each of the following operations, added the
bookingDate
field:- Cancel a subscription
- Resume a subscription
- Suspend a subscription
-
In the request body of the "Update a subscription" operation, added the following fields:
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
Doc updates for passing in email information when creating payment methods
The following items are the documentation updates specific to the clarification that the email
field is only supported for creating PayPal payment methods:
-
In the request body of the "Create a payment method" operation, updated the description of the
email
field. -
In the request body of the "Create an account" operation, updated the description of the
paymentMethod
>email
field. -
In the request body of the "Sign up" operation, updated the description of the
accountData
>paymentMethod
>email
field. -
In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
Updated the description of each of the following fields:
-
newAccount
>paymentMethod
>email
-
subscriptions
>orderActions
>createSubscription
>newSubscriptionOwnerAccount
>paymentMethod
>email
Other doc updates
The following items are the other general documentation updates included in this release:
-
In the request body of the "Update a payment method" operation, updated the description of each of the following fields to clarify that the field is not supported for updating Credit Card Reference Transaction payment methods:
-
authGateway
-
gatewayOptions
-
accountHolderInfo
- Custom fields
-
-
In the request body of each of the following operations, added descriptions for the
subscriptions
>orderActions
>updateProduct
>chargeUpdates
>pricing
field and its nested fields:- Create an order
- Create an order asynchronously
-
In the response body of each of the following operations, added descriptions for the
orders
>subscriptions
>orderActions
>updateProduct
>chargeUpdates
>pricing
field and its nested fields:- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
-
For each of the following operations, added the missing
exclude-rate-plans-with-no-charges
query parameter:- List subscriptions by account key
- Retrieve a subscription by key
- Retrieve a subscription by key and version
-
In the response body of the "Retrieve an order" operation, added descriptions for the
order
>subscriptions
>orderActions
>updateProduct
>chargeUpdates
>pricing
field and its nested fields. -
In the source YAML file, added the
CreateOfferRatePlanOverride
definition, and updated the request body schema reference of each of the following operations to this definition:- Create an order
- Update an order
-
In the source YAML file, added the
GetOfferRatePlanOverride
definition, and updated the request body schema reference of each of the following operations to this definition:- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
-
In the source YAML file, added the
GetOfferRatePlanUpdate
definition, and updated the request body schema reference of each of the following operations to this definition:- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
-
In the response body of the "Retrieve an invoice" operation, updated the description of the
templateId
field for better clarity.
March 10, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.03.R1. For release notes for all Zuora products, see Latest releases.
API updates for the Offers feature
The following items are the API updates specific to the Offers feature.
-
Orders
- Made the following updates:
-
In the request body of each of the following operations:
- Create an order
- Create an order asynchronously
- Update an order
Added the following fields:
-
subscriptions
>orderActions
>createSubscription
>subscribeToProducts
-
subscriptions
>orderActions
>addProduct
>productOfferId
-
subscriptions
>orderActions
>addProduct
>productOfferNumber
-
subscriptions
>orderActions
>addProduct
>ratePlanOverrides
-
subscriptions
>orderActions
>updateProduct
>subscriptionOfferNumber
-
subscriptions
>orderActions
>updateProduct
>subscriptionOfferId
-
subscriptions
>orderActions
>updateProduct
>subscriptionOfferUniqueToken
-
subscriptions
>orderActions
>updateProduct
>ratePlanUpdates
-
subscriptions
>orderActions
>removeProduct
>subscriptionOfferNumber
-
subscriptions
>orderActions
>removeProduct
>subscriptionOfferId
-
subscriptions
>orderActions
>removeProduct
>subscriptionOfferUniqueToken
-
In the response body of each of the following operations:
- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
Added the following fields:
-
orders
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
-
orders
>subscriptions
>orderActions
>addProduct
>productOfferId
-
orders
>subscriptions
>orderActions
>addProduct
>productOfferNumber
-
orders
>subscriptions
>orderActions
>addProduct
>newSubscriptionOfferId
-
orders
>subscriptions
>orderActions
>addProduct
>newSubscriptionOfferNumber
-
orders
>subscriptions
>orderActions
>addProduct
>subscriptionOfferUniqueToken
-
orders
>subscriptions
>orderActions
>addProduct
>ratePlanOverrides
-
orders
>subscriptions
>orderActions
>updateProduct
>subscriptionOfferId
-
orders
>subscriptions
>orderActions
>updateProduct
>productOfferNumber
-
orders
>subscriptions
>orderActions
>updateProduct
>subscriptionOfferNumber
-
orders
>subscriptions
>orderActions
>updateProduct
>subscriptionOfferUniqueToken
-
orders
>subscriptions
>orderActions
>updateProduct
>ratePlanUpdates
-
orders
>subscriptions
>orderActions
>removeProduct
>subscriptionOfferId
-
orders
>subscriptions
>orderActions
>removeProduct
>subscriptionOfferNumber
-
orders
>subscriptions
>orderActions
>removeProduct
>subscriptionOfferUniqueToken
-
In the response body of the "Retrieve an order" operation, added the following fields:
-
order
>subscriptions
>orderActions
>createSubscription
>subscribeToProducts
-
order
>subscriptions
>orderActions
>addProduct
>productOfferId
-
order
>subscriptions
>orderActions
>addProduct
>productOfferNumber
-
order
>subscriptions
>orderActions
>addProduct
>newSubscriptionOfferId
-
order
>subscriptions
>orderActions
>addProduct
>newSubscriptionOfferNumber
-
order
>subscriptions
>orderActions
>addProduct
>subscriptionOfferUniqueToken
-
order
>subscriptions
>orderActions
>addProduct
>ratePlanOverrides
-
order
>subscriptions
>orderActions
>updateProduct
>subscriptionOfferId
-
order
>subscriptions
>orderActions
>updateProduct
>productOfferNumber
-
order
>subscriptions
>orderActions
>updateProduct
>subscriptionOfferNumber
-
order
>subscriptions
>orderActions
>updateProduct
>subscriptionOfferUniqueToken
-
order
>subscriptions
>orderActions
>updateProduct
>ratePlanUpdates
-
order
>subscriptions
>orderActions
>removeProduct
>subscriptionOfferId
-
order
>subscriptions
>orderActions
>removeProduct
>subscriptionOfferNumber
-
order
>subscriptions
>orderActions
>removeProduct
>subscriptionOfferUniqueToken
-
-
In the request body of each of the following operations:
-
Subscriptions
- Made the following updates:
-
In the response body of the "List subscriptions by account key" operation, added the
subscriptions
>offers
field. -
In the response body of each of the following operations, added the
offers
field:- Retrieve a subscription by key
- Retrieve a subscription by key and version
-
In the response body of the "List subscriptions by account key" operation, added the
API updates for the Delivery Pricing charge model
The following items are the API updates specific to the Delivery Pricing charge model.
-
Subscriptions
- Made the following updates:
-
In the response body of each of the following operations:
- Retrieve a subscription by key
- Retrieve a subscription by key and version
Added the following fields:
-
ratePlans
>ratePlanCharges
>deliverySchedule
-
ratePlans
>ratePlanCharges
>subscriptionChargeIntervalPricing
-
In the response body of each of the following operations, added the
Delivery
enum value to theratePlans
>ratePlanCharges
>model
field:- Retrieve a subscription by key
- Retrieve a subscription by key and version
-
In the response body of the "List subscriptions by account key" operation, added the following fields:
-
subscriptions
>ratePlans
>ratePlanCharges
>deliverySchedule
-
subscriptions
>ratePlans
>ratePlanCharges
>subscriptionChargeIntervalPricing
-
-
In the response body of the "List subscriptions by account key" operation, added the
Delivery
enum value to thesubscriptions
>ratePlans
>ratePlanCharges
>model
field.
-
In the response body of each of the following operations:
API updates for the Scheduled Orders feature
The following items are the API updates specific to the Scheduled Orders feature.
-
Orders
- Made the following updates:
- In the description of the "Cancel an order" operation, added a note to clarify that cancellation is only valid for draft or scheduled orders.
-
In the description of each of the following operations, added a note to clarify that you cannot retrieve detailed information about draft orders or scheduled orders through this operation:
- List orders of a subscription owner
- List orders of an invoice owner
-
In the request body of each of the following operations, added the
status
andschedulingOptions
fields:- Create an order
- Update an order
-
In the response body of each of the following operations:
- List orders
- List orders by subscription number
Made the following updates:
-
Added the
Scheduled
,Executing
, andFailed
enum values to theorders
>status
field. -
Added the
orders
>schedulingOptions
field.
-
In the response body of the "Retrieve an order" operation, made the following updates:
-
Added the
Scheduled
,Executing
, andFailed
enum values to thestatus
field. -
Added the
schedulingOptions
field.
-
Added the
API updates for the Adjustments feature
The following items are the API updates specific to the Adjustments feature.
-
Adjustments
- Added a resource called "Adjustments", with the following operations:
- Create an adjustment
- List all adjustments of the latest version subscription
- Retrieve an adjustment
- Preview an adjustment
- Cancel an adjustment
Other API updates
The following items are the other general API updates included in this release:
-
Subscriptions
- In the request body and response body of the "Preview a subscription" operation, added the
documentDate
field. - Order Actions - Added an API operation called "Update an order action".
-
Accounts
- Made the following updates:
-
In the response body of the "Retrieve an account" operation, added the
autoPay
field nested field to thebillingAndPayment
field. -
In the response body of the "Retrieve an account summary" operation, added the
autoPay
field nested field to thebasicInfo
field.
-
In the response body of the "Retrieve an account" operation, added the
-
Credit Memos
- Made the following updates:
-
In the response body of each of the following operations, added the
billToContactSnapshotId
field:- Create a credit memo from a charge
- Create a credit memo from an invoice
- Retrieve a credit memo
- Update a credit memo
- Apply a credit memo
- Unapply a credit memo
- Cancel a credit memo
- Post a credit memo
- Unpost a credit memo
-
In the response body of each of the following operations, added the
billToContactSnapshotId
nested field to thememos
field:- Create credit memos
- Update credit memos
-
In the response body of the "List credit memos" operation, added the
billToContactSnapshotId
nested field to thecreditmemos
field.
-
In the response body of each of the following operations, added the
-
Debit Memos
- Made the following updates:
-
In the response body of each of the following operations, added the
billToContactSnapshotId
field:- Create a debit memo from a charge
- Create a debit memo from an invoice
- Retrieve a debit memo
- Update a debit memo
- Cancel a debit memo
- Post a debit memo
- Unpost a debit memo
-
In the response body of each of the following operations, added the
billToContactSnapshotId
nested field to thememos
field:- Create debit memos
- Update debit memos
-
In the response body of the "List debit memos" operation, added the
billToContactSnapshotId
nested field to thedebitmemos
field.
-
In the response body of each of the following operations, added the
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
In the request body of the "Update a subscription" operation, updated the description of each of the following fields to state that the field is not updatable:
-
add
>chargeOverrides
>originalOrderDate
-
change
>chargeOverrides
>originalOrderDate
-
-
In the request body of each of the following operations, updated the description of the
processingOptions
>applyCredit
field for better clarity:- Create an order
- Create an order asynchronously
- Update an order
March 3, 2023
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
In the request body of each of the following operations, added a limitation on the Change Plan order action in the description of the
subscriptions
>orderActions
>changePlan
>effectivePolicy
field.:- Preview an order
- Preview an order asynchronously
- Create an order
- Create an order asynchronously
- Update an order
-
In the request body of the "Update a subscription" operation, added a limitation on the Change Plan amendment in the description of the
change
>effectivePolicy
field. -
In the request body of the "Update a subscription" operation, updated the description of the
change
>chargeOverrides
>amendedByOrderOn
field to state that the field is not updatable. -
In the request body of the "Create a payment schedule" operation, updated the description of each of the following fields:
-
runHour
-
items
>runHour
-
-
In the request body of the "Create multiple payment schedules at once" operation, updated the description of each of the following fields:
-
paymentSchedules
>runHour
-
paymentSchedules
>items
>runHour
-
-
In the request body of the "Add payment schedule items to a custom payment schedule" operation, updated the description of the
items
>runHour
field. -
In the request body of each of the following operations, updated the description of the
runHour
field:- Update a payment schedule item
- Update a payment schedule
- Preview the result of payment schedule updates
February 24, 2023
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
In the response body of the "Retrieve an order" operation, updated the description of the
order
>subscriptions
>orderActions
>updateProduct
>ratePlanId
field to clarify that the version ID of the history can also be used. -
In the request body of the "Create an account" operation, removed the unsupported
country
nested field from thepaymentMethod
>accountHolderInfo
field. -
In the request body of each of the following operations, removed the unsupported
country
nested field from thenewAcccount
>paymentMethod
>accountHolderInfo
field:- Create an order
- Create an order asynchronously
-
In the request body of each of the following operations, removed the unsupported
country
nested field from theaccountHolderInfo
field:- Create a payment method
- Update a payment method
-
In the source YAML file, added the
PUTOrderRequestType
definition, and updated the request body schema reference of the "Update an order" operation to this definition. -
In the source YAML file, renamed the
PaymentMethod
definition toPostOrderAccountPaymentMethod
for the following operations:- Create an order
- Create an order asynchronously
February 21, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.02.R2. For release notes for all Zuora products, see Latest releases.
-
Bill Runs
- In the response body of each of the following operations, added the
name
field:- Create a bill run
- Post a bill run
- Cancel a bill run
- Retrieve a bill run
The following API updates are available as of Zuora Release 2023.02.R1.
-
Usage
- In the response body of the "Retrieve a usage record" operation, added the
fileName
field.
API updates for the paymentOption field
The following items are the API updates specific to the paymentOption
field that is only available if you set zuora-version
to 337.0
or later.
-
Payment Schedules
- Made the following updates:
-
In the request body and response body of each of the following operations, added the
paymentOption
field:- Create a payment schedule
- Preview the result of payment schedule update
- Update a payment schedule
- Update a payment schedule item
-
In the request body and response body of each of the following operations, added the
paymentOption
nested field to theitems
field:- Add payment schedule items to a custom payment schedule
- Create a payment schedule
-
In the request body of the "Create multiple payment schedules at once" operation, added the
paymentOption
nested field to each of the following fields:-
paymentSchedules
-
paymentSchedules
>items
-
-
In the response body of each of the following operations, added the
paymentOption
field:- Cancel a payment schedule
- Cancel a payment schedule item
- List payment schedules by customer account
- Retrieve a payment schedule
- Retrieve a payment schedule item
- Skip a payment schedule item
-
In the response body of each of the following operations, added the
paymentOption
nested field to theitems
field:- Cancel a payment schedule
- List payment schedules by customer account
- Preview the result of payment schedule update
- Retrieve a payment schedule
- Retry failed payment schedule items
- Update a payment schedule
-
In the "Create a payment schedule" operation, added the following fields to the description of the
zuora-version
request header:-
paymentOption
-
items
>paymentOption
-
-
In the "Create multiple payment schedules at once" operation, added the following fields to the description of the
zuora-version
request header:-
paymentSchedules
>paymentOption
-
paymentSchedules
>items
>paymentOption
-
-
In each of the following operations, added the
paymentOption
field to the description of thezuora-version
request header:- Update a payment schedule item
- Update a payment schedule
- Preview the result of payment schedule update
- Retrieve a payment schedule
- Retrieve a payment schedule item
- List payment schedules by customer account
- Cancel a payment schedule
- Cancel a payment schedule item
- Skip a payment schedule item
-
In each of the following operations, added the
items
>paymentOption
field to the description of thezuora-version
request header:- Add payment schedule items to a custom payment schedule
- Retry failed payment schedule items
- Retrieve a payment schedule
- Cancel a payment schedule
-
In the request body and response body of each of the following operations, added the
-
Payments
- Made the following updates:
-
For the "Create a payment" operation, made the following updates:
-
In the request body and response body, added the
paymentOption
field. -
In the description of the
zuora-version
request header, added thepaymentOption
field.
-
In the request body and response body, added the
-
For the "List payments" operation, made the following updates:
-
In the response body, added the
paymentOption
nested field to thepayments
field. -
In the description of the
zuora-version
request header, addedpayments
>paymentOption
.
-
In the response body, added the
-
For the "Create a payment" operation, made the following updates:
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
In the response body of the "CRUD: Retrieve a bill run" operation, added the following missing enum values to the
Status
field:-
PostInProgress
-
CancelInProgress
-
RemoveInProgress
-
Paused
-
- Updated the description of the "Create an OAuth token" operation.
-
In the "API Versions" section, added the following missing fields to the "Minor Version History" table:
-
billingDocument
-
paymentId
-
linkPayments
-
unlinkPayments
-
psiPayments
-
-
In the "Update a payment schedule item" operation, added the missing
zuora-version
request header. -
In each of the following operations, added the missing fields in version control to the description of the
zuora-version
request header:- Create a payment schedule
- Create multiple payment schedules at once
- List payment schedules by customer account
- Retrieve a payment schedule
- Update a payment schedule
- Preview the result of payment schedule updates
- Cancel a payment schedule
- Add payment schedule items to a custom payment schedule
- Retrieve a payment schedule item
- Update a payment schedule item
- Cancel a payment schedule item
- Skip a payment schedule item
- Retry failed payment schedule items
-
Moved the following CRUD operations to the Older API Reference to avoid confusion:
- CRUD: Delete an account
- CRUD: Create a bill run
- CRUD: Retrieve a bill run
- CRUD: Post or cancel a bill run
- CRUD: Delete a bill run
- CRUD: Retrieve an invoice
- CRUD: Delete an invoice
-
In the request body of the "Amend" action in the Older API Reference, corrected the name of the
requests
>Amendments
>bookingDate
field torequests
>Amendments
>BookingDate
.
February 13, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.02.R1. For release notes for all Zuora products, see Latest releases.
-
Bill Runs
- Added the following operations:
- Create a bill run
- Post a bill run
- Cancel a bill run
- Retrieve a bill run
- Delete a bill run
-
Orders
- Made the following updates:
-
Added the following operations only applied to orders in
Draft
status:- Update an order
- Activate an order
- Cancel an order
-
In the request body of the "Create an order" operation, added the
status
field. -
In the response body of the "Create an order" operation, added the
Draft
enum value to thestatus
field. -
In the response body of each of the following operations, added the
Draft
enum value to theorders
>status
field:- List orders
- List orders by subscription number
- List pending orders by subscription number
-
In the response body of the "Retrieve an order" operation, added the
Draft
enum value to theorder
>status
field. -
In the description of each of the following operations, added a note to clarify that you cannot retrieve the detailed information about draft orders:
- List orders of a subscription owner
- List orders of an invoice owner
-
Added the following operations only applied to orders in
-
Custom Object Jobs
- For the "List all custom object bulk jobs" operation, added a query parameter called
status
that accepts the status of bulk jobs.
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
- In the description of the "List all settings" operation, added the following common use cases for notification definitions:
-
In the description of each of the following operations, added an alternative Settings API operation that applies to standard, custom, and custom scheduled events:
- List notification definitions
- Retrieve a notification definition
- Update a notification definition
- Delete a notification definition
-
For the "List all custom object bulk jobs" operation, removed the unsupported
page
query parameter. -
Added the "Reporting" section that contains the following operations to the Older API Reference:
- Retrieve a report run
- Cancel a report run
- Run a report
- Search reports by name
- Retrieve the last completed report run
- Retrieve report data
- Export results of a report run
Previously, these operations were documented in the Knowledge Center.
February 2, 2023
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
Relocated the following files:
- Source Swagger file: https://www.zuora.com/developer/yaml/swagger.yaml
- Settings API CSV file: https://www.zuora.com/developer/settings-api/ListAllSettingsResponseSample.csv
- Settings API JSON file: https://www.zuora.com/developer/settings-api/ListAllSettingsResponseSample.json
Previously, they were located in the assets.zuora.com domain. For information about other relocated resources, see this Community post.
-
Removed the
Idempotency-Key
header parameter from all PUT and GET methods. -
For the
AllCustomObjects
andCustomObject
settings of Settings API, corrected the name of each of the following fields by capitalizing the first letter:-
Id
-
CreatedById
-
UpdatedById
-
CreatedDate
-
UpdatedDate
-
-
In the response body of the "List all product rate plans of a product" operation, added the
ConsumptionBased
enum value back to thecreditOption
>productRatePlans
>productRatePlanCharges
field. -
In the request body of each of the following operations, added the
ConsumptionBased
enum value back to theCreditOption
field:- CRUD: Create a product rate plan charge
- CRUD: Update a product rate plan charge
-
In the response body of the "List subscriptions by account key" operation, added the
ConsumptionBased
enum value back to thesubscriptions
>ratePlans
>ratePlanCharges
>creditOption
field. -
In the response body of each of the following operations, added the
ConsumptionBased
enum value back to theratePlans
>ratePlanCharges
>creditOption
field:- Retrieve a subscription by key
- Retrieve a subscription by key and version
January 19, 2023
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
Updated the default MIME type for all operations from
application/json;charset=utf-8
toapplication/json
. -
In the request body of the "Create a payment method" operation, updated the description of the
bankAccountName
field to clarify requirements specific to the BlueSnap integration. -
In the request body of the "Create an account" operation, updated the description of the
paymentMethod
>bankAccountName
field to clarify requirements specific to the BlueSnap integration. -
In the request body of the "Create an order" operation, updated the description of the
newAccount
>paymentMethod
>bankAccountName
field to clarify requirements specific to the BlueSnap integration. - Fixed the broken links in the description of the "Payment Gateway Reconciliation" section.
-
Updated the description of each of the following operations:
- Upload a usage file
- Update an account
- List all products
- List all product rate plans of a product
- Refund a payment
- Delete a payment method
- Create a credit memo from a charge
- Create a notification definition
- Create an order
- Preview an order
- CRUD: Update a contact
- CRUD: Update a payment method
- List all invoices for an account
-
In the request body of the "CRUD: Create a product rate plan" operation, updated the description of the
ActiveCurrencies
field. -
In the response body of the "List subscriptions by account key" operation, updated the description of the
subscriptions
>ratePlans
>lastChangeType
field. -
In the response body of each of the following operations, updated the description of the
ratePlans
>lastChangeType
field:- Retrieve a subscription by key
- Retrieve a subscription by key and version
-
In the description of the
subscription-key
path parameter of the "Update a subscription" operation, suggested retrieving the latest or history version of the subscription ID before updating a specific version of the subscription. -
In the response body of the "Retrieve an order line item" operation, corrected the data type of the
orderLineItem
>productRatePlanChargeId
field. - In the description of the "Cancel a payment schedule" operation, clarified that only pending payment schedule items will be canceled.
-
In the response body of each of the following operations:
- Retrieve a payment schedule item
- Update a payment schedule item
- Cancel a payment schedule item
- Skip a payment schedule item
Updated the description of each of the following fields to state the requirement on the API version:
-
balance
-
psiPayments
-
In the response body of each of the following operations:
- Create a payment schedule
- List payment schedule by customer account
- Create multiple payment schedules at once
- Retrieve a payment schedule
- Add payment schedule items to a custom payment schedule
- Retry failed payment schedule items
Updated the description of each of the following fields to state the requirement on the API version:
-
items
>balance
-
items
>psiPayments
January 13, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.01.R2. For release notes for all Zuora products, see Latest releases.
API updates for the Flexible Billing feature
The following items are the API updates specific to the Flexible Billing feature.
-
Subscriptions
- Made the following updates:
-
In the response body of the "List subscriptions by account key" operation, added the following nested field to the
subscriptions
field:-
invoiceTemplateName
-
sequenceSetName
-
-
In the response body of each of the following operations, added the
invoiceTemplateName
andsequenceSetName
fields:- Retrieve a subscription by key
- Retrieve a subscription by key and version
-
In the response body of the "List subscriptions by account key" operation, added the following nested field to the
API updates for the Billing Schedule feature
The following items are the API updates specific to the Early Adopter announcement of the Billing Schedule feature.
-
Orders
- Made the following updates:
-
In the response body of each of the following operations, added the
invoiceScheduleId
nested field to theorder
field:- Retrieve an order
- List order metrics for an evergreen subscription
-
In the response body of each of the following operations, added the
invoiceScheduleId
nested field to theorders
field:- List orders
- List orders of a subscription owner
- List orders by subscription number
- List orders of an invoice owner
- List pending orders by subscription number
-
In the response body of each of the following operations, added the
-
Subscriptions
- Made the following updates:
-
In the response body of the "List subscriptions by account key" operation, added the
invoiceScheduleId
nested field to thesubscriptions
field: -
In the response body of each of the following operations, added the
invoiceScheduleId
field:- Retrieve a subscription by key
- Retrieve a subscription by key and version
-
In the response body of the "List subscriptions by account key" operation, added the
API updates for the Payment Schedules feature
The following items are the API updates specific to the Payment Schedules feature.
-
Payment Schedules
- Made the following updates:
-
In the request body of the “Update a payment schedule item” operation, added the following fields to support linking multiple payments to a payment schedule item:
-
linkPayments
-
unlinkPayments
-
-
In the response body of each of the following operations:
- Retrieve a payment schedule item
- Update a payment schedule item
- Cancel a payment schedule item
- Skip a payment schedule item
Added the following fields to support linking multiple payments to a payment schedule item and payment schedule item balance:
-
balance
-
psiPayments
-
In the response body of each of the following operations:
- Create a payment schedule
- List payment schedule by customer account
- Create multiple payment schedules at once
- Retrieve a payment schedule
- Add payment schedule items to a custom payment schedule
- Retry failed payment schedule items
Added the following fields to support linking multiple payments to a payment schedule item and payment schedule item balance:
-
items
>balance
-
items
>psiPayments
-
In the request body of the “Update a payment schedule item” operation, added the following fields to support linking multiple payments to a payment schedule item:
Other API updates
The following items are the other general API updates included in this release:
- Accounts - Added an operation called "Delete an account".
-
Invoices
- Made the following updates:
- Added an operation called "Retrieve an invoice".
-
In the request body of the "Post invoices" operation, added the support for custom fields to the
invoices
field.
- Custom Object Jobs - Added an operation called "Cancel a custom object bulk job".
-
Communication Profiles
- In the response body of the "CRUD: Retrieve a communication profile" operation, added the following fields:
-
IsDefault
-
Muted
-
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
Updated the description of each of the following actions:
- Create
- Update
-
In the request body of each of the following operations, removed the unsupported
SubmissionDateTime
field:- CRUD: Create a usage record
- CRUD: Retrive a usage record
- CRUD: Update a usage record
- In the description of the “Update a payment schedule item” operation, added notes on linking and unlinking multiple payments to a payment schedule item.
-
In the response body of the "List credit memo items" operations, added the missing
OrderLineItem
enum value to each of the following fields:-
items
>sourceItemType
-
items
>sourceItemId
-
-
In the response body of the "Retrive a credit memo item" operation, added the missing
OrderLineItem
enum value to each of the following fields:-
sourceItemType
-
sourceItemId
-
-
In the response body of the "List credit memos” operation, added the missing
Order
,CreditMemo
, andConsolidation
enum values to thecreditmemos
>sourceType
field. -
In the response body of each of the following operation, added the missing
Order
,CreditMemo
, andConsolidation
enum values to thememos
>sourceType
field:- Create credit memos
- Update credit memos
-
In the response body of each of the following operations, added the missing
Order
,CreditMemo
, andConsolidation
enum values to thesourceType
field:- Retrive a credit memo
- Create a credit memo from a charge
- Create a credit memo from an invoice
- Update a credit memo
- Apply a credit memo
- Cancel a credit memo
- Post a credit memo
- Unapply a credit memo
- Unpost a credit memo
January 6, 2023
API updates
This section lists operations and fields that were added, changed, or removed.
The following API updates are available as of Zuora Release 2023.01.R1.
-
Settings
- Added the
Per_Specific_Months
enum value to thelistPriceBase
parameter of theBillingListPriceBase
setting.
Doc updates
This section lists the documentation updates that were made in this version of the API Reference.
-
In the request body of each of the following operations, updated the description of the
gatewayOptions
field by adding a link to the relevant article in the Knowledge Center:- Create a payment method
- Update a payment method
- Verify a payment method
- Create authorization
- Cancel authorization
- Create a payment
- Refund a payment
-
In the request body of the “Create a standalone invoice” operation, updated the description of the
invoiceItems
>unitPrice
field to state this field is required for passing Level 3 card data to the gateway. -
In the request body of the “Create standalone invoices” operation, updated the description of the
invoices
>invoiceItems
>unitPrice
field to state this field is required for passing Level 3 card data to the gateway. - In each of the Orders operations and Order Line Items operations, updated the general availability note about the Orders feature.
-
In the request body of the “Create a standalone invoice” operation, added a note to the description of each of the following fields about the permission control information:
-
invoiceItems
>taxItems
-
invoiceItems
>discountItems
>taxItems
-
-
In the request body of the “Create standalone invoices” operation, added a note to the description of each of the following fields about the permission control information:
-
invoices
>invoiceItems
>taxItems
-
invoices
>invoiceItems
>discountItems
>taxItems
-