ZenotiHelp

Configure tips payout notifications

ZTZenoti Docs Team Updated October 17, 2026 3 min readHow-to

Same-Day Tip Payouts supports automated notifications that inform employees about their tip earnings and payouts. You can configure notification templates with dynamic macros that pull payout data into the message content.

Note: For conceptual background, see Tips Payout Overview.

Audience: Administrators who configure notification templates for tips payout.


On this page


Before you begin

Available macros

Use these macros in your notification templates to include dynamic content:

Macro Description Example output
[yesterday_tips] Employee's tip earnings from the previous day $45.50
[today_tips] Employee's tip earnings for the current day $32.75
[payout_type] Name of the payout type Tips
[employee_balance] Employee's current account balance $128.25

Steps

Configure a notification template

  1. Navigate to Configuration > Notifications.
  2. Select Tips Payout from the module list.
  3. Choose the notification type you want to configure.
  4. In the message template field, enter your content using the available macros.
  5. Select Save.

Worked example: A center wants to remind employees of their earnings each morning. The administrator sets the message body to: Your tips payout is ready! Yesterday's earnings: [yesterday_tips]. Current balance: [employee_balance]. Payout type: [payout_type]. When the notification fires, an employee who earned $45.50 yesterday and holds a $128.25 balance sees those values substituted in the delivered message.

Internal alerts

The system generates internal alerts for tips payout events that require administrative attention. These alerts are delivered automatically via email to the configured internal alerting recipient.

Internal alerts are generated for events such as:

  • No linked transfers during consolidation — The consolidation process found a consolidated record with no individual transfers linked to it.
  • Scheduled job update failure — The system could not update the next scheduled run time for a background process.
  • Account lookup failure — A required account could not be found during transfer processing.
  • Recovery processing failure — A recovery or dispute recovery operation did not complete as expected.

Note: Internal alert recipients and delivery settings are configured at the organization level. Contact your Zenoti administrator to update the alert email address.

Note: Employee-facing tips earned notifications and payout coordination notifications are documented in the Payments category. For Zenoti Payments platform details, see Payments. For viewing tips earnings on the MyZen app, see MyZen.

Tips

  • Use [employee_balance] in payout confirmation templates so employees can verify their wallet balance immediately after a payout cycle completes.
  • Use [yesterday_tips] in daily morning notifications so employees see a clear summary of the previous day's earnings without needing to open the MyZen app.
  • Keep message templates concise. Templates that include all four macros in a single message give employees all the context they need in one notification — earnings, balance, and payout type — without additional follow-up questions to the front desk.

Troubleshooting

  • Macros display as literal text instead of resolved values — Confirm the macro is entered exactly as shown in the table above, including the square brackets and underscores (for example, [yesterday_tips]). A typo such as [yesterday tips] or [YesterdayTips] will not resolve.
  • Employees are not receiving notifications — Confirm the notification template is enabled in Configuration > Notifications and that the employee's contact details (email or mobile number) are current in their profile. Also verify that your organization's transactional messaging settings are active.
  • The [payout_type] macro shows an unexpected value — The macro resolves to the payout type name associated with the payout run. For standard employee tips payouts this will be Tips; for prefunding runs it will be Tips Prefunding. If the value appears incorrect, confirm the center's tips payout configuration with your Zenoti administrator.
Was this article helpful?
Your feedback helps us improve our documentation.