Welcome to Zuora Product Documentation

Explore our rich library of product information

Feature overview

The Reseller Account feature enhances scalability for businesses working with distributors and resellers by allowing parallel API calls and asynchronous account metric calculations.

The Reseller Account feature is specifically designed for businesses that work with distributors and resellers or operate in a B2B model, with a large number of subscriptions.

Typically, to prevent conflicts and being locked, you can make API calls sequentially, for example, creating orders for the same account one after another. However, as the workload increases, this sequential approach may not scale effectively. Therefore, when dealing with high-volume operations, you may need to make parallel API calls. This is where the new feature comes into play.

With this feature, you can flag an account as a partner account using the Zuora UI or REST API.

  • Through the Zuora UI, you can select the Partner Account check box in the Additional Fields section on the New Customer Account page.
  • Through the REST API, you can use the Create an account or Update an account operation to specify the partnerAccount field in the request.

If you flag a customer account as a partner account, the calculation of account metrics is performed asynchronously during operations such as subscription creation, order changes, invoice generation, and payments. Specifically, the calculation of metrics is delayed for partner accounts. However, you can still use the Retrieve an account or Retrieve an account summary operation to retrieve the time when account metrics are last updated from the value of the lastMetricsUpdate field.

This feature is particularly useful in scenarios where you have to create a large number of subscriptions or orders for reseller accounts, or when you perform data migration through standalone invoices for distributor accounts in concurrent API requests. By flagging an account as a partner account, you can streamline your operations and improve the scalability of your billing processes.

The Zuora UI, REST API, data source, AQuA, Data Query, and Object Query are enhanced to support the Reseller Account feature. The following table lists the detailed changes introduced in the Reseller Account feature.

Base object

Field/Related object

Access approaches

Account

  • partnerAccount
  • lastMetricsUpdate
  • Zuora UI
  • REST API
  • Account data source
  • AQuA
  • Data Query
  • Object Query

Order

  • partnerAccount
  • REST API

For a summary of REST API updates specific to this feature, see the "API updates for the Reseller Account feature" section in 2023 API Changelog (July 20, 2023) and REST API Reference .