ZenotiHelp

Set up tips payout integration

ZTZenoti Docs Team Updated September 6, 2026 6 min readGuide

Zenoti can hand employee tips to an external payout provider instead of paying them through payroll or cash. The provider connection lives on the Tips V2 accordion of the Integration settings page. This article walks through the accordion for ADP Wisely, the provider offered there, and explains where MyZen Tips fits.


On this page


Before you begin

Permission: You need organization administrator access to configure the tips payout integration.

  • Your organization needs an ADP Wisely program, and each participating employee needs a Wisely card. Zenoti cannot issue either.
  • Decide which tips are paid out: all tips, or credit card tips only.
  • Identify the ADP funding account the payouts draw from.

Providers

Provider Route Where it is configured
ADP Wisely Zenoti - ADP Wisely connector in ADP Marketplace The Tips V2 accordion described in this article.
MyZen Tips Zenoti's MyZen platform Not on the Integration settings page. Zenoti processes MyZen payout batches on its own schedule; see Tips Provider: MyZen Tips.

Panels on the Tips V2 accordion

Panel What it holds
Provider The heading Select Your Integration Platform, the provider tile (Wisely by ADP), and Continue. Until a provider is chosen, every other panel shows Error! Choose a provider and click continue. with a Choose provider link.
Configuration The SYNC section (Start Date, Sync Time, Delay in days), the ACCOUNT section (Active switch and Connector Subscription Type:), the SETTINGS section (Funding Account, Mode of Tips to be processed), and Employee Mapping.
Locations The center grid: CENTER CODE, CENTER NAME, ACTIVE, plus the mapped ADP Wisely location.
Manual Sync The Tips row (Choose a date, Post) and the Employees row (Get).
Sync Schedule Schedule Jobs (Select Job, Add) and the job grid: JOB, JOB NAME, LAST RUN TIME, SYNC DATE, NEXT RUN TIME, SCHEDULE, SYNC DELAY, ENABLE JOB, STATUS, ORDER, ACTIONS.

Choose the provider

  1. Navigate to Configuration > Integrations > Integration settings and expand Tips V2.
  2. Open Provider, select the Wisely by ADP tile, and select Continue.

Configure the sync and the account

  1. Open Configuration.
  2. In SYNC, set Start Date (required) to the first business date whose tips should be paid out, Sync Time to the time of day the daily job runs, and Delay to the number of days to wait after a business day closes before its tips are posted.
  3. In ACCOUNT, turn Active on.
  4. Select Save. Zenoti confirms with Settings Saved Successfully.

Connect the ADP Wisely connector

Under Connector Subscription Type:, choose New to subscribe to a new Zenoti - ADP Wisely connector, or Existing to configure one you already have.

New connector. The panel reads Subscribe for Zenoti - ADP Wisely connector in ADP Marketplace leveraging the below encrypted code.

  1. Select Launch Subscription Wizard.
  2. Step 1 - Generate Encrypted Code: select Generate, copy the Encrypted Code (the unique code for your center), and select Next.
  3. Step 2 - Validate Encrypted Code in the Zenoti ADP Wisely Connector: in ADP Marketplace, subscribe to the Zenoti - ADP Wisely connector and enter the code when it asks, then select Next (or Back to regenerate).
  4. Step 3 - Verify your integration status: select Verify Status. Zenoti shows Account Name, Account ID, Subscription ID, Subscription Status, Effective Date, Sync Start Date, and Parent Center, and reports Your subscription details are retrieved successfully.
  5. Select AUTHORIZE, then Verify Authorization. Zenoti reports Zenoti is authorized to integrate with your ADP Wisely account.

Existing connector. The panel reads Configure your existing Zenoti - ADP Wisely connector using Subscriber ID in the below field.

  1. Enter the Existing Subscription ID of your connector.
  2. Select Save. Zenoti reports Your ADP Wisely credentials are successfully retrieved., or Please enter a valid Subscriber ID. if the ID is not recognized.

Choose the funding account and the tips mode

  1. Under SETTINGS, choose the Funding Account from Select a Funding Account. The list comes from ADP once the connector is authorized.
  2. Choose the Mode of Tips to be processed: All pays out every tip type; CC pays out credit card tips only. The row's help text reads Process credit card tips in Zenoti to external system on selected day.
  3. Select Save.

Map employees

Employee mapping decides which ADP Wisely account receives each Zenoti employee's tips.

  1. Under Employee Mapping, choose Auto (Employee ID) when your Zenoti employee codes match the ADP employee IDs, or Manual when they differ.
  2. For Manual, select Retrieve Employees from provider for mapping (the Sync button). Zenoti confirms with Employees are succesfully synced from ADP Wisely. and lists each Zenoti employee by Employee Code and Employee Name with a drop-down of names in ADP Wisely. Pick Do not Process for employees who should be skipped.
  3. Select Save. The counter reads <n> of <total> employees mapped; Zenoti rejects the save with Make sure you select unique employees if two Zenoti employees point at the same ADP account.

Map centers to locations

  1. Open Locations. The grid lists every center with its code and name, the ADP Wisely location it maps to, and an active switch. The row's help text reads Map the dedicated center on Zenoti to the location setup on external system.
  2. Choose a location for each center that pays out tips and turn its active switch on.
  3. Select Save. Zenoti confirms with Centers mapping saved succcessfully.

Run the first sync

The Manual Sync panel opens with the note that these actions must be done at the time of the initial integration, and that once sync schedules are set up there is no need for a manual sync.

  1. Open Manual Sync.
  2. On the Employees row, select Get to pull the employee list from ADP Wisely.
  3. On the Tips row, pick the business date in Choose a date and select Post to send that day's tips.
  4. Open Sync Schedule, add the tips job under Schedule Jobs (Select Job, Add) if it is not listed, and confirm it shows a NEXT RUN TIME. The daily job then posts each business day's tips after the configured delay.
  5. Confirm the status progresses from Waiting for Process to Initiated to Transfer Success within the provider's published processing window.

Payout statuses

Status Meaning
Waiting for Process The payout row is queued in Zenoti and has not yet been submitted to the provider.
Initiated The payout request has been submitted and accepted by the provider.
Transfer Success The provider has confirmed funds were moved to the employee's account.
Transfer Failed The provider rejected or failed to complete the payout.
Center Account Inactive The paying center's provider account is not active — payouts cannot be initiated until it is reactivated.

These are the complete set of payout statuses used across both providers.

  • Review tips payout reports after every run to catch Transfer Failed and Center Account Inactive rows early.

Handle setup failures

Symptom Cause Resolution
Error! Choose a provider and click continue. in every panel No provider tile chosen. Open Provider, select the tile, select Continue.
please ensure that your credentials are saved. The account section was not saved before authorizing. Select Save in Configuration, then authorize.
please make sure your account is active. Active is off. Turn Active on and save.
Your account is not configured at ADP Wisely. The subscriber ID or connector subscription does not exist on the ADP side. Complete the ADP Marketplace subscription, or check the subscriber ID with ADP.
Verification Failed! You are not authorized for this action The signed-in Zenoti user lacks the permission for the integration, or the ADP authorization did not complete. Sign in as an organization administrator and authorize again.
Please select a Funding Account / Please select mode of Tips to be processed A required setting is empty. Complete the setting and save.
Tips for a center never post The center is not mapped or its mapping is inactive. Fix the row in Locations.

Was this article helpful?
Your feedback helps us improve our documentation.