Region-Scoped Background Job Configuration
Zenoti supports per-region configuration of background jobs that process tips payout data, allowing you to enable or disable individual jobs and adjust their run intervals without requiring a code deployment.
Note: For conceptual background on how tips payout processing works, see How tip payouts are processed.
Audience: Zenoti administrators responsible for tips payout platform configuration.
On this page
- Before you begin
- How region-scoped job configuration works
- Configurable background jobs
- Configure a background job for a region
- Tips
- Troubleshooting
- Related articles
Before you begin
- Your organization must have tips payout enabled. See Get started with Same-Day Tip Payouts.
- Region-scoped background job configuration is managed by Zenoti. Contact your Zenoti representative to request changes to job settings for your region.
Permission: You need the Configure Payment Settings permission to view and manage tips payout configuration. Admin path: Configuration > Security > Security roles — then open the relevant role and enable Configure Payment Settings under the Payments permission group.
How region-scoped job configuration works
Background jobs in the tips payout platform run on a schedule to process region-specific data. Each job has two independently configurable properties:
- Enabled — Whether the job runs for the region. When set to enabled (the default), the job runs at the configured interval. When disabled, the job is paused for that region without affecting other regions.
- Interval — How frequently the job runs, expressed in minutes or seconds depending on the job type.
Because these properties are configured per region, Zenoti can adjust the schedule for one region — for example, Canada tips payout processing — without affecting jobs running for other regions. Changes take effect without a code deployment.
Important: Region-scoped job configuration is a platform-level setting managed by Zenoti. Businesses cannot modify job intervals or enable/disable jobs directly from the Zenoti interface. Contact your Zenoti representative to request a change.
Configurable background jobs
The following background jobs support per-region configuration.
| Job | Region applicability | What it does | Default state |
|---|---|---|---|
| Canada tips payout processing | Canada organizations | Identifies and processes tips payout batches for centers in Canada | Enabled |
| Inactivity-based account freeze candidate identification | All regions | Identifies employee accounts that meet the criteria for automated freeze based on inactivity | Enabled |
Each job's interval determines how often it checks for new work. A shorter interval means faster processing; a longer interval reduces processing load during off-peak periods.
Note: Disabling a job for a region pauses processing for that job only. Tips that accumulate while a job is disabled are not lost — they are processed when the job is re-enabled and runs again.
Configure a background job for a region
Because region-scoped job configuration is managed by Zenoti, the process for requesting a change is as follows.
Request a configuration change
- Identify the job you want to change and the region it applies to.
- Determine the change you need:
- To pause processing, request that the job be disabled for your region.
- To resume processing, request that the job be enabled for your region.
- To change how frequently the job runs, specify the new interval in minutes or seconds (your Zenoti representative will confirm the unit for the specific job).
- Contact your Zenoti representative with the following details:
- Organization name and region
- Job name
- Requested change (enabled/disabled, or new interval value)
- Zenoti applies the change to the region-scoped configuration. No code deployment is required, and the change takes effect at the next scheduled job execution.
Worked example: A Canada-based organization notices that tips payout processing is running more frequently than needed during overnight hours, causing unnecessary load. The administrator contacts their Zenoti representative and requests that the Canada tips payout processing job interval be increased from 5 minutes to 15 minutes between 11 PM and 6 AM local time. Zenoti updates the interval for the Canada region. The change takes effect without any downtime.
Verify the change
After Zenoti applies the change, confirm the expected behavior by reviewing payout processing outcomes in your tips payout reports.
- If you disabled a job, verify that no new payout batches are created during the disabled period.
- If you changed the interval, verify that payout batches appear at the new frequency.
For reporting guidance, see View Same-Day Tip Payouts reports.
Tips
- Coordinate timing with your payout schedule. If you request a job to be disabled, ensure the period of inactivity does not overlap with your center's configured payout time. Tips that are not processed before the payout window may be deferred to the next cycle.
- Disable jobs during planned maintenance windows only. Disabling a background job for an extended period causes tips to accumulate without being processed. Re-enable the job before your next scheduled payout run to avoid delays.
- Inactivity-based freeze runs independently of payout processing. Disabling the inactivity-based account freeze candidate job does not affect tips payout processing, and vice versa. Each job can be configured independently.
Troubleshooting
Tips payout batches are not being created on schedule.
Check whether the Canada tips payout processing job is enabled for your region. If it was recently disabled for maintenance and not re-enabled, batches will not be created until the job is active again. Contact your Zenoti representative to confirm the current job state and re-enable it if needed.
Employee accounts are not being automatically frozen after the employee's last date.
The inactivity-based account freeze candidate job may be disabled for your region, or its interval may be set too long to catch the freeze window promptly. Contact your Zenoti representative to verify the job is enabled and running at an appropriate interval. Note that automated freeze occurs when an employee's last date plus two days has passed relative to center local time.
A job change was applied but payout behavior has not changed.
Job configuration changes take effect at the next scheduled execution of the job. If the interval is long (for example, 60 minutes), you may need to wait up to one full interval before observing the change. If behavior has not changed after one full interval, contact your Zenoti representative to confirm the change was applied correctly.