About Yingying

Yingying

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you! 2019-08-15 Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the "Amend" action, added the following missing fields to the requests > Amendments field in the request body: ResumeDate SuspendDate

Yingying

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you! 2019-08-08 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 253, July 2019. Workflows - Added a new resource called “Workflows”, with the “Get workflows” operation for retrieving workflows on a tenant . Filters can be used to retrieve specific workflows. If no filters are specified, all workflows will be returned. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. Added more information about the REST endpoint base UL of the US Production Copy Environment . In the "Create payment method" operation, corrected the names of the following fields: bankAccountName bankAccountNumber bankAccountType bankName Previously, they were incorrectly documented as: achBankAccountName achBankAccountNumber achBankAccountType achBankName

Yingying

The information about the base URL of the Production Copy (ServicesX) Environment has been updated. See REST endpoint base URL of Production Copy (Service) Environment for existing and new customers for the latest information.

Yingying

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you! 2019-08-01 Doc Updates This section lists the documentation updates that were made in this version of the API Reference. Added the missing Zuora-Entity-Ids request header in the following operations: Get revenue recognition rule by product rate plan charge Create revenue schedule for credit memo item (manual distribution) Get revenue schedule by credit memo item ID Create revenue schedule for credit memo item (distribute by date range) Create revenue schedule for debit memo item (manual distribution) Get revenue schedule by debit memo item ID Create revenue schedule for debit memo item (distribute by date range) Get all revenue schedules of product charge by charge ID and billing account ID In the request body of the “Create stored credential profile” operation, added the missing networkTransactionId field. In the request body of the "CRUD: Update account" operation, corrected the descriptions of the following fields: Currency Status In the response body of the "CRUD: Get account" operation, corrected the descriptions of the Status field. In the request body of the "CRUD: Create account" operation, corrected the descriptions of the Status field. In the Zuora Object Model section, added more information about the differnces between the BillingRun object and BillRun object. In the response body of the "CRUD: Get payment method" operation, updated the description of the Active and PaymentMethodStatus fields to distinguish them. In the request body of the "CRUD: Update payment method" operation, updated the description of the PaymentMethodStatus field for better clarity.

Yingying

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you! 2019-07-26 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 252, July 2019. Credit Memos - Changed the behavior of the "Apply credit memo" operation. You can now use this operation to perform the following operations: Apply negative credit memo items to negative invoice items or debit memo items. Apply negative credit memo items to the taxation items of negative invoice items or debit memo items. Apply the taxation items of negative credit memo items to negative invoice items or debit memo items. Apply the taxation items of negative credit memo items to those of negative invoice items or debit memo items. Debit Memos - Changed the behavior of the "Create debit memo from charge" operation. You can now use this operation to create negative debit memo items from negative product rate plan charges. Invoices - Changed the behavior of the "Create debit memo from invoice" operation. You can now use this operation to create negative debit memo items from negative invoice items. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the "Create payment method" operation, made the following updates: Added the following missing fields to the request body: bankABACode achBankAccountName achBankAccountNumber achBankAccountType achBankName addressLine1 addressLine2 phone city country state zipCode Clarified that these fields are applicable to ACH payment methods. In the "Get revenue schedule by invoice item adjustment" operation, corrected the description of the invoice-item-adj-key path parameter. In the code sample of the request body for the following operations: Create revenue schedule for credit memo item (distribute by date range) Create revenue schedule for debit memo item (distribute by date range) Made the following updates: Removed the redundant top-level application/json field. Corrected the eventType and eventTypeSystemId field to avoid confusion. In the request body of the following operations, corrected the data type of the billingCycleDay field to string : Create payment run Update payment run In the response body of the "Get payment run" operation, corrected the data type of the billingCycleDay field to string .

Yingying

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you! 2019-07-21 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 251, July 2019. Contacts - Changed the behavior of the “Scrub contact” operation. The value of the country field becomes null instead of 0 after scrubbing as of this release. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the request body of the "CRUD: Create usage", made the following updates: Added the following missing fields: ChargeNumber Description SubscriptionNumber Removed the unsupported Rbestatus field. In the response body of the "CRUD: Create usage", added the following missing fields: Description SubscriptionNumber

Yingying · ‎07-15-2019

For customers who have already provisioned their Production Copy or Service Environment, the base URL of REST endpoints is https://servicesXXX.zuora.com:{port number}, where XXX is the number of your service instance. For example: https://services123.zuora.com:12345 For customers who are newly requesting for Production Copy or Service Environment, the base URL of REST endpoints will be https://restservicesXXX.zuora.com/, where XXX is the number of your service instance. For example: https://restservices123.zuora.com

