Surcharge Configuration — Center Eligibility and Rates Management
Use the surcharge configuration screen to review which centers in your organization have surcharging enabled and to inspect the effective surcharge rates applied at each center. This article covers how to view center eligibility status, read the rates summary, and filter rates by payment processor.
Note: For conceptual background on how surcharges work, including state restrictions and card network rules, see Configure surcharges to pass credit card fees to guests.
Before you begin
Your organization must have Zenoti Payments configured with at least one active payment processor.
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
Surcharging and tips convenience fee are mutually exclusive per center. If a center already has a tips convenience fee configured, surcharging cannot be enabled for that center.
Surcharges apply to credit card transactions only. US law does not permit surcharging on debit card transactions.
Surcharging is not permitted in Connecticut, Maine, or Massachusetts. Centers in these states will not appear as eligible regardless of processor configuration.
Colorado and Oklahoma cap surcharges at 2% for all card networks. The system enforces these caps at save time — rates above the cap are rejected.
Steps
View the surcharge configuration screen
- Navigate to Configuration > Payments.
- Select Payment processor onboarding.
- Select Pass card fee to open the surcharge configuration screen.
The screen lists all centers accessible to your user account. For each center, you can see its surcharge eligibility status — whether surcharging is currently enabled or not.
At the top of the screen, a summary view displays:
- The total number of centers accessible to your account.
- The count of those centers that currently have surcharging enabled.
Use this summary to quickly assess your organization's surcharge coverage without scrolling through the full center list.
Inspect effective surcharge rates for a center
The per-center rates view combines live core rates from the payment processor with any locally saved rate overrides. The result is the effective surcharge rate that applies to each transaction at that center.
- On the surcharge configuration screen, locate the center you want to inspect.
- Select the center row to expand its rates view.
The rates view shows the following for each card network (Visa, Mastercard, American Express, Discover):
- The live core rate sourced from the payment processor.
- Any locally saved rate override for that center.
- The effective rate that will be applied to transactions.
Important: The effective rate is applied to the total transaction amount, including tips and taxes — not to the base service amount alone. Confirm that your configured rates account for this when reviewing compliance with state caps.
Inspect IC+ (Model 3) surcharge rates for a center
For centers billed on an IC+ (at-end-of-month) basis, a separate rates view is available. This view is intended for centers where the Surcharge on IC+ billing model is active.
- On the surcharge configuration screen, locate the center billed on IC+.
- Select the IC+ rates tab or section for that center.
The IC+ rates view displays:
- Live IC+ rates sourced from the payment processor.
- Locally saved IC+ surcharge overrides.
- Both the current rates and any proposed new rates, each carrying explicit payout-deduction and transaction-fee sets.
Note: The Surcharge on IC+ billing model is activated during processor onboarding and reflects the billing arrangement agreed upon at that time. Administrators do not set the IC+ billing model flag directly through this screen.
Filter rates by payment processor
If your organization uses more than one payment processor, you can narrow the rates view to a specific processor.
- On the surcharge configuration screen, locate the processor filter control.
- Select the processor you want to view from the available options.
The rates view updates to show only the centers and rates associated with the selected processor. Clear the filter to return to the full view across all processors.
Tips
- Use the summary count at the top of the screen to track how many centers have surcharging active before and after making configuration changes. This gives you a quick audit baseline.
- When reviewing IC+ rates, compare the current and proposed rate sets side by side before any changes take effect. The explicit payout-deduction and transaction-fee columns help you understand the net impact per transaction.
- If a center does not appear in the surcharge configuration screen, confirm that your user account has access to that center. The screen lists only centers accessible to the currently logged-in user.
- Apply the processor filter when your organization has centers on different processors — this prevents confusion between rate structures that differ by processor.
Troubleshooting
| Problem | Likely cause | Resolution |
|---|---|---|
| A center does not appear in the surcharge configuration screen | Your user account does not have access to that center | Ask your administrator to verify your center access permissions |
| A center shows as ineligible for surcharging even though the processor is configured | The center is in a prohibited state (Connecticut, Maine, or Massachusetts), or a tips convenience fee is already active for that center | Confirm the center's state and check whether a tips convenience fee is configured — surcharging and tips convenience fee are mutually exclusive per center |
| A rate override is rejected when saving | The entered rate exceeds the network maximum or a state cap (2% in Colorado or Oklahoma) | Reduce the rate to comply with the applicable cap; the system enforces limits at save time |
| The IC+ rates tab is not visible for a center | The center is not billed on the IC+ (at-end-of-month) model | The IC+ billing model is set during processor onboarding; contact your processor onboarding team to confirm the billing arrangement for that center |