This object represents your customer. It lets you create recurring charges and track payments that belong to the same customer.

Accounts

Contacts represent your customer's contact details.

Contacts

Zuora Custom Objects provides a uniform custom data service for you to manage custom objects in Zuora. Those custom data is stored on Zuora's platform and can be used to extend the data model to accommodate your specific use cases.

Custom Objects

The Orders operations enable you to create or make modifications to subscriptions in a batch.

Orders

Order line items are non subscription based items created by an order, representing transactional charges such as one-time fees, physical goods, or professional service charges that are not sold as subscription services.           <br/>          With the Order Line Items feature enabled, you have the ability to launch non-subscription and unified monetization business models in Zuora, in addition to subscription business models.

Order Line Items

Subscriptions allow you to charge a customer on a recurring basis, such as a monthly charge or a charge based on usage and must be associated with an Account object. Subscriptions can also include one-time charges, such as service activation fees.

Subscriptions

A subscription plan is part of a subscription or an amendment to a subscription, and it comes from a price. Like a product and its plans, a subscription can have one or more subscription plans.         Subscription plans represent a price or a collection of prices for a service you sell. An individual subscription plan contains all prices specific to a particular subscription.

Subscription Plans

A subscription item is a part of a subscription plan, and it comes from a price.

Subscription Items

Fulfillments are subordinate objects attached to their related order line item.          You can manage the entire order line item lifecycle through fulfillments in the following ways:           <br/>          <ul><li>Create and attach fulfillments to an order line item to track the shipment or return status.</li>            <li>Trigger billing based on the fulfillment state and generate billing documents based on the fulfillments accordingly. </li>           <li>Create and attach fulfillment items to a fulfillment to keep track of all the assets in your system.</li></ul>

Fulfillments

Fulfillment items are subordinate objects attached to their related fulfillment.

Fulfillment Items

Bill runs automatically create invoices for your customers on a set schedule, as well as create invoices for your customers, as needed. A bill run gathers information from one or more customer accounts and generates invoices for those accounts.                     The operations in this section allows you to create, update, get, or delete bill runs.

Bill Runs

The Bill Run Previews operations allow you to generates a preview of future billing document items for a batch of accounts through a bill run.           A bill run preivew job also generates a downloadable CSV file containing a preview of invoice item data for the customer account batch.

Bill Run Previews

 **Note: The API operations in this section have been deprecated.**           <p>          Billing Documents represent your customer's invoices, credit memos and debit memos. Invoices are statements of amounts owed by a customer, and are either generated one-off, or generated periodically from a subscription. They contain invoice items, and proration adjustments that may be caused by changes to a subscription. If your invoice is configured to be charged automatically, Zuora automatically finalizes your invoice and attempts payment otherwise Zuora will email the invoice to your customer and await payment. Any customer credit memos may be applied before determining the amount due for the invoice (i.e., the amount that will be charged).</p>

Billing Documents

 **The API operations in this section have been deprecated.**           <p>          Billing document items represent each item in your customer's invoices, credit memos, or debit memos.</p>

Billing Document Items

