Enable permissions for Tips Payout
This article is the reference for the Security Role permissions that gate Tips Payout setup, the Same-Day Tips Adoption Report, and visibility into wallet bank account details. Other articles in the Tips Payout pipeline link here rather than restating the permissions.
Audience: Organization administrators and Security Role administrators enabling Tips Payout for their teams.
On this page
- Before you begin
- Permissions overview
- Recommended role-to-permission mapping
- Permission scope: organization vs. center
- Enable the permissions
- What users see when permissions are not granted
- Related articles
Before you begin
Permission required to edit Security roles: Manage under Configuration > Security > Security roles.
- Confirm Tips Payout is enabled at the organization level. If the organization is not yet onboarded for Tips Payout, see Set up Same-Day Tip Payouts for your business.
- Decide which roles need which permissions before editing each role — review the recommended role-to-permission mapping below.
Permissions overview
Three permissions gate Tips Payout setup, the Adoption Report, and bank-account visibility. The names below are the exact strings shown on the Security Role page.
| Permission | Section | What it gates | What the user can do |
|---|---|---|---|
| Configure Payment Settings | Administrator > Payments | Tips Payout setup and management | Onboard a center for same-day tips, link or delink centers from a funding account, change payout frequency and cutoff time, reinitiate failed payouts, accept Terms and Conditions, manage the Tips Payout pages, view business funding-account details. |
| MyZen Tips Adoption Report | Reports(V2) > Employee | Access to the Same-Day Tips Adoption Report | View the report, apply filters, opt employees in or out of same-day payouts, send onboarding reminders. |
| Access Zenoti wallet bank account details | Reports(V2) > Employee | Sensitive columns in the Adoption Report | View the full Bank Account Number, Routing Number, Bank Account Name, and Bank Account Type for each employee. Without this permission, those four columns are masked. SSN is always shown as last-4 digits regardless of this permission. |
Note: Older help content sometimes references Reports (v2) Settings for Employee as a permission. That phrase is a paraphrase — Reports V2 is a code framework, not a permission. The permission that gates wallet bank-account visibility is Access Zenoti wallet bank account details.
Recommended role-to-permission mapping
Use this table to decide which permissions to enable on each Security Role.
| Role | Configure Payment Settings | MyZen Tips Adoption Report | Access Zenoti wallet bank account details |
|---|---|---|---|
| Business owner / Organization administrator | Yes | Yes | Yes |
| Accountant or bookkeeper | Yes | Yes | Yes |
| Payroll administrator | No | Yes | Yes |
| Front-desk manager | No | Yes | No |
| Center manager | No | Yes | No |
| Therapist, provider, or front-desk staff | No | No | No |
Therapists, providers, and front-desk staff see their own wallet through the myZen app. They do not need any administrator permissions to receive same-day tips.
Permission scope: organization vs. center
| Permission | Scope | What this means |
|---|---|---|
| Configure Payment Settings | Organization-level only | Tips Payout setup is performed at the org level (Configuration > Payments > Tips Payout). The permission is granted on the org-level Security Role; centers cannot grant it independently. |
| MyZen Tips Adoption Report | Organization-level | The report itself is org-level; column filters let a user narrow to a single center. |
| Access Zenoti wallet bank account details | Organization-level | The four sensitive columns are visible across all rows in the report; they cannot be hidden for some centers and shown for others. |
If you need a center manager to see their center's adoption status without seeing other centers, assign the role to the user only at the center where the report should be visible. The report automatically filters by the user's accessible centers.
Enable the permissions
- At the organization level, go to Configuration > Security > Security roles.
- Open the Security Role you want to update.
- Open the Permissions tab.
- Expand the Administrator section and, in the Payments row, select Configure Payment Settings.
- Expand the Reports(V2) section and, in the Employee row, select MyZen Tips Adoption Report.
- If this role should see full bank account numbers in the Adoption Report, also select Access Zenoti wallet bank account details in the same Employee row. Grant this only to roles with a legitimate business need (typically payroll administrators).
- Click Save.
- Repeat for each Security Role that needs Tips Payout access.
Users assigned to the role pick up the new permissions on their next login.
What users see when permissions are not granted
| User state | What the user sees |
|---|---|
| Lacks Configure Payment Settings | The Tips Payout option does not appear under Configuration > Payments. Direct URL access returns a no-permission message. |
| Lacks MyZen Tips Adoption Report | The Tips Payout Adoption report does not appear under Reports > Employee. Direct report access returns a no-permission message. |
| Has MyZen Tips Adoption Report but lacks Access Zenoti wallet bank account details | The report opens, but Bank Account Number, Routing Number, Bank Account Name, and Bank Account Type are masked. SSN is shown as last-4 digits. CSV and Excel exports exclude the four sensitive columns. |
If a user reports that they cannot find the Tips Payout option after permissions are granted, ask them to sign out and sign back in.
Audit logging
Views of full bank account number and routing number in the Adoption Report are logged for audit, including the user ID, timestamp, employee viewed, and report context. Grant Access Zenoti wallet bank account details only to roles that genuinely need it.