ZenotiHelp

In-place membership upgrade/downgrade fee queue

ZTZenoti Docs Team Updated November 3, 2026 7 min readGuide

When a guest schedules an in-place membership upgrade or downgrade that carries an upgrade or downgrade fee, Zenoti creates a fee queue entry that tracks the fee invoice from creation through payment. A change with no fee needs no payment and is applied on its effective date. Understanding how this queue works helps you diagnose why a scheduled change has not yet taken effect and confirm when the transition completes automatically.

Audience: Front desk staff and administrators who manage scheduled membership upgrades and downgrades.

Availability: The membership upgrade/downgrade fee works with in-place membership upgrade and downgrade, which is a Beta feature. It must be enabled by Zenoti β€” contact your Customer Success Manager to request access.


On this page


Before you begin

  • The guest must have an active recurring membership with a scheduled in-place upgrade or downgrade already initiated.

  • You need the following permissions:

    Permission: Upgrade (under Memberships) β€” Required to initiate or manage a scheduled upgrade to a higher-tier membership. Admin path: Configuration > Security > Security roles > [your role] > Marketing Manager > Memberships > Upgrade

    Permission: Downgrade (under Memberships) β€” Required to initiate or manage a scheduled downgrade to a lower-tier membership. Admin path: Configuration > Security > Security roles > [your role] > Marketing Manager > Memberships > Downgrade

  • A fee invoice exists only when an upgrade or downgrade fee applies to the change. Zenoti creates it when the change is submitted, and the change takes effect only after it is paid.

How the fee queue works

When a guest's membership is scheduled for an in-place upgrade or downgrade that carries a fee, Zenoti records a fee queue entry that links the scheduled change to the fee invoice. The queue entry tracks:

  • The target membership the guest will transition to
  • Whether the action is an upgrade or a downgrade
  • The fee amount and applicable tax
  • The source of the fee (for example, a pro-rated amount or a fixed fee)
  • The effective date on which the transition should occur
  • An expiry date after which the queue entry is no longer valid
  • The current queue status β€” either Pending or Paid
  • A retry count and any error message if processing has failed

The transition from the current membership to the target membership does not occur until the fee invoice is paid. When the fee invoice is closed with a successful payment, Zenoti automatically detects the payment, retrieves the corresponding queue entry, and processes the upgrade or downgrade. No manual action is required to trigger the transition once payment is collected.

The fee invoice must be paid within the payment window β€” 30 minutes by default, counted from when the change is submitted. If it is not paid in time, Zenoti voids the fee invoice and cancels the scheduled change. If the fee invoice is voided before payment for any reason, the transition does not proceed and the guest remains on their current membership.

Note: The fee queue applies only to in-place upgrades and downgrades β€” scheduled changes that take effect without cancelling the current membership. It does not apply to immediate upgrades or downgrades that are processed at the time of the action.

Steps

View the fee queue status for a membership

Use the guest's membership details page to check whether a pending upgrade or downgrade fee invoice has been paid.

  1. Open the guest's profile from the Appointment Book or by searching for the guest.
  2. Select the Memberships tab on the guest profile.
  3. Select the membership that has a scheduled upgrade or downgrade. The membership opens in its detail view.
  4. Locate the Recurrence Details section. The fee queue status is displayed here, including:
    • Whether the fee invoice has been processed or voided
    • The invoice number associated with the fee
    • Whether a payment has been recorded against the fee invoice
  5. Review the status:
    • Pending β€” The fee invoice exists but has not been paid. The membership transition has not occurred.
    • Paid β€” The fee invoice has been paid and the membership transition has been processed.

Tip: If the status shows Pending and the guest expects the change to have taken effect, confirm that the fee invoice has been closed with a successful payment. See Pay the pending fee invoice below.

Pay the pending fee invoice

If the fee queue status is Pending, collect payment on the fee invoice to trigger the membership transition.

  1. From the guest's profile, select the Payments tab or navigate to the open invoice from the Recurrence Details section.
  2. Locate the fee invoice associated with the scheduled upgrade or downgrade.
  3. Select Pay to open the payment screen.
  4. Select the payment method and enter the required details.
  5. Confirm the payment. Zenoti closes the invoice and automatically processes the membership transition.
  6. Return to the Memberships tab and verify that the membership now reflects the target membership and that the fee queue status shows Paid.