Yingying · ‎07-12-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you! 2019-07-11 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 250, July 2019. Invoices - In the request body of the "CRUD: Update invoice" operation, changed the behavior of the RegenerateInvoicePDF field by adding a limit that you can use this field to regenerate PDF files for the same invoice for at most 100 times. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the request body of the "CRUD: Update invoice" operation, added the missing RegenerateInvoicePDF field. In the description of the "Create authorization" operation, made the following updates: Clarified the subsequent operations as part of the Delayed Capture feature. Added a known limitation of the Delayed Capture feature. In the description of the "CRUD: Create payment" operation, clarified that this operation cannot work if the Invoice Settlement feature is enabled. In the request body of the "CRUD: Create payment method" operation, removed the MitProfileAgreedOn field. The details of this field are moved to the PaymentMethod article in Zuora's Knowledge Center. In the request body of the "Amend" action, updated the description of the requests > Amendments > ServiceActivationDate field to add more information about how to use this field. In the request body of the "CRUD: Update amendment" operation, updated the description of the ServiceActivationDate field to add more information about how to use this field. In the response body of the "CRUD: Get amendment" operation, updated the description of the ServiceActivationDate field to add more information about how to use this field. Corrected the endpoints of the following asynchronous Orders operations: Preview order asynchronously Create order asynchronously Get job status and response

Yingying · ‎07-05-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you! 2019-07-04 Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the response body of the "Get account" operation, added the following missing nested fields to the metrics fields: totalDebitMemoBalance unappliedPaymentAmount unappliedCreditMemoAmount In the 200 response body of the "CRUD: Get payment" operation, added the missing Processing enum value to the Status field. In the request body of the "CRUD: Create payment method" operation, made the following updates: Added the missing BankTransferAccountName , BankTransferAccountNumber , and BankTransferAccountNumberMask fields. Added the missing SEPA enum value for the BankTransferType field. In the response body of the "CRUD: Get payment method" operation, made the following updates: Added the missing BankTransferAccountNumber field. Added the missing SEPA enum value for the BankTransferType field. In the request body of the "Amend" action, updated the description of the requests > Amendments > CustomerAcceptanceDate field to add more information about how to use this field. In the request body of the "CRUD: Update amendment" operation, updated the description of the CustomerAcceptanceDate field to add more information about how to use this field. In the response body of the "CRUD: Get amendment" operation, updated the description of the CustomerAcceptanceDate field to add more information about how to use this field.

Yingying · ‎07-04-2019

Known Issue: In Export ZOQL, > and <= operators are not supported in Having clause for date type Workaround: Use >= instead of > to compare date type in the Having clause in Export ZOQL. For example: Not supported Workaround select A.a, avg(A.b) from A where B.name is null group by A.a having max(B.date)> '2019-05-01' select A.a, avg(A.b) from A where B.name is null group by A.a having max(B.date)>='2019-05-02' Use < instead of <= to compare date type in the Having clause in Export ZOQL. For example: Not supported Workaround select A.a, avg(A.b) from A where B.name is null group by A.a having max(B.date)<='2019-05-01' select A.a, avg(A.b) from A where B.name is null group by A.a having max(B.date)<'2019-05-02' Status: Zuora engineering is working on the fix for the issue. Reference Number: TOK-815

Yingying · ‎06-27-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you! 2019-06-28 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 notification definition” operation, added an example of how to get the communication profile Id to the description of the communicationProfileId field. In the request body of the following operations, updated the description of the subscriptions > orderActions > updateProduct > specificUpdateDate field to add more information about how to use this field: Create order Preview order In the response body of the following operations, updated the description of the order ( orders ) > subscriptions > orderActions > updateProduct > specificUpdateDate field to add more information about how to use this field: Get an order Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Get order metrics for evergreen subscription In the description of the "Create authorization" and "Cancel authorization" operations, added the missing "Chase Paymentech Orbital" and "Ingenico ePayments" to the payment gateways that support both operations.