Invoices are statements of amounts owed by a customer and are usually generated by a [bill run](https://knowledgecenter.zuora.com/Zuora_Billing/Billing_and_Payments/J_Billing_Operations/G_Bill_Runs/Create_bill_runs). For more information about invoices, see [Invoices](https://knowledgecenter.zuora.com/Zuora_Billing/Billing_and_Payments/IA_Invoices/A1_Invoice_Introduction).

Invoices

Credit memos reduce invoice and account balances. By applying one or more credit memos to invoices with positive balances, you can reduce the invoice balances in the same way as applying a payment to an invoice. For more information about credit memos, see [Credit and debit memos](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/Invoice_Settlement/B_Credit_and_Debit_Memos).

Credit Memos

Debit memos increase the amount a customer owes. Debit memos can be used to correct undercharging on an invoice or to levy ad hoc charges outside the context of a subscription. Just like an invoice, debit memo balances can be settled by applying either a payment or a credit memo. For more information about debit memos, see [Credit and debit memos](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/Invoice_Settlement/B_Credit_and_Debit_Memos).

Debit Memos

The TaxationItem object is used to add a tax amount to an invoice item.           Z-Tax and third-party tax engines such as Avalara or Connect tax engine can create TaxationItem objects. Before you use the Taxation Item object, you have to configure Z-Tax, Avalara, or Connect tax engine, as the object's fields rely on the values you create during the configuration process.

Taxation Items

The operations in this section allows you to create, update, get, or delete usage records.                    Zuora expects no more than 25 million usage records per month. If you want to go over this limit, contact your Zuora account manager for further consultation.

Usage Records

Payment methods represent your customer's payment instruments. They can be used to collect payments or saved to Account objects to store instrument details for future payments.

**Important**: The `type` field in the request body schema of the [Create a payment method](https://developer.zuora.com/other-api/quickstart-api/operation/createPaymentMethod/) operation enumerates the supported payment methods. Not all payment gateways support all these payment method types. Check <a href="https://knowledgecenter.zuora.com/Zuora_Payments/Zuora_Payments_overview/D_Supported_payment_methods" target="_blank">Supported payment methods</a> to check the supported payment methods for each gateway.  
If you need to create payment methods outside the scope of this operaton, you have to use the [Create a payment method](https://developer.zuora.com/v1-api-reference/api/operation/POST_PaymentMethods/) operation of the v1 API instead of the Quickstart API.
We do not plan to add additional payment methods to the Quickstart API.  Any new payment methods will only be available through the v1 API and Zuora client libraries.

Payment Methods

Payments represents a customer payment. The Payment object holds all of the information about a payment, including the payment amount and which billing documents the payment is applied to.

Payments

Payment runs are used to collect payments using electronic payment methods. Even if a payment was made to an invoice but had an error, if an invoice has a positive balance and meets all the filter criteria for the payment run, Zuora will pick up the invoice for processing in the payment run. <br/>        Zuora supports two type of payment runs: ad hoc and recurring. These are similar to ad hoc and scheduled bill runs

Payment Runs

The Payment Schedules feature enables you to collect a series of payments following customized timelines and rules. You have the flexibility to leverage a payment schedule to process either a single payment or multiple payments.          <br/>          You can leverage this feature to split invoice or account balances into several installments, and then automatically process payments for the installments. Payment schedules can also be used to collect external payments made for the installments. Meanwhile, we’ve provided you the capability to easily manage and modify existing schedules, as well as to manually retry failed payments with updated configurations.

Payment Schedules

A payment schedule consists of one or more payment schedule items that can be picked up by payment runs, which are hourly scheduled by Zuora. Each payment schedule item will trigger a payment process.

Payment Schedule Items

A refund returns money to a customer. For instance, refunds are used when a customer cancels service and is no longer your customer.         The Quickstart API allows you to refund payments, update refunds, and get refunds.

Refunds

Products describe the specific goods or services you offer to your customers and help you track inventory or provisioning. They should be used in conjunction with Plans and Prices to configure pricing.

Products

Plans are collections of Prices which define the unit cost, currency, and (optional) billing cycle for both recurring and one-time purchases of Products. While Products help you track inventory or provisioning, plans and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing and billing cycle options should be represented by prices grouped together in a plan. This approach lets you change prices without having to change your provisioning scheme. For example, you might have a single ''Gold'' product that has prices for $100/month, $1000/year, and $50 once with the alternative billing cycle and pricing options each represented by a different plan and the recurring and one-time prices represented by different prices.

Plans

Prices define the unit cost, currency, and (optional) billing cycle for both recurring and one-time purchases of products. Products help you track inventory or provisioning, and plans and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme. For example, you might have a single ''Gold'' product that has prices for $100/month, $1000/year, and $50 once.

Prices

Run a specified workflow. In the request body, you can include parameters that you want to pass to the workflow. For the parameters to be recognized and picked up by tasks in the workflow, you need to define the parameters first.

Workflows

The Query Runs operations allow you to create, retrieve, or cancel a Data Query job run.

Query Runs

List accounts

Other APIs

Multi-entity: List all entities that a user can access

Quickstart API

1 API

developers/api-docs/other-apis/quickstart-api

<body><main xmlns:jcm-link-man="http://jorsek.com/content-management/modules/linkmanagement" role="main"><article role="article" id="topic-9918" aria-labelledby="ariaid-title1"><h1 class="title topictitle1" id="ariaid-title1">zuora-footer</h1><div class="body"><div class="div custom-footer">
            <div class="div left-column"> <img class="image logo" src="https://zuora.deploy.heretto.com/v4/deployments/QPAZk6lsgXwvotedNERE/object/91e2cbe5-f650-465d-b2e0-001b64f6ed08?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJodHRwczovL2pvcnNlay5jb20vZXpkX29yZ2FuaXphdGlvbiI6Inp1b3JhIiwiaHR0cHM6Ly9qb3JzZWsuY29tL2V6ZC9vYmplY3RfdXVpZCI6IjkxZTJjYmU1LWY2NTAtNDY1ZC1iMmUwLTAwMWI2NGY2ZWQwOCIsImV4cCI6MTc5MzczNDIyMSwianRpIjoiNjY0NTdiYWNmZjUzNDA4NDhmZTk3YmFiYTQwNDcwOTIiLCJodHRwczovL2pvcnNlay5jb20vZXpkX2ZpbGVzZXQiOiJRUEFaazZsc2dYd3ZvdGVkTkVSRSJ9.23rFSaDcfd18vNEj46mhw34P6VyX-M3oljcoFVtBRtU">
            </div>
            <div class="div right-column">
                <p class="p footer-talk-to-expert"><a class="xref j-external-link" href="https://www.zuora.com/talk-to-sales/" target="_blank">Talk to an expert</a></p>
                <p class="p footer-watch-demo"><a class="xref j-external-link" href="https://www.zuora.com/resources/demo-on-demand/" target="_blank">Watch a demo</a></p>
                <p class="p"><a class="xref j-external-link" href="https://developer.zuora.com" target="_blank">Developer Center</a></p>
                <p class="p"><a class="xref j-external-link" href="https://www.zuora.com/about/legal/" target="_blank">Legal</a></p>
                <p class="p"><a class="xref j-external-link" href="https://www.zuora.com/privacy-statement/" target="_blank">Privacy Statement</a></p>
                <p class="p"><a class="xref j-external-link" href="https://www.zuora.com/terms-conditions/" target="_blank">Terms and Conditions</a></p>
                <p class="p">© 2026 Zuora Inc.</p>
            </div>
        </div></div></article></main></body>

zuora-footer

Developer Center

Find training and certifications to achieve your business needs

Zuora University

Connect, share, collaborate with the Zuora Community

Zuora Community

Fundamental Zuora information you should know

Basics

Explore entitlements for all Zuora product offerings

Entitlements

Learn the support and service policies at Zuora

Support and policies

Zuora Product Documentation

Monetize new offerings, create and manage subscriptions, and invoice customers

Zuora Billing

Collect and manage payments, reduce fraud, and boost acceptance

Zuora Payments

Build, customize, extend, and integrate with Zuora

Zuora Platform

Configure, price, and quote with speed and ease

Zuora CPQ

Optimize digital subscription Journeys and boost revenue growth

Zephr

Recognize, reconcile, and analyze revenue automatically

Zuora Revenue

Automate invoicing and collections to improve cash flow, mitigate financial risk, and ensure financial accuracy

Accounts Receivable

Analyze data, automate tasks, and interact with Zuora using AI

Zuora AI

What is new and what is changing for every release

Release Notes

Learn how to use Zuora REST API and client libraries

Developers

Learn how to use the advanced Zuora Payments solution.

Modernized Zuora Payments

The content for review before publishing.

Content for review

Get started

Check our API reference for your integration

Welcome to Zuora Product Documentation

Explore our rich library of product information

zuora-footer