IC Plus Rates Backup and Restore for Surcharge
When you enable or disable surcharge on an IC+ (Interchange-Plus) rate plan, Zenoti automatically protects your existing fee configuration by creating a backup of your current IC+ rates before applying any changes. If you later disable surcharge, Zenoti restores those backed-up rates to their original values. This article explains how the backup and restore process works and what to expect at each stage.
Audience: Payment administrators and organization owners who manage IC+ rate configurations for surcharge.
Before you begin
- Your organization must be configured with an IC+ rate plan through a supported payment processor (Adyen or Stripe).
- Surcharge must be enabled or in the process of being configured for your organization. For surcharge setup, navigate to Configuration > Payments > Process payments > Payment processor onboarding > Pass card fee.
- Surcharge and tips convenience fee are mutually exclusive per center — you cannot have both active on the same center simultaneously.
- Surcharge applies to credit card transactions only. US law does not permit surcharging on debit card transactions.
- Surcharging is prohibited in Connecticut, Maine, and Massachusetts. Colorado and Oklahoma cap surcharges at 2%.
- You need the appropriate payment administrator permissions to modify processor rate configurations.
Important: The backup and restore process is automatic. You do not manually trigger backups or restores — Zenoti performs these operations when you enable or disable surcharge. Understanding the process helps you verify that your rates are protected and correctly restored.
Steps
Understand when a backup is created
When surcharge is enabled for a subscriber and processor pair, Zenoti checks whether an active backup already exists for that combination before making any rate changes.
- If no active backup exists, Zenoti creates a backup of the current IC+ fee rates.
- If an active backup already exists for the same subscriber and processor, no new backup is created. This prevents duplicate backups from overwriting a valid saved state.
The backup captures the complete set of IC+ rate fields at the time surcharge is enabled, including all payout deduction rates, transaction fee rates, add-on rates, recurring and non-recurring monthly deduction rates, recurring and non-recurring threshold rates, digital payment option rates, and secondary markup settings.
Note: The surcharge add-on rate is stored separately from the backed-up IC+ rate structure. This means the surcharge add-on rate can be updated independently without affecting either the backup or the live IC+ rate tables.
Verify your rates before disabling surcharge
Before you disable surcharge, you can review the rates that will be restored. When you initiate the process of disabling surcharge, Zenoti retrieves the active backed-up IC+ fee rates for your subscriber and processor pair so you can inspect them.
- Navigate to Configuration > Payments > Process payments > Payment processor onboarding > Pass card fee.
- Select the option to disable surcharge for the relevant center or processor configuration.
- Review the rate values displayed — these are the IC+ rates that were in effect before surcharge was enabled and that will be restored upon confirmation.
- Confirm the action to proceed with disabling surcharge.
Important: Review the displayed rates carefully before confirming. Once you confirm, the restore operation applies immediately.
What happens when surcharge is disabled
When you confirm that surcharge should be disabled, Zenoti performs a restore operation that updates both the live IC+ fee table and the mirrored processor rate table in a single atomic transaction.
- Both tables are updated simultaneously from the backup record.
- If any part of the restore fails, the entire operation is rolled back and no partial changes are applied. Your rates remain in their pre-restore state until the issue is resolved.
- After a successful restore, the backup record is marked as voided (soft-deleted). This means the backup is no longer active and will not be used for future restore operations.
Note: Once the backup is voided after a successful restore, re-enabling surcharge will create a new backup of the then-current IC+ rates at that time.
Confirm the restore completed successfully
After disabling surcharge, verify that your IC+ rates have been correctly restored:
- Navigate to Configuration > Payments > Process payments > Payment processor onboarding.
- Open the rate configuration for the relevant processor.
- Compare the displayed IC+ rates against your records of the pre-surcharge configuration.
- If the rates do not match expectations, contact Zenoti support — do not attempt to manually edit rates until the discrepancy is investigated, as a failed restore would have been rolled back automatically.
Tips
- Keep a record of your pre-surcharge rates. Although Zenoti backs up your rates automatically, maintaining your own record of the IC+ fee configuration before enabling surcharge gives you an independent reference for verification after a restore.
- Only one active backup exists at a time. Because Zenoti skips creating a new backup when an active one already exists, your original pre-surcharge rates are preserved even if surcharge is toggled multiple times. The backup is only cleared after a successful restore.
- The surcharge add-on rate is independent. Changes to the surcharge add-on rate do not affect the backed-up IC+ rate structure or the live IC+ fee tables. You can update the surcharge add-on rate at any time without triggering a backup or restore cycle.
- Atomic restore protects data integrity. Because the restore updates both rate tables in a single transaction, you will never end up in a state where one table is updated and the other is not. Either both tables are restored, or neither is.
- Surcharge state is center-scoped. If your organization has multiple centers, each center's surcharge configuration and associated IC+ rate backup are managed independently. Disabling surcharge on one center does not affect other centers.
Troubleshooting
| Problem | Likely cause | Resolution |
|---|---|---|
| Rates after disabling surcharge do not match expected pre-surcharge values | The backup may have been created at a different point in time than expected, or the rates were modified after the backup was created | Review the rate history with your payment administrator and contact Zenoti support to inspect the backup record |
| Surcharge cannot be enabled because a backup already exists | A previous surcharge enablement created a backup that was never voided (surcharge was enabled but never fully disabled) | Disable surcharge through the standard flow to trigger the restore and void the existing backup, then re-enable surcharge |
| Restore operation failed and rates were not updated | A system error occurred during the atomic transaction; the rollback prevented partial changes | No rate data was changed. Retry the disable-surcharge action. If the failure persists, contact Zenoti support with the timestamp of the failed attempt |
| Surcharge add-on rate appears incorrect after a restore | The surcharge add-on rate is stored separately and is not part of the IC+ rate backup | Update the surcharge add-on rate independently through Configuration > Payments > Process payments > Payment processor onboarding > Pass card fee |
| Surcharge is not available for a center in Connecticut, Maine, or Massachusetts | Surcharging is prohibited in those states | Surcharge cannot be enabled for centers in those states. Consider whether a tips convenience fee is appropriate — note that surcharge and tips convenience fee are mutually exclusive per center |