Yingying · ‎06-21-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you! 2019-06-20 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 249, June 2019. Payment Methods - Added the cardSecurityCode field in the request body of the “Create stored credential profile” operation. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the request body of the “Subscribe” action, added the description for the subscribes > PreviewOptions > EnablePreviewMode field as a workaround to avoid potential charges for payment method validation in subscription and amendment previews. In the descriptions of the "Create order" and "Preview order" operations, added notes to inform customers about the limits on Orders. In the Authorization header parameter of the following operations, added the description that the OAuth token must be regenerated after the Notification and the Configurable Event features are enabled in your Zuora tenant: Create a notification definition Query notification definitions Update a notification definition Get a notification definition Delete a notification definition Create an email template Query email templates Update an email template Get an email template Delete an email template In the eventCategory query parameter of the following operations, added the description that two formats are supported: Get callout notification histories Get email notification histories In the response body of the "Get account" operation, added the missing sequenceSetId nested field to the basicInfo field. Corrected the endpoint URL of the "Upload file for invoice" operation to /v1/invoices/{invoice-id}/files . Corrected the endpoint URL of the "Upload file for credit memo" operation to /v1/creditmemos/{creditMemoId}/files . Corrected the endpoint URL of the "Upload file for debit memo" operation to /v1/debitmemos/{debitMemoId}/files . In the following operations, changed the path parameter name from invoice-id to invoiceId . Get invoice files Get invoice items In the “Get taxation items of invoice item” operation, changed the following path parameter names: Changed invoice-id to invoiceId Changed item-id to itemId In the response body of the "Get product catalog" operation, corrected the URL example in the description of the products > productRatePlans field. In the response body of the "Get product" operation, corrected the URL example in the description of the productRatePlans field.

Yingying · ‎06-14-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you! 2019-06-12 Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the request body of the "CRUD: Update payment method" operation, updated the note of the AccountId field to say that, if a payment method is already associated with a customer account, you cannot update the payment method to associate it with another account ID. In the request body of the "Create credit card payment method" operation, corrected the cardHolderInfo > cardHolderName field from optional to required. In the introduction of the "Create payment method" operation, updated the description for the credit card method to emphasize that the cardHolderInfo > cardHolderName field in the request body is required for this type of payment method. In the descriptions of the following actions, added the limitations of supported object types: Create Update In the “Write off invoice” operation, simplified the request example. In the response body of the “CRUD: Get rate plan charge” operation, corrected ServiceActivationDate to ServiceActivation in the description of the TriggerEvent field.

Yingying · ‎05-27-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-05-27 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 247, May 2019. Contacts - Changed the behavior of the “CRUD: Update contact” operation. You can now edit contacts for canceled accounts. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the response body of the “Get product catalog” operation, noted the array size limit to the description of the products > productRatePlans field. In the response body of the “Get product” operation, noted the array size limit to the description of the productRatePlans field. In the “Upload file for credit memo” operation, changed the path parameter name from id to creditMemoId . In the “Upload file for debit memo” operation, changed the path parameter name from id to debitMemoId . In the “Upload file for invoice” operation, changed the path parameter name from id to invoiceId . In the response body of the Update action, corrected the type of the fieldsToNull nested field from string to array . In the source YAML file, renamed the CreatePMPayPalEC&PayPalNativeEC reference object to CreatePMPayPalECPayPalNativeEC .

Yingying · ‎05-21-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-05-20 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 246, May 2019. Contacts - Added a new operation called “Scrub contact”. Credit Memos - Added a new operation called “Upload file for credit memo”. Debit Memos - Added a new operation called “Upload file for debit memo”. Invoices - Made the following updates: Added a new operation called “Upload file for invoice”. In the response body of the “Get invoice items” operation, added the availableToCreditAmount nested field to the invoiceItems field and invoiceItems > taxationItems > data field. In the response body of the “Get taxation items of invoice item” operation, added the availableToCreditAmount nested field to the data field. Accounts - Changed the behavior of the “Generate billing documents by account” operation. You can now generate billing documents for all subscriptions except for cancelled and suspended subscriptions. Previously, you could only generate billing documents for active subscriptions. Payment Methods - Made the following updates: Removed the networkTransactionId field from the response body of the “Get stored credential profiles” operation. Added the mitProfileAgreedOn field to the request body of the following operations: Create payment method Create credit card payment method Added the agreedOn field to the request body of the “Create Stored Credential Profile” operation. Added the MitProfileAgreedOn field to the request body of the “CRUD: Create payment method” operation. Payment Gateway Reconciliation - Added the Payment Gateway Reconciliation section that includes the following operations: Settle Payment Reject Payment Reverse Payment Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the descriptions of the following operations, noted that these API operations are now in Limited Availability: Get billing information for order Request breakdown of invoice items by order Get breakdown of invoice by order Request breakdown of credit memo items by order Get breakdown of credit memo by order In the response body of the “CRUD: Get usage” operation, corrected the description of the CreatedDate field. Renamed the Link Queries section to Data Queries. Also renamed the operations in this section: Renamed “Submit Link query” to “Submit data query”. Renamed “Get Link query jobs” to “Get data query jobs”. Renamed “Get Link query job” to “Get data query job”. Renamed “Cancel Link query job” to “Cancel data query job”. In the source YAML file, renamed the following reference objects: Renamed SubmitLinkQueryRequest to SubmitDataQueryRequest . Renamed SubmitLinkQueryResponse to SubmitDataQueryResponse . Renamed GetLinkQueryJobsResponse to GetDataQueryJobsResponse Renamed GetLinkQueryJobResponse to GetDataQueryJobResponse . Renamed DeleteLinkQueryJobResponse to DeleteDataQueryJobResponse . Renamed LinkQueryJobCommon to DataQueryJobCommon . Renamed LinkQueryJob to DataQueryJob . Renamed LinkQueryJobCancelled to DataQueryJobCancelled . Renamed LinkQueryErrorResponse to DataQueryErrorResponse . Added the X-Zuora-WSDL-Version request header to the following actions: Amend Create Delete Execute Generate Query QueryMore Subscribe Update

