ZenotiHelp

Billing Operations β€” Internal Subscription Management Tool

ZTZenoti Docs Team Updated October 17, 2026 6 min readGuide

The Billing Operations page in the CMS portal gives Zenoti-internal operators a single location to look up subscriptions for an organization and perform manual remediation actions when automated billing processes need intervention. Use this page to trigger subscription activations, control the run state of individual products, and submit usage data manually.

Audience: Zenoti-internal operators who manage customer subscriptions and require direct access to billing remediation tools.

Before you begin

  • You must have access to the Zenoti CMS portal. This page is not accessible to customers or organization administrators.
  • You need the organization ID for the organization whose subscriptions you want to manage. If you are working with a center-level subscription, also have the center ID or center name available.
  • Confirm with the account team which subscription requires remediation before performing any manual action. Manual activation, run-state changes, and usage submissions affect live billing records.

Important: Cancelled and expired subscriptions do not appear on this page. If you cannot locate a subscription, verify its status in the billing service before concluding it is missing.

Steps

Look up subscriptions for an organization

  1. Open the CMS portal and navigate to the Billing Operations page.
  2. The page displays three collapsible sections: Activation, On/Off, and Usage. No subscription data loads until you open a section and supply an organization ID.
  3. Expand the section you need to work in.
  4. Enter the organization ID in the provided field.
    • If you are working with a center-level subscription, also enter the center ID or select the center name where prompted.
  5. The section loads the matching subscriptions. Organization-level subscriptions display the organization ID. Center-level subscriptions display the organization ID alongside the center name and center ID so you can distinguish them at a glance.

Note: Cancelled and expired subscriptions are hidden from all three sections. Only active, paused, or otherwise non-cancelled and non-expired subscriptions appear.


Activate a subscription manually

Use the Activation section when an organization has a bundle subscription that did not activate automatically and requires a manual trigger.

  1. Expand the Activation section and look up the organization as described above.
  2. Review the subscriptions listed. Only subscriptions that are not cancelled or expired appear.
  3. Locate the bundle subscription that requires activation.
  4. Select the action to trigger a manual activation for that subscription.

Important: The activation request uses a 30-second timeout to accommodate the upstream billing service processing time. Do not close or refresh the page while the activation is in progress. If the request times out, check the billing service directly before retrying to avoid duplicate activations.

Tip: If the activation fails, the page displays a translated error message from the billing service error-code registry. Note the message and refer to the registry to determine the root cause before retrying.


Turn a product on or off

Use the On/Off section to change the run state of individual target products within a subscription β€” for example, to stop a product that is generating incorrect usage or to restart one that was stopped in error.

  1. Expand the On/Off section and look up the organization.
  2. Each target product within the subscription shows its current run status:
    • Active β€” the product is running.
    • Stopped β€” the product has been turned off.
    • Unavailable β€” the product cannot be started or stopped at this time.
  3. For a product showing Active, select Turn Off to stop it.
  4. For a product showing Stopped, select Turn On to start it.
  5. On a successful response from the billing service, the displayed run status updates immediately in the page to reflect the new state.

Note: Products with a status of Unavailable do not offer Turn On or Turn Off actions. No action is available until the product's status changes.

Tip: The status update is optimistic β€” the page reflects the new state as soon as the billing service confirms success. If the billing service returns an error, the status reverts and the page displays a translated error message.


Submit usage manually

Use the Usage section to record consumption for a target product when usage was not submitted automatically.

  1. Expand the Usage section and look up the organization.
  2. The section lists each target product within the subscription.
  3. For the product you need to update, enter the following:
    • Unit of measure β€” the unit type that applies to the product's usage (for example, transactions, sessions, or messages, as defined for that product in the billing service).
    • Quantity β€” the numeric amount to submit for that unit of measure.
  4. Submit the usage record for that product.
  5. Repeat for any additional products in the subscription that require manual usage submission.

Important: Manual usage submission updates the billing service directly. Verify the unit of measure and quantity with the account or engineering team before submitting. Incorrect submissions may affect billing calculations for the organization.


Worked example: An organization's AI bundle subscription activated but one agent is not reporting usage. The operator opens the Usage section, enters the organization ID ORG-00123, locates the affected agent product in the list, enters a unit of measure of conversations and a quantity of 47, then submits. The billing service confirms the submission and the operator records the action in the support ticket.

Tips

  • Always verify the organization ID before performing any action. Actions taken on the wrong organization affect live customer billing records and may require engineering intervention to reverse.
  • If an error message appears after any action, use the billing service error-code registry to translate the code before escalating. Unknown codes fall back to a generic error message β€” collect the raw response from the network log and include it in your escalation.
  • When managing center-level subscriptions, use both the center name and center ID displayed in the subscription list to confirm you are acting on the correct center. Multiple centers in the same organization can have separate subscriptions for the same add-on.
  • The On/Off run-state change and usage submission sections are independent. Stopping a product in the On/Off section does not submit or reverse any usage β€” handle usage separately in the Usage section.
  • Activation requests time out after 30 seconds. If you are activating a subscription during a high-traffic period, be prepared for the request to timeout and allow the billing service time to process before confirming that activation did not occur.

Troubleshooting

The subscription I need does not appear in any section.

The subscription may be cancelled or expired. Cancelled and expired subscriptions are hidden from all sections of this page. Check the subscription status in the billing service directly. If the subscription is active but still not appearing, confirm that you have entered the correct organization ID and, for center-level subscriptions, the correct center ID.

The activation request timed out.

The activation call uses a 30-second timeout. A timeout does not necessarily mean activation failed β€” the upstream billing service may have continued processing after the request timed out. Check the billing service status for that subscription before retrying. Triggering a second activation on a subscription that already activated may create duplicate billing records.

A Turn On or Turn Off action failed and the status did not update.

When the billing service returns an error, the run status displayed on the page reverts to its previous state. Note the error message shown, look up the error code in the billing service error-code registry, and resolve the underlying issue before retrying. If the code is unrecognized, the page shows a generic error β€” collect the raw error details and escalate to the billing service team.

The usage submission was accepted but the billing service shows incorrect totals.

Manual usage submissions are applied directly to the billing record. If an incorrect quantity was submitted, contact the billing service team to request a correction or reversal. This page does not provide a mechanism to undo a submitted usage record.

A product shows Unavailable in the On/Off section.

The Unavailable status means the billing service cannot process a run-state change for that product at this time. No Turn On or Turn Off action is available. Wait and check again, or contact the billing service team to determine whether there is a blocking condition on that product's subscription.

Was this article helpful?
Your feedback helps us improve our documentation.