Configure royalty payments
Royalty payments are franchise-style fees that operating centers (franchisees) pay to a parent organization (corporate / franchisor) based on revenue. Configure royalty categories, rules, center groups, financial-lock period, transfer schedules, and bank accounts to automate royalty calculation and collection across the franchise.
Important β corporate vs franchisee. This article is corporate-facing. Corporate users (the parent organization) configure rules and initiate transfers. Franchisee centers complete only the bank-account onboarding step and view transactions for transparency; they cannot edit rules or initiate transfers.
Note. For a conceptual overview, see Royalty and cross-center settlements.
On this page
- Enable royalty payments
- Royalty rule schema
- Where you enter the percentage on the rules screen
- Create royalty categories
- Create center groups
- How groups link to centers
- Configure financial-lock period
- Configure bank accounts
- Set transfer preferences
- Start Period
- Invoice Status filter
- Transaction Types filter
- Configure center start dates
- Modified Cash accounting
- Per-transaction royalty deduction (alternative mode)
- Automatic royalty collection
- Editing rules and bank accounts after launch
- Reports
Before you begin
Permission: Manage Business Payments (under Payments) β Required to configure royalty rules, categories, groups, bank accounts, and to initiate transfers.
Who can do this. Corporate-org users only. Franchisee centers can view royalty data and complete their own bank-account onboarding, but cannot edit rules or initiate transfers.
- Royalty configuration requires completing the business payments onboarding wizard.
- Your organization's accounting model must be Modified Cash. Royalty calculations only run for orgs using Modified Cash; the Accrual and Cash accounting models are valid org settings but do not currently produce royalty calculations. See Modified Cash accounting.
- All centers in the organization must complete bank-account onboarding before corporate can initiate royalty transfers across centers.
- US region only. Royalty payments are currently available for organizations in the United States only. Contact your account manager if you need regional availability details.
Known limitations:
- Royalty rules operate at the category-and-group level. There is no built-in monthly minimum collection enforcement (for example, "collect at least $X per period regardless of revenue"). If your franchise agreement requires a minimum, enforce it through rate configuration (fixed fee per period) rather than a minimum-floor setting, as no such floor is available in the current product.
- Per-tier or per-revenue-band rules are not currently a built-in rule type.
Enable royalty payments
- Open Configuration > Payments > Business payments > Set up.
- Open the Royalty section.
- Enable the Royalty feature.
- Review and accept the Terms and Conditions for business payments. Terms acceptance is tracked per organization and is required before any royalty features can be used.
- The system displays the royalty onboarding wizard. Continue to the next sections.
Royalty rule schema
A royalty rule defines what to charge against which revenue, and at what rate. Configure rules per category.
| Rule field | Options |
|---|---|
| Category | Service revenue, Product revenue, Membership revenue, or any organization-defined category (see Create royalty categories). |
| Rate type | Percentage of cash-collected revenue, or Fixed fee per period. |
| Rate value | The percentage (e.g., 5%) or fixed amount (e.g., $500/month). |
Example. Set a 5% royalty on all service revenue and a 3% royalty on retail product sales for franchise centers in Group A. Set a flat $500/month marketing fee that applies to all centers regardless of revenue.
Where you enter the percentage on the rules screen
The rules-configuration screen renders one row per royalty category for the group you are editing. For each row:
- The Category column shows the category name (Service, Product, Membership, etc.). This is read-only on the rules screen β categories are managed under Create royalty categories.
- The Rate type dropdown lets you choose Percentage of revenue (default) or Fixed fee.
- The Rate value text field is where you enter the number β
5for 5%, or500for a $500 fixed fee. The currency /%symbol is appended by the UI based on Rate type. - The Applies to column shows which revenue bucket the rate applies to. For service categories, the bucket is the sum of cash-collected service revenue for the period; for product, the sum of cash-collected product revenue; etc. The bucket is fixed by the category type.
The rate is per category, per group β not per individual service or per product. If you need different rates for different service categories (e.g., 5% on hair services, 3% on spa services), create separate categories under Create royalty categories, then enter different rates per category on this screen.
Per-tier or per-revenue-band rules (e.g., 4% under $50K and 5% above) are not currently surfaced as a built-in rule type.
Create royalty categories
Royalty categories define the revenue types included in royalty calculations.
- In the royalty configuration, navigate to Categories.
- Add a category.
- Enter the category name and description. Common categories include:
- Service revenue β fees on income from guest services.
- Product revenue β fees on retail product sales.
- Membership revenue β fees on membership dues.
- Initial franchise fee β one-time fee charged when a center joins.
- Marketing or advertising fee β recurring contribution to brand marketing.
- Technology fee β recurring contribution to platform / IT costs.
- Configure the rate (percentage or fixed) for the category. See Royalty rule schema.
- Click Save.
You can review and edit categories using the three-dot menu after creation.
Create center groups
Center groups let you apply the same royalty rules to a set of centers rather than configuring each one individually. Create one or more groups when different centers carry different rates.
- Navigate to Royalty Groups.
- Click Create Group.
- Enter a group name.
- Add centers as subscribers in this group (the centers that the group's rules apply to). The list of centers associated with the group appears under Centers Associated.
- Associate the group with one or more royalty categories and their rates.
- Click Save.
How groups link to centers
The groupβcenter relationship is a many-to-one subscription:
- A group is a named container for a set of royalty rules (category Γ rate).
- A center is linked to exactly one group. Each center subscribes to a single group; that group's rules govern its royalty calculation.
- Centers are added to a group via the group's Centers Associated panel β select centers from the org's center directory and they become subscribers.
- A center that is not a subscriber to any group does not have royalty calculated for it.
To see which centers are in a group, open the group and check the Centers Associated panel. To move a center to a different group, open the destination group, add the center, and the center's previous group association is replaced (each center can be in at most one group).
You can create, update, and delete groups as your franchise structure changes. Note that changes to a group's category-rate associations affect future calculation periods only; calculations already run are not retroactively recomputed.
Configure financial-lock period
The financial lock period is the window during which invoice modifications (adjustments, refunds, voids) are still allowed for a closed period. Royalty calculations wait for this window to close to ensure the calculated revenue base is stable before fees are computed and transferred.
| Field | Default | Recommended |
|---|---|---|
| Financial lock period | 90 days (hardcoded default if no override is set) | 2β5 days for most franchise operations |
The per-organization override is not on the Configuration pages. Zenoti sets the Royalty V2 Financial Lock Days Override value for your organization β contact Zenoti Support with the number of days you need (0 means "use the 90-day default"). Lower values reduce the lag between period end and earliest royalty initiation.
Important β cross-center blocking. The processing date for a royalty period is calculated as
period_end + max(financial_lock_period across associated centers). Royalty transfers cannot be initiated until the processing date passes for every center in the org. If Center A has a 30-day lock and Center B has a 5-day lock, the org's earliest royalty initiation date is end-of-period + 30 days. One non-standard center delays royalty collection for all others. To avoid this, standardize the lock period across centers before enabling royalties.
Configure bank accounts
Set up bank accounts for receiving royalty transfers (corporate side) and for the centers that owe royalties (franchisee side).
- Navigate to the bank account section within royalty configuration.
- Click Add Bank Account.
- Enter the bank account details for the corporate royalty-receipt account, then for each center's debit account.
- Verify each bank account using micro-deposit verification:
- Zenoti debits a small verification amount from the account (within 1β3 business days).
- The center checks their bank statement for the exact amount.
- The center enters that exact amount in Zenoti to verify the account.
- The system tracks onboarding status per center. Verified accounts can be used for royalty debits; unverified accounts cannot.
Note. Common verification failures include "account not found" (incorrect account number) and "unauthorized" (the account is not authorized for ACH debit). If verification fails repeatedly, contact Zenoti Support; the number of automatic retry attempts and the lockout window are not currently surfaced in the UI.
Important β onboarding gates transfers. All centers in the organization must complete bank-account onboarding before corporate can initiate royalty transfers across centers. A single center that hasn't onboarded blocks the entire organization's royalty collection. Corporate can track onboarding status per center in the bank account dashboard. When a new center joins after initial setup, that new center must onboard before the next transfer cycle can be initiated.
Set transfer preferences
- Navigate to Royalty Preferences.
- Set the Settlement frequency β Monthly or Weekly.
- Set the Start Period (visible only when Settlement frequency = Weekly β see Start Period).
- Set the Invoice Status filter (see Invoice Status filter).
- Set the Transaction Types filter (see Transaction Types filter).
- Click Save.
Choose Monthly for the typical franchise cadence; choose Weekly when faster cash settlement is preferred and the financial-lock period has been shortened to a few days.
Start Period
The Start Period field defines the day of the week or month on which a calculation period begins. It is visible only when Settlement frequency is set to Weekly (not for Monthly, which always uses the calendar month).
- For Weekly settlement, choose the day of the week the period begins (Monday, Tuesday, β¦, Sunday). The week ends on the day before the chosen start day.
- For Monthly settlement, the period is the calendar month and the field is hidden.
Note β Start Period vs Royalty start date. The Start Period field on Royalty Preferences is org-wide and defines when each calculation cycle's clock starts ticking once collection is active. It is distinct from the per-center Royalty start date (Configure center start dates) β that field defines when royalty collection begins for each center.
Invoice Status filter
The Invoice Status filter controls which invoice rows feed the royalty calculation for each period. Three values are available (defined in invoiceStatus.enum.ts):
| Value | Includes | Use when |
|---|---|---|
| Both | Invoices regardless of state | You want to include both open and closed invoices in the calculation. Rare for Modified Cash franchises. |
| Open | Invoices with a remaining balance | You want to include partial-paid invoices in the period revenue. Rare. |
| Closed | Invoices that have settled (no further payments or modifications expected) | Default for franchise operations on Modified Cash accounting. |
Most franchises run on Closed to avoid recomputing royalty when an invoice is later refunded or adjusted.
Transaction Types filter
The Transaction Types filter controls which transaction sub-types contribute to the royalty calculation base. Four values are available (defined in royaltyTransactionTypesIncluded.enum.ts):
| Value | Includes | Typical use |
|---|---|---|
| All | Sales + Refunds + Tax + Tip & SSG | All revenue lines feed royalty. Rare. |
| Sales and Refund | Sales β Refunds, excluding tax and tips | Default and most common β royalty is calculated on net product/service revenue. |
| Tax | Tax lines only | Specialty: when royalty is calculated on tax collected. Very rare. |
| Tip & SSG | Tips and Service Surcharge Gratuity | Specialty: when royalty is calculated on tips/gratuity. Rare. |
Most franchises calculate royalty against Sales and Refund only. Verify the filter selection with your franchise agreement before changing the default.
Configure center start dates
Define when royalty collection begins for each center. Useful when centers join the franchise on different dates.
- Navigate to center-level royalty settings.
- For each center, set the Royalty start date. Collections are calculated only for periods after this date.
- Click Save.
Modified Cash accounting
Royalty calculation only runs for organizations using the Modified Cash accounting model. Modified Cash means revenue is recognized when cash is collected, not when service is delivered, with adjustments for known liabilities. Royalty is calculated on the period's cash-collected revenue minus refunds.
If your organization uses Accrual or standard Cash accounting, the org settings allow those values, but royalty calculations will not produce results. Switch the org accounting model to Modified Cash before enabling royalties, or contact Zenoti Support if Modified Cash is incompatible with your operating model.
Per-transaction royalty deduction (alternative mode)
Per-transaction royalty deduction is available but requires enablement by Zenoti Support on a per-organization basis. Contact Zenoti Support to enable per-transaction mode. Once enabled, royalty fees are deducted from each invoice rather than accumulated for periodic batch settlement. Use this mode when continuous (per-invoice) deduction better fits your franchise operating model than periodic batch collection.
Automatic royalty collection
Once configured, royalty payments can be collected automatically through the recurring payment system. The system calculates royalty amounts per center based on the configured rules, categories, and time periods, then processes bank transfers on the configured schedule.
For membership billing configuration that triggers recurring collections, see the Memberships category.
Editing rules and bank accounts after launch
| Change | Effect |
|---|---|
| Edit a category rate | Affects future calculation periods only; calculations already run are not retroactively recomputed. |
| Add or remove centers in a group | Effective for future periods only. |
| Update a bank account | The new account is used for transfers initiated after the update. In-flight transfers (already submitted to the bank) are not redirected. |
| Delete a category | Soft-disable for future periods; historical records remain. |
Reports
Royalty configuration drives two reports β one is per-period summary, the other is per-row audit trail. Both are accessible to corporate-org users with Manage Business Payments permission. Franchisee centers can view their own rows; only corporate users can act on them (Reinitiate, Waive, Approve).
| Report | What it shows | When to use it | Access |
|---|---|---|---|
| Royalty Net Settlement | Aggregate per-center transfer summaries for a period β total calculated, total transferred, net settlement balance per center. | Monthly / weekly accounting close; reconciling royalty receipts to per-center bank settlements. | Reports > Zenoti Payments > Business Payments: Royalty |
| Royalty fees transaction history | Per-period, per-center row-level audit trail with calculated amount, manual adjustment, status, and action affordances (Reinitiate / Waive / Approve). | Audit a specific royalty calculation; resolve a Reversed row by reinitiating; record an adjustment with a Notes reason. |
Reports > Zenoti Payments > Transaction History : Royalty |
To drill into how a calculated amount was derived for a specific period and center, use the calculation drill-down in Calculate and transfer royalties.
For the 4-value royalty transaction status enum (Processing, Settled, Reversed, Waived) and the action affordances available per status, see Royalty fees transaction history β Royalty transaction statuses.