Yingying · ‎05-15-2019

Hi @Ridhima , We have added the reasons and processId to CommonResponseType in the yaml file since version 2019-05-08. See https://www.zuora.com/developer/api-reference/. You can refer to the API changelog for the affected 200 response schemas. Yingying

Yingying · ‎05-09-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-05-08 Doc Updates This section lists the documentation updates that were made in this version of the API Reference. Added the following operations: CRUD: Create CreditBalanceAdjustment CRUD: Update CreditBalanceAdjustment In the 200 respsonse body of the following operations, added the processId and reasons fields: Update account Activate accounting code Deactivate accounting code Delete accounting code Update an accounting code Close accounting period Set accounting period to pending close Update accounting period Delete accounting period Re-open accounting period Run trial balance Edit attachments Delete attachments Email billing documents generated from bill run Multi-entity: Share a product with an Entity Establish connection to Zuora REST API service Delete credit memo Email credit memo Get breakdown of credit memo by order Request breakdown of credit memo items by order Update debit memos Delete debit memo Email debit memo Delete document properties Update invoices Email invoice Delete journal run Cancel journal run Stop mass action Delete Order Update order custom fields Update subscription custom fields Get an order Get order metrics for evergreen subscription Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Get rated result for order Get billing information for order Create order Update order action trigger dates Preview order Get term information for subscription Get breakdown of invoice by order Request breakdown of invoice items by order Delete payment Delete payment method Scrub payment method Create payment method Delete payment run Delete refund Update custom fields on revenue items by revenue event number Update custom fields on revenue items by revenue schedule number Delete revenue schedule Update revenue schedule basic information Delete sequence set Delete summary journal entry Cancel summary journal entry Update basic information of a summary journal entry Delete taxation item In the 200 respsonse body of the “Get job status and response” operation, added the following nested fields to the result field: processId reasons

Yingying · ‎04-19-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-04-18 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 243, April 2019. Payment Methods - In the request body of the “Create payment method” operation, added the possible value ACH to the type field. The following items are API updates specific to enhancements to the prefix and numbing configuration for billing documents. These API updates are also available as of Zuora Release 243, April 2019. Sequence Sets - Added a new resource called “Sequence Sets”, with the following new operations: Create sequence set Get sequence sets Update sequence set Get sequence set Delete sequence set Accounts - In the request body of the following operations, added the sequenceSetId field: Create account Update account Orders - In the request body of the following operations, added the sequenceSetId nested field to the newAccount field: Create order Create order asynchronously Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the request body of the “Subscribe” action, corrected the name of the subscribes > Account > Id field. Previously, the name of this field was documented as AccountId .

Yingying · ‎04-11-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-04-10 Doc Updates This section lists the documentation updates that were made in this version of the API Reference. Changed “customer-initiated” to “cardholder-initiated” in the following locations: The mitProfileAction field in the request body of the “Create payment method” operation. The mitProfileAction field in the request body of the “Create credit card payment method” operation. The action and status fields in the request body of the “Create stored credential profile” operation. In the request body of the “CRUD: Create Import” operation, removed the unsupported import type MPU from the enum values of the ImportType field.

Yingying · ‎03-29-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-03-27 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 account” and “Renew subscription” operations, made the following updates: Removed the unsupported version 196.0 from the description of the invoiceCollect field. Corrected the data type of the collect field from string to boolean and updated the prerequisite of this field to "The invoice or runBilling field must be true ". In the request body of the subscription-related operations listed below, made the following updates: Removed the unsupported version 196.0 from the description of the invoiceCollect field. Corrected the prerequisite of this field to "The invoice or runBilling field must be true ". The following operations are affected: Create subscription Update subscription Resume subscription Suspend subscription Cancel subscription In the Zuora Object Model section, clarified that the API name of the Billing Run object is BillingRun in Zuora Link. In the request body of the “Submit Link query” operation, made the following updates: Removed the queryType field. Changed the description of the output > target field.