Important: The membership transition does not complete until the fee invoice is paid. If the invoice is voided rather than paid, the transition will not occur and the guest will remain on their current membership.

Worked example: A guest is scheduled to upgrade from a Basic membership to a Premium membership on the 15th of the month. The upgrade fee is $25.00 plus applicable tax. On the 15th, the fee queue status shows Pending because the $25.00 fee invoice has not yet been paid. The front desk collects the $25.00 payment, closes the invoice, and the system automatically activates the Premium membership. The fee queue status updates to Paid.

Cancel a pending upgrade or downgrade

If a guest changes their mind before the fee invoice is paid, you can cancel the scheduled change. The cancellation removes the pending queue entry and voids the fee invoice.

  1. Open the guest's profile and select the Memberships tab.
  2. Select the membership with the pending upgrade or downgrade.
  3. In the Recurrence Details section, locate the pending change.
  4. To cancel a pending upgrade, select Cancel Upgrade. To cancel a pending downgrade, select Cancel Downgrade.
  5. A confirmation dialog titled Cancel Upgrade / Downgrade appears. Confirm the cancellation.
  6. Zenoti voids the fee invoice and removes the pending queue entry. The guest remains on their current membership.

Note: You can only cancel a pending upgrade or downgrade while the fee invoice status is Pending. Once the fee invoice has been paid and the transition has been processed, the change cannot be reversed through this flow.

Tips

  • Check the invoice status first. Before contacting support about a transition that has not occurred, confirm that the fee invoice is closed and paid β€” not open, voided, or failed. The transition triggers automatically on invoice closure.
  • Verify the effective date. The fee queue entry includes an effective date. If the current date is before the effective date, the transition may not yet be due even if the invoice is paid. Review the effective date in the Recurrence Details section.
  • Retry count indicates processing attempts. If the fee queue entry shows a non-zero retry count alongside an error message, the system attempted to process the transition but encountered an error. Note the error message and contact your administrator for further investigation.
  • Voided invoices block transitions. If a fee invoice is voided, the queue entry will not progress to Paid status. A new upgrade or downgrade must be initiated to create a fresh fee invoice and queue entry.
  • Upgrades and downgrades follow separate queue entries. Each scheduled change creates its own queue entry. If a guest has had multiple scheduled changes, each appears as a separate entry with its own invoice and status.
  • The 30-minute window starts at submission. The fee invoice must be paid within 30 minutes of the upgrade or downgrade being submitted. If the guest is not available to pay immediately, coordinate the timing of the submission and payment to avoid the invoice being voided automatically.

Troubleshooting

Symptom Likely cause Resolution
The membership has not changed to the target membership after the effective date The fee invoice is still in Pending status β€” it has not been paid Open the fee invoice from the Recurrence Details section and collect payment using Pay
The fee queue status shows Pending but no invoice is visible in the guest's payment history The fee invoice may have been voided Check the guest's invoice history for a voided invoice. If voided, initiate a new upgrade or downgrade to generate a fresh fee invoice
The fee queue entry shows a retry count and an error message The system attempted to process the transition after payment but encountered an error Note the error message and contact your Zenoti administrator. Do not attempt to re-pay the invoice
The Cancel Upgrade or Cancel Downgrade button is not visible The fee invoice has already been paid and the transition has been processed The change cannot be reversed through the fee queue. Contact your administrator to discuss options for the now-active membership
The Recurrence Details section does not show any pending upgrade or downgrade No in-place change has been scheduled, or the previous change was already completed or cancelled Confirm with the guest whether a change was requested. If needed, initiate a new upgrade or downgrade from the membership actions
The fee invoice was voided before the guest could pay The 30-minute payment window expired before payment was collected Initiate a new in-place upgrade or downgrade. Ensure the guest is present and ready to pay before submitting the change to avoid the window expiring again
Was this article helpful?
Your feedback helps us improve our documentation.