Surcharge Configuration Management
This article explains how to view surcharge eligibility and rate information across your organization's centers in Zenoti Payments. Use the surcharge configuration surface to understand which centers have surcharges enabled and to review the per-center, per-processor rates that apply to credit card transactions.
Note: For conceptual background on surcharges and how they work in Zenoti Payments, see Configure surcharges to pass credit card fees to guests.
Before you begin
- Your organization must have Zenoti Payments configured with at least one supported processor (Adyen or Stripe).
- Surcharges apply to credit card transactions only. Surcharges on debit cards are not supported in the United States.
- Surcharge and tips convenience fee are mutually exclusive per center β a center cannot have both active simultaneously.
- Surcharges are calculated on the total transaction amount, including tips and taxes, not on the base amount alone.
- The following US states prohibit surcharging: Connecticut, Maine, and Massachusetts. Colorado and Oklahoma cap surcharges at 2% for all four card networks (Visa, Mastercard, American Express, Discover).
- You need access to the Zenoti Payments configuration area to view surcharge eligibility and rate data.
Steps
View surcharge eligibility across centers
The surcharge configuration surface lists all centers accessible to your user account, along with each center's surcharge eligibility status.
- Navigate to Configuration > Payments > Process payments > Payment processor onboarding.
- Select Pass card fee to open the surcharge configuration surface.
- Review the list of centers. Each row displays:
- Center name β the name of the center as configured in your organization.
- Surcharge eligibility β whether the center meets the requirements to have surcharging enabled.
- Surcharge enabled β whether surcharging is currently active for that center.
Note: The list includes only the centers your user account has permission to access. Centers outside your access scope do not appear.
Review the surcharge summary
A summary at the top of the surcharge configuration surface shows:
- Total centers β the total number of centers accessible to your account.
- Centers with surcharge enabled β the count of those centers that currently have surcharging active.
Use this summary to quickly assess your organization's surcharge adoption across centers before reviewing individual center details.
View per-center surcharge rates
Per-center surcharge rates combine live rates from the payments platform with any locally saved overrides. Rates are shown per center and per processor.
From the surcharge configuration surface, select a center to expand its rate details.
Review the rate information displayed for each card network:
Card network Rate type Rate value Visa Credit Displayed as a percentage Mastercard Credit Displayed as a percentage American Express Credit Displayed as a percentage Discover Credit Displayed as a percentage If a locally saved override is in effect for a center, the override rate is shown in place of the live rate.
Important: Server-side validation rejects non-compliant rates at save time. If a rate exceeds the per-network maximum or a state cap, the save is rejected. For Colorado and Oklahoma, the maximum permitted surcharge rate is 2% across all four card networks.
View IC+ (Interchange-Plus) surcharge rates
If your organization uses the IC+ (Interchange-Plus) billing model, you can view per-center, per-processor IC+ surcharge rates. These rates combine live IC+ rates with any locally saved IC+ overrides.
- From the surcharge configuration surface, select a center configured for IC+ billing.
- Review the IC+ rate details. Each rate set includes:
- Current rates β the rates currently in effect, including payout-deduction and transaction-fee components.
- New rates β upcoming rates that will take effect at the end of the current billing period, also including explicit payout-deduction and transaction-fee sets.
Note: The IC+ billing model (also referred to as Model 3 or Surcharge on IC+) is configured during processor onboarding. Administrators do not set the IC+ flag directly β it reflects the billing model agreed upon during onboarding.
Understand rate request validation
When rate data is requested for a set of centers, the system validates the request before returning results:
- The list of center identifiers must be present and must contain at least one entry. An empty or missing list returns a 400 Bad Request error.
- No entry in the list may be an empty identifier. Blank entries return a 400 Bad Request error.
- If a processor filter is included in the request, it must match a recognized processor. An unrecognized processor value returns a 400 Bad Request error.
These validations apply to both standard surcharge rate requests and IC+ rate requests.
Tips
- Use the surcharge summary count to identify how many centers still have surcharging disabled before a rollout. This helps you prioritize which centers to configure next.
- When reviewing IC+ rates, compare the Current rates and New rates columns to anticipate billing changes at the end of the month. Both sets include payout-deduction and transaction-fee components, so review both before communicating rate changes to center managers.
- If a center appears in the list but shows no rate data, confirm that the center has a supported processor (Adyen or Stripe) configured and that the processor onboarding is complete.
- Surcharges apply to recurring collections at the rate active on the collection date. If you update a center's surcharge rate, verify that the new rate is compliant before the next recurring billing cycle runs.
- Centers in Connecticut, Maine, or Massachusetts will not show surcharge eligibility β surcharging is prohibited in those states regardless of processor configuration.
Troubleshooting
| Problem | Likely cause | Resolution |
|---|---|---|
| A center does not appear in the surcharge configuration surface | Your user account does not have access to that center | Contact your organization administrator to verify your center access permissions |
| Rate data shows no values for a center | The center's processor onboarding is incomplete, or the center uses a processor that does not support surcharging | Confirm that the center has Adyen or Stripe configured and that onboarding is complete |
| A rate save is rejected | The rate exceeds the per-network maximum or the applicable state cap (2% in Colorado or Oklahoma) | Reduce the rate to comply with the applicable limit and attempt to save again |
| The IC+ rate section does not appear for a center | The center is not configured for the IC+ billing model | The IC+ model is set during processor onboarding β contact your Zenoti account representative if you believe the model should be IC+ |
| The surcharge summary count does not match the number of centers you expect | Your user account has access to a subset of centers in the organization | The summary reflects only the centers accessible to your account; organization-wide totals require broader access |