Yingying · ‎03-22-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-03-20 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 242, March 2019. Orders - Made the following updates: In the following operations, added the includeUnits field to the order (or orders ) > subscriptions > orderActions > updateProduct > chargeUpdates > pricing > usageOverage field in the response body: Get an order Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Get order metrics for evergreen subscription In the following operations, added the priceChangeOption field to the order (or orders ) > subscriptions > orderActions > createSubscription > subscribeToRatePlans > chargeOverrides > pricing > discount field in the response body: Get an order Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Get order metrics for evergreen subscription In the following operations, added the priceChangeOption field to the order (or orders ) > subscriptions > orderActions > addProduct > chargeOverrides > pricing > discount field in the response body: Get an order Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Get order metrics for evergreen subscription Payment Methods - Made the following updates: In the “Create payment method” operation, made the following updates in the request body: Added the possible value CreditCard to the type field. Added the following fields: cardHolderInfo cardNumber cardType expirationMonth expirationYear mitConsentAgreementRef mitConsentAgreementSrc mitNetworkTransactionId mitProfileAction mitProfileType securityCode In the “Create credit card payment method” operation, made the following updates in the request body: Added the possible value Persist to the mitProfileAction field. Added the mitNetworkTransactionId field. In the “Create stored credential profile” operation, added the action field in the request body. In the following operations, updated the description of the IPAddress field in the request body (or the response body) to clarify that the field has now been supported by the WorldPay payment gateway integration: CRUD: Create payment method CRUD: Update payment method CRUD: Get payment method Refunds - In the request body of the “Update refund” operation, added the referenceId field. 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 account” operation, added reference information to the description of the creditCard > cardType field. In the request body of the “Subscribe” action, added reference information to the description of the subscribes > PaymentMethod > CreditCardType field. In the request body of the “Create credit card payment method” operation, added reference information to the description of the creditCardType field. In the request body of the following operations, added reference information to the description of the CreditCardType field: CRUD: Create payment method CRUD: Update payment method In the response body of the “Get account summary” operation, added reference information to the description of the basicInfo > defaultPaymentMethod > creditCardType field. In the response body of the “Get credit card payment methods for account” operation, added reference information to the description of the creditCards > cardType field. In the response body of the “CRUD: Get payment method” operations, added reference information to the description of the CreditCardType field. In the request body of the “Create stored credential profile” operation, clarified the description of the status field. Added a new section Link Queries containing the following operations: Submit Link query Get Link query jobs Get Link query job Cancel Link query job In the source YAML file, replaced the PostOrderDiscountPricingOverride reference object by the DiscountPricingOverride reference object. This change affects the following operations: Create order Preview order In the source YAML file, replaced the PostOrderDiscountPricingUpdate reference object by the DiscountPricingUpdate reference object. This change affects the following operations: Create order Preview order In the source YAML file, replaced the UsageOveragePricingUpdatePostOrder reference object by the UsageOveragePricingUpdate reference object. This change affects the following operations: Create order Preview order In the source YAML file, replaced the cardHolderInfo field in the POSTPaymentMethodType reference object by a new reference object called CreatePaymentMethodCardholderInfo . This change affects the “Create credit card payment method” operation.

Yingying · ‎03-14-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-03-13 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 240, March 2019. Payment Methods - Made the following updates: In the request body of the “CRUD: Create payment method” and “CRUD: Update payment method” operations, added the following enum values to the BankTransferType field: Autogiro Betalingsservice In the response body of the “CRUD: Get payment method” operation, added the following enum values to the BankTransferType field: Autogiro Betalingsservice Payment Method Snapshots - In the response body of the “CRUD: Get payment method snapshot” operation, added the following enum values to the BankTransferType field: - Autogiro - Betalingsservice The following API updates are available as of Zuora Release 241, March 2019. Payment Methods - Made the following updates: Added the following operations: Create stored credential profile Get stored credential profiles Cancel stored credential profile Expire stored credential profile In the request body of the “Create credit card payment method” operation, added the following fields: mitConsentAgreementRef mitConsentAgreementSrc mitProfileAction mitProfileType Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the “CRUD: Create payment method” and “CRUD: Update payment method” operations, added the missing BankTransferType field to the request body. In the “Get subscriptions by key” operation, corrected the description of the charge-detail query parameter.

