Proration and refund for membership freeze and unfreeze actions
Enable Zenoti to calculate and apply pro-rated charges or refunds when a guest's membership is frozen and later unfrozen. When this feature is active, all financial adjustments are rolled up into the primary membership invoice at the time of unfreeze β not when the freeze is initiated.
Audience: Administrators who configure membership billing behavior and front-desk staff who process membership freeze and unfreeze actions.
On this page
Before you begin
- Your organization must have at least one active recurring membership configured.
- The skip-billing-cycles freeze option must be available for the memberships you want to configure. Proration and refund calculations apply only when the skip-billing-cycles freeze option is selected at the time of freeze.
- You need the following permissions:
Permission: Freeze (under Memberships) β Required to freeze and unfreeze memberships. Admin path: Configuration > Security > Security roles > [your role] > Marketing Manager > Memberships > Freeze
Permission: Add (under Memberships) β Required to create membership definitions; Edit (under Memberships) β Required to modify them. Admin path: Configuration > Security > Security roles > [your role] > Marketing Manager > Memberships > Add
Permission: Add (under MembershipCategory) β Required to create membership categories if needed for organizing memberships. Admin path: Configuration > Security > Security roles > [your role] > Administrator > MembershipCategory > Add
Steps
Enable proration and refund for freeze actions
This is the parent toggle that must be turned on before the two sub-settings become visible.
Navigate to Configuration > Memberships > Membership actions > Freeze rules.
Locate the Enable proration and refund for freeze actions toggle.
Turn the toggle ON.
Two sub-settings appear below the toggle:
- Enable membership fee to be prorated for freeze actions
- Enable membership fee to be refunded for freeze actions
Select Save.
Note: Turning this toggle off after it has been enabled will hide the sub-settings. Any previously saved sub-setting values are retained but will not take effect while the parent toggle is off.
Important: The proration sub-setting (Enable membership fee to be prorated for freeze actions) has no effect unless the refund sub-setting (Enable membership fee to be refunded for freeze actions) is also turned on. If only proration is enabled and refund is off, the system will not apply any pro-rated adjustment. Enable both sub-settings together to activate proration behavior.
Enable proration for freeze actions
When enabled alongside the refund sub-setting, Zenoti calculates a pro-rated charge or refund based on the exact freeze and unfreeze dates when the skip-billing-cycles freeze option is selected.
- With Enable proration and refund for freeze actions turned on, locate Enable membership fee to be prorated for freeze actions.
- Turn the sub-setting ON.
- Select Save.
Important: Pro-rated charges and refunds apply to both individual memberships and family (add-on) memberships. Verify that your add-on member configuration is correct before enabling this setting.
Enable refund for freeze actions
When enabled, Zenoti calculates and applies a refund for the unused portion of the billing period covered by the freeze.
- With Enable proration and refund for freeze actions turned on, locate Enable membership fee to be refunded for freeze actions.
- Turn the sub-setting ON.
- Select Save.
Note: You can enable both sub-settings simultaneously. When both are active, Zenoti applies proration logic first and then calculates the refund for the unused portion of the billing period.
How financial adjustments are applied
Understanding when and how adjustments appear helps front-desk staff set guest expectations correctly.
- Timing: All financial adjustments β whether pro-rated charges or refunds β are rolled up into the primary membership invoice at the time of unfreeze, not when the freeze is initiated. No adjustment invoice is created at the point of freeze.
- Scope: Adjustments apply to both individual memberships and family (add-on) memberships.
- Freeze option dependency: Proration and refund calculations are triggered only when the skip-billing-cycles freeze option is selected. If a different freeze option is used, no proration or refund is calculated.
- Refund sub-setting required for proration: Proration calculations are only applied when the refund sub-setting is also enabled. Enabling proration alone without enabling refund will not produce any financial adjustment.
- ZMA availability: This feature is also available on the Zenoti Mobile App (ZMA). Front-desk staff using ZMA can process freeze and unfreeze actions and will see the same financial adjustments applied at unfreeze.
Worked example: A guest's monthly membership costs $100. The guest freezes on the 10th of the month using the skip-billing-cycles option and unfreezes on the 25th β a 15-day freeze period. When the membership is unfrozen, Zenoti calculates the adjustment for the 15 unused days and applies the resulting pro-rated amount or refund to the primary membership invoice at that point.
Tips
- Enable the parent toggle Enable proration and refund for freeze actions before attempting to configure either sub-setting. The sub-settings are not visible until the parent toggle is on.
- Enable both sub-settings together. The proration sub-setting has no effect unless the refund sub-setting is also on β the system blocks proration when refund is off.
- Communicate to guests that any financial adjustment will appear on their invoice at the time of unfreeze, not immediately when the freeze is applied. This prevents confusion about delayed charges or credits.
- If your organization uses family memberships, test the freeze and unfreeze flow on an add-on member before rolling out the feature broadly. Pro-rated adjustments apply to add-on members in the same way as primary members, and the combined adjustment appears on the primary membership invoice.
- This feature is available on ZMA. Ensure front-desk staff using ZMA are aware that the same proration and refund rules apply when processing freeze and unfreeze actions from a mobile device.
- Review your existing freeze reason configuration at Configuration > Memberships > Membership actions > Freeze rules to confirm that the skip-billing-cycles option is available and correctly configured before enabling proration.
Troubleshooting
The sub-settings for proration and refund are not visible.
The two sub-settings only appear when the parent toggle Enable proration and refund for freeze actions is turned on. Navigate to Configuration > Memberships > Membership actions > Freeze rules, confirm the parent toggle is on, and then select Save. The sub-settings should appear immediately after saving.
No financial adjustment appears on the invoice after unfreeze.
Proration and refund calculations apply only when the skip-billing-cycles freeze option was selected at the time of freeze. If a different freeze option was used, no adjustment is generated. Verify which freeze option was selected on the guest's membership record before investigating further. Also confirm that both sub-settings β proration and refund β are turned on under Configuration > Memberships > Membership actions > Freeze rules. If only the proration sub-setting is on and the refund sub-setting is off, the system will not apply any adjustment.
The adjustment amount appears incorrect for an add-on member.
Pro-rated charges and refunds for add-on (family) memberships are rolled into the primary membership invoice at unfreeze. If the amount looks unexpected, check the freeze and unfreeze dates recorded on the add-on member's membership record and confirm they match the intended period. The calculation is based on the exact dates, so any discrepancy in the recorded dates will affect the adjustment amount.
Front-desk staff on ZMA cannot see the proration adjustment after unfreeze.
Confirm that the feature is enabled at the organization level under Configuration > Memberships > Membership actions > Freeze rules. The ZMA reflects the same org-level settings as the web interface. If the setting is on and the adjustment is still not visible, ask the staff member to refresh the membership record after completing the unfreeze action.