Locker Tab β Advance Collection Blocked When Cycles Already Prepaid
When a locker already has future billing cycles covered by a prior advance collection, Zenoti disables the option to collect again until those prepaid cycles have been billed. This article explains what staff see when that block is in place, how the payment method selector behaves when an advance collection is available, and what the system displays when no supported payment method exists.
Audience: Front desk staff who manage locker assignments and billing from the guest profile.
On this page
- Before you begin
- When the Collect dues in advance button is disabled
- How the From dropdown displays eligible cycles
- Selecting a payment method before collecting
- When no supported payment method is available
- Tips
- Troubleshooting
- Related articles
Before you begin
The guest profile must be open and the Locker tab selected. For navigation, see Manage guest locker tab.
Advance collection for lockers must be enabled for your organization. If you do not see the Collect dues in advance option on any locker, contact your administrator.
To perform advance collection actions on a locker, you need write access to the Lockers section of the guest profile.
Permission: Lockers (under Guest Manager) with write access β required to interact with advance collection controls. Admin path: Configuration > Security > Security roles > [your role] > PERMISSIONS > Guest Manager > Lockers
When the Collect dues in advance button is disabled
If a locker already has future cycles covered by a prior advance collection that has not yet been fully billed, the Collect dues in advance button on the locker details panel appears in a disabled (greyed-out) state. Hovering over the button displays the following tooltip:
Future dues are already paid in advance for this locker. You can collect again after those cycles have been billed.
This prevents duplicate advance payments being applied to cycles that are already prepaid. The button becomes active again once each prepaid cycle has been invoiced and billed in turn.
To check which cycles are already prepaid, select View collections paid in advance on the locker details panel. This shows the schedule of cycles covered by the existing advance payment along with their due dates and amounts.
How the From dropdown displays eligible cycles
When an advance collection panel is available (the button is not disabled), the From dropdown lists each eligible future cycle using only its due date β for example:
- Jan 15, 2027
- Feb 15, 2027
- Mar 15, 2027
The cycle number prefix is not shown. Staff select the starting cycle by its due date, and the system calculates the advance amount from that cycle forward through the end of the selected range.
Selecting a payment method before collecting
When the advance collection panel opens, no payment method is pre-selected. Staff must explicitly choose a payment method before the Collect button becomes active.
To select a payment method:
- From the Appointment Book, open the guest's profile.
- Select the Locker tab.
- On the locker whose future cycles you want to prepay, select Collect dues in advance.
- In the advance collection panel, select the From date that represents the first cycle you want to prepay.
- Under Payment methods, select a saved card or bank account from the list, or select + Add a new card or bank account to add one now.
- Once a payment method is selected, the Collect button becomes active. Select Collect to process the advance payment.
Note: The payment method you select here applies only to this locker's advance collection. It does not change the default or backup payment method recorded on the locker, the guest's membership, or any other locker.
When no supported payment method is available
If neither a saved card or bank account nor the cash or terminal option is available for the locker, the advance collection panel displays the following note:
No supported payment method is available. Add a card or bank account on file first.
To resolve this, add a card or bank account to the guest's profile:
- On the guest profile, select the Payments tab.
- Select Add card or Add bank account and complete the entry.
- Return to the Locker tab and select Collect dues in advance again.
The advance collection panel will now list the new account as an available payment method.
Important: Cash and terminal options are not available for advance locker collections. Only saved cards and bank accounts on file are accepted for advance payments.
Tips
- Check the advance schedule before attempting collection. Select View collections paid in advance on the locker details panel to confirm whether existing prepaid cycles have been fully billed before expecting the button to become active again.
- Add payment accounts from the Payments tab first. If you regularly encounter the "no supported payment method" message for a guest, add a card or bank account while on the Payments tab before navigating to the Locker tab. This avoids mid-workflow interruptions.
- Due dates in the From dropdown follow the live billing schedule. If the locker billing date changes for any reason, the dates shown in the dropdown reflect the updated schedule at the time you open the advance collection panel.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| Collect dues in advance button is greyed out and the tooltip appears | Future cycles are already covered by a prior advance payment | Wait until each prepaid cycle has been invoiced and billed. Check the prepaid schedule using View collections paid in advance. |
| The From dropdown is empty or shows no options | All upcoming cycles are already prepaid, or no future cycles exist on the locker's schedule | Confirm the locker has active future cycles. If cycles are prepaid, the button will remain disabled until they are billed. |
| The Collect button remains inactive after selecting a From date | No payment method has been selected | Select a saved card or bank account from the payment methods list in the advance collection panel. |
| The panel shows "No supported payment method is available. Add a card or bank account on file first." | The guest has no saved card or bank account on file | Navigate to the Payments tab on the guest profile, add a card or bank account, then return to the Locker tab to retry. |