Yingying · ‎03-07-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-03-07 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 240, March 2019. Payment Methods - Made the following updates: In the request body of the “CRUD: Create payment method” and “CRUD: Update payment method” operations, added the following fields: IdentityNumber IsCompany CompanyName In the response body of the “CRUD: Get payment method” operation, added the following fields: IdentityNumber IsCompany CompanyName Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the description of the Actions section, clarified that actions do not support the Invoice Settlement feature and the Orders feature. Also clarified this in the description of the “Query” action.

Yingying · ‎02-27-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-02-27 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 239, February 2019. Accounts - In the request body of the “Create account” operation, changed the behavior of the runBilling field to match the documentation. Previously, invoices were also generated even if runBilling is set to false . Credit memos were also generated if the Invoice Settlement feature was enabled. 2019-02-20 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 239, February 2019. Payments - In the request body of the “Update payment” operation, added the referenceId field. OAuth - In the “Generate an OAuth token” operation, the client_secret request body field now has a maximum supported length of 42 characters. When you create an OAuth client using the Zuora UI, the Client Secret is 38 to 42 characters long. Previously, Client Secrets were always 20 characters long. You can continue to use existing Client Secrets without modification. The following items are API updates specific to enhancements to the Invoice Item Settlement feature: Invoices - Made the following updates: Added a new operation “Get taxation items of invoice item”. In the response body of the “Get invoice items” operation, added the balance and taxationItems nested fields to the invoiceItems field. Credit Memos - Made the following updates: Added a new operation “Get taxation items of debit memo item”. In the “Get credit memo items” operation: Added the zuora-version request header. Added the taxationItems nested fields to the items response body field. This field is only available if you set the zuora-version request header to 239.0 or later. Changed the behavior of the items > creditTaxItems response body field. This field is not available if you set the zuora-version request header to 239.0 or later. In the “Get credit memo item” operation: Added the zuora-version request header. Added the taxationItems response body field. This field is only available if you set the zuora-version request header to 239.0 or later. Changed the behavior of the creditTaxItems response body field. This field is not available if you set the zuora-version request header to 239.0 or later. Debit Memos - Made the following updates: Added a new operation called “Get taxation items of debit memo item”. In the “Get debit memo items” operation: Added the zuora-version request header. Added the taxationItems nested field to the items response body field. This field is only available if you set the zuora-version request header to 239.0 or later. Changed the behavior of the items > taxItems response body field. This field is not available if you set the zuora-version request header to 239.0 or later. In the “Get debit memo item” operation: Added the zuora-version request header. Added the taxationItems response body field. This field is only available if you set the zuora-version request header to 239.0 or later. Changed the behavior of the taxItems response body field. This field is not available if you set the zuora-version request header to 239.0 or later. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the “Subscribe” action, made the following updates: Added the AccountId nested field to the subscribes > Account request body field. Removed the following nested fields from the subscribes > Account request body field: Balance BillToId CreatedById CreatedDate CreditBalance SoldToId Status UpdatedById UpdatedDate Improved the request and response samples. In the “Generate an OAuth token” operation, documented the supported length of the client_id request body field. In the “API Versions” section, added the following fields to the “Minor Version History” table: creditTaxItems taxItems taxationItems In the request body of the “Generate RSA signature” operation, removed the redundant “ zuora.com/apps/PublicHostedPageLite.do if you are on the API Sandbox environment.” from the description of the uri field.

Yingying · ‎02-14-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-02-14 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 238, February 2019. Orders - Made the following updates: In both the “Create order” and “Preview order” operations, added the priceChangeOption field to the following fields in the request body: subscriptions > orderActions > addProduct > chargeOverrides > pricing > discount subscriptions > orderActions > updateProduct > chargeUpdates > pricing > discount subscriptions > orderActions > createSubscription > subscribeToRatePlans > chargeOverrides > pricing > discount 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 payment” operation, removed the referenceId field. In the source YAML file, duplicated the DiscountPricingOverride reference object as a new reference object called PostOrderDiscountPricingOverride that is used in the request body of the following operations: Create order Preview order In the source YAML file, duplicated the DiscountPricingUpdate reference object as a new reference object called PostOrderDiscountPricingUpdate that is used in the request body of the following operations: Create order Preview order 2019-02-12 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 238, February 2019. Accounts - Made the following updates: In the request body of the “Generate billing documents by amount” operation, added the following fields: autoRenew chargeTypeToExclude In the response body of the “Create account” operation, added the following fields: billToContactId soldToContactId Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the response body of the “Get account” operation, corrected the descriptions of the following fields: billToContact > country billToContact > state soldToContact > country soldToContact > state In the response body of the “Get account summary” operation, corrected the descriptions of the following fields: billToContact > country billToContact > state soldToContact > country soldToContact > state In the request body of the “Create credit card payment method” operation, removed “required” from the following nested fields of the cardHolderInfo field. However, if you do not specify the accountKey field in the request body, the cardHolderName field is still required . cardHolderName City State zipCode country Changed the URL of the source YAML file. See this post for more information. In the request body of the “Update payment” operation, added the referenceId field. However, as of Zuora Release 238, this field is not available.

