Surcharge Configuration — Self-Service Wizard and Center Eligibility Dashboard
The surcharge configuration dashboard and self-service wizard let you review surcharge eligibility across your centers and enable surcharges without contacting Zenoti. Administrators can see which centers qualify, view live and saved rates for each billing model, and queue enablement requests that Zenoti processes in the background.
Note: For conceptual background on surcharges, billing models, and state restrictions, see Configure surcharges to pass credit card fees to guests.
Audience: Organization administrators who manage payment configuration across multiple centers.
Before you begin
Your organization must have Zenoti Payments active and at least one center with a supported processor configured.
Surcharges and tips convenience fees are mutually exclusive per center. If a center already has a tips convenience fee enabled, surcharge cannot be enabled for that center.
Surcharges apply to credit card transactions only. US law does not permit surcharging debit card transactions.
Surcharging is prohibited in Connecticut, Maine, and Massachusetts. Centers in those states will not appear as eligible.
Colorado and Oklahoma cap surcharges at 2% for all card brands. The wizard enforces this cap at save time — rates above the cap are rejected before the request is queued.
You need the following permissions:
Permission: Available to staff with payment-configuration permissions; specific security object under verification.
Permission: Reconcile Payments (under Payments) — Required to access reconciliation reports linked from the payment dashboard. Admin path: Configuration > Security > Security roles > [your role] > Permissions > Payments > Reconcile Payments
Steps
Review the surcharge eligibility dashboard
- Navigate to Configuration > Payments > Process payments > Payment processor onboarding.
- Select Pass card fee to open the surcharge configuration dashboard.
- Review the summary view at the top of the page. It shows:
- The total number of centers accessible to your administrator account.
- The count of centers that currently have surcharge enabled.
- Scan the center list below the summary. Each row shows:
- The center name.
- The center's surcharge eligibility status.
- To view per-center, per-processor surcharge rates, select a center row. The rates view combines live rates from the payments API with any locally saved surcharge overrides, for both the Blended and IC+ (Surcharge-on-IC+) billing models.
Note: Only centers accessible to your administrator account appear in the dashboard. If a center is missing, verify that your security role includes access to that center.
Enable surcharges using the self-service wizard
From the surcharge configuration dashboard, select the centers you want to enable surcharges for. You can select one or multiple centers.
Select the option to start the surcharge enablement wizard.
Work through the wizard steps:
- Pass-on percentage — Enter the surcharge rate you want to pass to guests. The rate must comply with card network maximums and any applicable state caps. The wizard rejects non-compliant rates at save time.
- Billing model — Select either Blended or IC+ (Surcharge-on-IC+). The billing model determines how the surcharge is calculated alongside your processor fees.
- IC+ migration date (IC+ model only) — If you selected IC+, optionally specify the date on which the center should migrate to IC+ billing. Leave this blank to use the default migration schedule.
Review your selections on the confirmation screen. Verify the pass-on percentage, billing model, and migration date (if applicable) for each selected center.
Submit the wizard. Each selected center is queued as a separate surcharge enablement request.
Important: Once submitted, requests are processed asynchronously. The wizard does not wait for processing to complete before returning you to the dashboard. Refresh the dashboard to see updated statuses.
Monitor surcharge enablement request status
- Return to the surcharge configuration dashboard after submitting the wizard.
- Locate the centers you submitted. Each center's row reflects the current processing status of its enablement request.
- If a request fails, the dashboard records the specific wizard step at which the failure occurred. This lets you identify whether the failure was in rate validation, billing model assignment, or another step, without needing to re-enter all settings.
- For centers with failed requests, correct the identified issue and resubmit through the wizard.
Note: Each center's request is processed independently. A failure for one center does not affect the processing of other centers in the same batch.
Tips
- Check eligibility before selecting centers. Review the eligibility status column in the dashboard before starting the wizard. Selecting an ineligible center — for example, one in Connecticut, Maine, or Massachusetts — will result in a failed request.
- Use the rates view to compare billing models. Before committing to Blended or IC+, open the per-center rates view to see how live rates and any saved overrides differ between the two models. This helps you choose the model that best fits each center's transaction profile.
- Surcharges apply to recurring collections. When you enable surcharges for a center, the surcharge rate active on the collection date applies to recurring membership and package payments processed for that center. Confirm your rate is set correctly before the next collection cycle.
- Verify state restrictions for multi-center organizations. If your organization operates in multiple states, filter the dashboard to identify centers in restricted or capped states before running the wizard. Submitting a request for a prohibited-state center wastes a queue slot and generates a failure record.
- Surcharge is self-service. You do not need to contact Zenoti to enable or disable surcharges. All configuration is available through the dashboard and wizard described in this article.
Troubleshooting
| Problem | Likely cause | Resolution |
|---|---|---|
| A center does not appear in the dashboard | Your administrator account does not have access to that center, or the center does not have a supported processor configured | Verify your security role includes the center; confirm the center has Zenoti Payments active |
| The wizard rejects the rate I entered | The rate exceeds the card network maximum or the state cap (2% for Colorado and Oklahoma) | Lower the rate to comply with the applicable cap and resubmit |
| A center shows as ineligible | The center is in a prohibited state (Connecticut, Maine, or Massachusetts), or it already has a tips convenience fee enabled | Surcharges cannot be enabled for prohibited-state centers; disable the tips convenience fee before enabling surcharges |
| A request shows a failure status | The background job encountered an error at a specific wizard step | Review the step recorded in the failure details, correct the underlying issue, and resubmit the wizard for that center |
| The dashboard summary count does not update after submission | Requests are processed asynchronously and the count reflects completed processing only | Wait a few minutes and refresh the dashboard; if the count still does not update, check the individual center rows for failure status |
| Surcharge is not appearing on guest receipts after enablement | The request may still be processing, or the center's processor configuration has not propagated | Confirm the center's request status shows as successfully processed; if so, run a test transaction to verify the surcharge banner appears at checkout |