Reseller Account
The Reseller Account feature supports scalable, high-volume subscription management by delaying account metric calculations and allowing parallel API operations on partner accounts.
The Reseller Account feature enhances scalability for businesses that work with distributors and resellers or operate in a B2B model managing high volumes of subscriptions.
Typically, to prevent lock contention and API conflict errors on a single account, API calls must be executed sequentially (for example, creating orders one after another). However, when managing high volumes, such as more than 300 subscriptions on a single account, sequential processing might not scale effectively. The Reseller Account feature addresses this by delaying account metric calculations, allowing you to make parallel API calls for concurrent operations such as creating orders, standalone invoices, credit memos, and payments without lock conflicts
You can enable the Reseller Account feature in your Sandbox and Production environments using the self-service interface.
Flag an account as a partner account
When you flag an account as a partner account, Zuora calculates account metrics asynchronously. Examples include subscription creation, order changes, invoice generation, and payments. Specifically, the calculation of metrics is delayed for partner accounts. You can flag a customer account as a partner account through the Zuora UI or the REST API:
Zuora UI: When creating or editing an account on the Customer Account page, select the Partner Account checkbox in the Additional Fields section .
REST API: Use the Create an account or Update an account call and set the partnerAccount field to true.
Functional behavior and asynchronous metric calculation
When an account is flagged as a partner account, Zuora does not calculate account metrics synchronously. Instead, metric updates are performed asynchronously in the background when you perform any of the following operations:
-
Create orders, including subscription creation and order changes
-
Post billing documents (invoices, credit memos, and debit memos; memos require Invoice Settlement) os, and debit memos; memos require Invoice Settlement)
-
Unpost billing documents (invoices, credit memos, and debit memos)
-
Apply or unapply payments or credit memos
-
Issue refunds
Calculation schedule and best practices
-
Calculation interval: By default, Zuora calculates account metrics for partner accounts once every hour. This interval is configurable at the tenant level. To change the interval, submit a request via Zuora Global Support
-
Lockout considerations: Account metric calculations require obtaining an account lock. Setting a shorter interval increases the likelihood of competition lock errors during prolonged, high-volume traffic. As a best practice, avoid configuring shorter calculation intervals if your account processes continuous, large-scale concurrent operations
-
Tracking metric updates: Use the Retrieve an account or Retrieve an account summary to read the
lastMetricsUpdate, which indicates when the metrics were last calculated.
Affected account metrics
All account metrics except contractedMrr belong to the invoice owner account; contractedMrr belongs to the subscription owner account . Affected metrics include:
- balance
- creditBalance
- lastInvoiceDate
- totalInvoiceBalance
- totalDebitMemoBalance
- unappliedCreditMemoAmount
- unappliedPaymentAmount
- contractedMrr
For details on each metric, see the metrics object description in the Retrieve an account API reference.
Transfer subscription owners for reseller accounts
When transferring subscription owners between source and target accounts for reseller accounts through concurrent orders, metric calculation probably competes on the same accounts. Therefore, it is necessary to set the partnerAccount field to true for both the source and target accounts.
Supported objects and access approaches
The following table summarizes the fields and objects introduced or updated for the Reseller Account feature across Zuora interfaces:
Base object | Filed/Related object | Supported access approaches |
|---|---|---|
Account | partnerAccount
lastMetricsUpdate | Zuora UI, REST API, Account Data Source, AQuA, Data Query, Object Query |
Order | partnerAccount | REST API |