Yingying · ‎01-25-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-01-22 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 237, January 2019. Subscriptions - In the following operations, added the documentDate field to the request body: creditMemo > creditMemoItems invoicceItems Product Rate Plans - In the response body of the “Get product rate plans” operation, added the following nested fields to the productRatePlans > productRatePlanCharges > financeInformation field: revRecCode revRecTriggerCondition Catalog - Made the following updates: In the response body of the “Get catalog” operation, changed the behavior of the products > productRatePlans field. In the response body of the “Get product” operation, changed the behavior of the productRatePlans field. This behavior change is available only when you set the zuora-version request header to 230.0 or later. See the descriptions of the productRatePlans fields to find out details about the latest behavior. 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 debit memo from charge” operation, added the following missing fields to the charges field: serviceStartDate serviceEndDate In the “Preview order” operation, added the missing description for the previewOptions > previewTypes field in the request body. In the “Create order” operation, corrected a possible value of the subscriptions > orderActions > type field in the request body. Previously, the value Suspend was incorrectly listed as Subspend .

Yingying · ‎01-14-2019

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2019-01-07 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 236, January 2019. Accounts - In the “Create account” operation, added the documentDate field to the request body. Subscriptions - In the following operations, added the documentDate field to the request body: Create subscription Update subscription Renew subscription Cancel subscription Resume subscription Suspend subscription Invoices - In the request body of the “Write off invoice” operation, added the following fields and support for custom fields: comment items and its nested fields reasonCode Product Rate Plans - In the response body of the “Get product rate plans” operation, added the following nested fields to the productRatePlans > productRatePlanCharges > financeInformation field: contractAssetAccountingCode contractAssetAccountingCodeType contractLiabilityAccountingCode contractLiabilityAccountingCodeType adjustmentLiabilityAccountingCode adjustmentLiabilityAccountingCodeType unbilledReceivablesAccountingCode unbilledReceivablesAccountingCodeType adjustmentRevenueAccountingCode adjustmentRevenueAccountingCodeType contractRecognizedRevenueAccountingCode contractRecognizedRevenueAccountingCodeType Catalog - Made the following updates: In the “Get catalog” operation, changed the behavior of the products > productRatePlans field in the response body. In the “Get product” operation, changed the behavior of the productRatePlans field in the response body. This behavior change is available only when you set the zuora-version request header to 230.0 or later. See the descriptions of the productRatePlans fields to find out details about the latest behavior. Bill Run - Changed the behavior of the “CRUD: Create bill run” operation. If more than 500 bill runs created by using this operation are in Pending status, no more bill runs can be created by using this operation. Payments - Changed the behavior of the following operations. If you have the Invoice Settlement feature enabled, payments applied to credit balance cannot be canceled or deleted. Cancel payment Delete payment Refunds - Changed the behavior of the following operations. If you have the Invoice Settlement feature enabled, refunds applied to credit balance cannot be canceled or deleted. Cancel refund Delete refund Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the “Amend” action, corrected the descriptions of the DestinationInvoiceOwnerId and DestinationAccountId fields in the request body. In the "Suspend subscription” and “Resume subscription” operations, removed the notes about the limitation on using these operations with Order Metrics. In the “Preview order” operation, added the missing taxInfo nested field to the previewAccountInfo field in the request body. In the response bodies of the following operations, noted when certain fields are not applicable in the order > subscriptions > orderActions > suspend field: Get an order Get order metrics for evergreen subscription Those fields include: suspendPolicy suspendPeriods suspendPeriodsType suspendSpecificDate In the response bodies of the following operations, noted when certain fields are not applicable in the order > subscriptions > orderActions > resume field: Get an order Get order metrics for evergreen subscription Those fields include: resumePolicy resumePeriods resumePeriodsType resumeSpecificDate extendsTerm In the response bodies of the following operations, noted when certain fields are not applicable in the orders > subscriptions > orderActions > suspend field: Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Those fields include: suspendPolicy suspendPeriods suspendPeriodsType suspendSpecificDate In the response bodies of the following operations, noted when certain fields are not applicable in the orders > subscriptions > orderActions > resume field: Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Those fields include: resumePolicy resumePeriods resumePeriodsType resumeSpecificDate extendsTerm In all relevant operations, changed the name of the Real-Time Usage Rating feature to Active Rating, and updated all related reference links.

Yingying · ‎12-17-2018

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2018-12-14 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 235, December 2018. Orders - Made the following updates: In the request body of the “Create order” operation: Added nested fields called suspend and resume to the subscriptions > orderActions field. Added possible values Suspend and Resume to the subscriptions > orderActions > type field. In the response body of the “Create order” operation, added a possible value Suspended to the subscriptions > status field. In the request body of the “Preview order” operation: Added nested fields called suspend and resume to the subscriptions > orderActions field. Added possible values Suspend and Resume to the subscriptions > orderActions > type field. In the following operations, added nested fields called suspend and resume to the order > subscriptions > orderActions field of the response body: Get an order Get order metrics for evergreen subscription In the following operations, added possible values Suspend and Resume to the subscriptions > orderActions > type field of the response body: Get an order Get order metrics for evergreen subscription In the following operations, added nested fields called suspend and resume to the orders > subscriptions > orderActions field of the response body: Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner In the following operations, added possible values Suspend and Resume to the orders > subscriptions > orderActions > type field of the response body: Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the Zuora Object Model section, added the following objects to the table of API names: Feature Product Feature Subscription Product Feature In the “Create order” operation, added a note about the Suspend and Resume feature. In the following operations, updated the note about the Orders feature: Preview order Preview order asynchronously Create order Create order asynchronously Delete order Get job status and response Update subscription custom fields Update order action trigger dates In the following operations, updated the note about the Order Metrics feature: Get all orders Get an order Get billing information for order Get term information for subscription Get order metrics for evergreen subscription Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Get breakdown of invoice by order Request breakdown of invoice items by order Get rated result for order Update order custom fields 2018-12-07 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 235, December 2018. Orders - Added the following new operations: Preview order asynchronously Create order asynchronously Get job status and response Accounts - Made the following updates: In the request body of the “Create account” operation, changed the behavior of the creditCard and hpmCreditCardPaymentMethodId fields. If autoPay is set to false, you do not need to specify creditCard or hpmCreditCardPaymentMethodId . Changed the behavior of the “CRUD: Delete account” operation to delete accounts asynchronously. Previously, accounts were deleted synchronously when this operation is used. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the “Multi-entity: Disconnect connection” operation, updated the description to clarify that if you have shared objects from a global entity to a target entity, disconnecting the connection will break the mapping relationship between these entities and cannot be recovered later. In the “How this REST API Call Works” section of the “Post usage” operation, updated the description about the method for downloading the usage file template. Previously a file download link was provided in this section. Now users need to go to their tenants and download for themselves. In the “Create order” operation, corrected the maximum length of the following fields in the request body: newAccount > name subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > name In the “Preview order” operation, corrected the maximum length of the subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > name field in the request body.

Yingying · ‎12-10-2018

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2018-12-07 API Updates This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 235, December 2018. Orders - Added the following new operations: Preview order asynchronously Create order asynchronously Get job status and response Accounts - Made the following updates: In the request body of the “Create account” operation, changed the behavior of the autoPay , creditCard , and hpmCreditCardPaymentMethodId fields. If autoPay is set to false, you do not need to specify creditCard or hpmCreditCardPaymentMethodId . Previously, creditCard and hpmCreditCardPaymentMethodId did not depend on autoPay . Changed the behavior of the “CRUD: Delete account” operation to delete accounts asynchronously. Previously, accounts were deleted synchronously when this operation is used. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the “Multi-entity: Disconnect connection” operation, updated the description to clarify that if you have shared objects from a global entity to a target entity, disconnecting the connection will break the mapping relationship between these entities and cannot be recovered later. In the “How this REST API Call Works” section of the “Post usage” operation, updated the description about the method for downloading the usage file template. Previously a file download link was provided in this section. Now users need to go to their tenants and download for themselves. In the “Create order” operation, corrected the maximum length of the following fields in the request body: newAccount > name subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > name In the “Preview order” operation, corrected the maximum length of the subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > name field in the request body.

Yingying · ‎11-18-2018

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2018-11-15 Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the “Create order” operation, made the following updates: Added the requirement on setting a default payment method for the newAccount field in the request body. Added the option to use the returnIds parameter in the endpoint so that the IDs associated with the numbers (for example, subscriptionNumber , invoiceNumber , and so on) can be returned in the response. In the request body of the “Create payment” operation, updated the description of the gatewayId field to clarify that this field is required when creating electronic payments but optional when creating external payments.

Happy Business Starts Here