Welcome to StaffPay AI

Your account is live. This guide will walk you through everything — from linking your first device to running your first payroll. Simple, modular, and built for the way you work.

Let's get you set up →

2

How It All Fits Together Two building blocks: Pay Groups + Zones

StaffPay is built around two simple concepts. Once you understand these, everything else falls into place.

💰

Pay Groups

Determine how much someone earns. Hourly rate, overtime rate, Sunday rate, public holiday rate — all in one place. Any number of staff can belong to the same pay group.

📍

Zones

Determine where someone works. A zone is a team, department, or location. Think of it as a work group. Rosters are created per zone.

Why separate them?

Because not everyone in the same zone earns the same wage. A restaurant might have:

ZoneStaffPay Group
KitchenHead ChefSenior Rate — R65/hr
KitchenLine CookStandard Rate — R45/hr
FloorWaiterService Rate — R35/hr
FloorManagerSenior Rate — R65/hr
BarBartenderStandard Rate — R45/hr

The Head Chef and the Floor Manager both use the Senior Rate pay group — but they're in completely different zones. This is what makes StaffPay simple and modular.

🛠
Zones work everywhere. A farm might have "Packing House", "Orchards", and "Admin Office". A construction firm might have "Site A", "Site B", and "Workshop". The names are up to you.

3

Set Up Pay Groups Do this first — before zones, before staff

A pay group defines a wage structure. You might only need one (if everyone earns the same) or you might need five. There's no limit.

Creating a Pay Group

1

Navigate to Pay Groups

Settings Pay Groups on mobile, or Pay Groups in the web dashboard sidebar.

2

Tap "Create Pay Group"

Give it a clear name (e.g. "Standard Rate", "Senior Rate", "Weekend Staff").

3

Set the Rates

Configure the following for this group:

RateWhat It MeansExample
Hourly RateNormal weekday pay per hourR45.00
Overtime RateRate for hours beyond normal shiftR67.50 (1.5x)
Sunday RateRate for hours worked on SundaysR90.00 (2x)
Public Holiday RateRate for SA public holidaysR90.00 (2x)
💡
Total flexibility. You can set any rate to any value. Want Sundays at a flat R100 regardless of hourly rate? Just set it. Want overtime at 1.25x instead of 1.5x for a specific group? No problem. Each pay group is independent.

4

Set Up Zones Group your staff by where they work

Once your pay groups are ready, create your zones. Every staff member belongs to exactly one zone.

Creating a Zone

1

Navigate to Zones

Settings Zones on mobile, or Zones in the web dashboard sidebar.

2

Tap "Create Zone"

Name it after the work area — "Kitchen", "Warehouse", "Site B", "Orchards" — whatever makes sense for your business.

3

Optional: Set a Colour & GPS

Assign a colour so the zone is easy to spot on dashboards and rosters. You can also set GPS coordinates if the zone has a fixed physical location.

📋
Zones drive rosters and payroll. You'll create rosters per zone, and you can run payroll per zone or per pay group. This keeps everything organised — even when you have different staff on different pay cycles.

5

Enrol Your Staff Add people, assign them a zone and pay group

Now that you have pay groups and zones, you can start adding staff. Each person gets linked to one zone and one pay group.

Adding a Staff Member

1

Go to Staff Management

Management Staff List on mobile, or Staff in the web sidebar. Tap "Add Staff".

2

Enter Their Details

Name, phone number, employee code. You can add email, bank details, and tax info now or later.

3

Assign a Zone

Choose which zone this person works in. They'll appear in that zone's roster and dashboard stats.

4

Assign a Pay Group

Choose the pay group that matches their wage structure. This determines their hourly, overtime, Sunday, and holiday rates.

5

Enrol Their Face (for Sign-In)

Take a photo of their face. The system uses this for face-scan sign-in at the registry. You can also set up QR code sign-in as a fallback.

6

Set Deductions (Optional)

Configure tax, UIF, union fees, pension, or any recurring deductions. These are automatically applied every payroll run.

💡
Quick enrol from Registry. You can also create staff directly from the Registry App — it uses a simplified form for fast on-site enrolment. The admin can then fill in the remaining details later.

6

Staff Sign In & Sign Out Face scan, QR code — tracked to the second

Once staff are enrolled, they sign in and out at the registry device. This is how their hours are recorded.

Staff arrives
Face scan
Matched & signed in
Timelock activates

How It Works

  • Face Scan is the primary method. The registry camera matches the live face against the enrolled photo using on-device AI.
  • QR Code is available as a fallback. Each staff member has a unique QR code they can present to the camera.
  • Timelock prevents double-scans. After a successful scan, the device locks for a set period (30 min, 1 hour, etc.) before the next scan is allowed.
  • Sign Out works the same way — toggle the mode on the registry from "Sign In" to "Sign Out".
📷
Choose a zone on the registry. You can select which zone the registry is operating for. This is useful if multiple zones share one kiosk — switch the zone before staff from that area start scanning.

7

Rosters Schedule your staff — manually or with templates

Rosters determine who works when. They're created per zone and cover a week at a time.

Creating a Roster

1

Go to Rosters

Tap the Rosters tab on mobile, or navigate to Rosters on the web dashboard.

2

Select a Zone

Choose which zone you're rostering for. Each zone has its own independent roster.

3

Pick a Method

You have two options:

  • From Template — Load a saved roster layout (best for recurring schedules)
  • Manual — Assign staff to days and shifts one by one
4

Mark Any Leave

The built-in Leave Manager appears during roster creation. Mark staff who are on leave for that week so they're excluded from shifts.

5

Publish

Once you're happy, publish the roster. It's now live — the dashboard and registry will use it to track who's expected on shift.

Templates — Save Time Every Week

If your roster is the same every week (or rotates between 2–3 patterns), save it as a template.

📄

Zone Template

A saved roster for one specific zone. "Kitchen — Weekday Standard" or "Floor — Weekend Rush". Load it next week with one tap.

🌐

Global Template

A saved roster for all zones combined. One template that contains each zone's layout. Perfect for applying your entire week's schedule in one action.

🔄
Rotating schedules. If your rosters rotate (e.g. 3 shifts that cycle week by week), save each rotation as a separate template. When it's time to roster, just pick the right rotation. No re-building from scratch.
🤖
Let the AI do it. You can ask your AI Assistant to generate a roster for you. Just tell it what you need — "Create next week's roster for Kitchen with the usual crew" — and it will build it.

8

Running Payroll Hours in, money out — fully automated

This is where everything comes together. StaffPay takes the sign-in data, applies the pay group rates, factors in overtime, Sundays, public holidays, deductions — and gives you a complete payroll.

How to Run a Payroll

1

Go to Payroll

Tap the Payroll tab on mobile, or navigate to Payroll on the web dashboard.

2

Create a New Run

Select the period — by month, or a custom date range.

3

Choose Scope

Run payroll for a specific zone, a specific pay group, or the entire organisation. This is what makes StaffPay modular — different staff can be on different pay cycles.

4

Preview

StaffPay generates a full preview showing each staff member's breakdown: regular hours, overtime hours, Sunday hours, public holiday hours, gross pay, deductions, and net pay.

5

Make Adjustments (if needed)

Use Manual Allocate to override specific hours or Overrides & Edits to adjust calculations before finalising.

6

Finalise & Mark as Paid

Lock in the payroll. Individual payslips are generated for each staff member. Once you've transferred the money, mark the run as paid.

⚠️
Review before finalising. Once a payroll run is finalised, it's locked. Always check the preview carefully. If something looks off, use Overrides to fix it before you hit finalise.

9

Leave Management Track, allocate, and approve leave

StaffPay tracks leave balances for every staff member. You can allocate leave, and staff can also request it themselves.

Leave Types

TypeDescription
Paid LeaveAnnual leave — deducted from balance, paid at normal rate
Unpaid LeaveTime off without pay
Sick LeaveIllness — separate balance per BCEA regulations
CompassionateFamily/personal circumstances
CustomAnything else your business needs

How It Works

  • Admin allocates: Go to Settings Leave Management. Select staff by zone, choose the type and dates, and apply. Balances update automatically.
  • Staff requests: Staff can submit leave requests through the Staff Portal app. You'll see them under Leave Requests — approve or deny with one tap.
  • Payroll integration: Leave days are automatically reflected in payroll calculations. Paid leave pays at the normal rate; unpaid leave deducts those days.

10

Your AI Assistant Need help? Just ask.

StaffPay has a built-in AI assistant that understands your business. You can access it from the floating chat button on mobile, or from the AI section on the web dashboard.

What can it do?

  • Generate rosters — "Create next week's roster for Kitchen"
  • Answer pay questions — "How much overtime did John work this month?"
  • Help with tax & compliance — "What are the BCEA rules for sick leave?"
  • Run tasks — "Show me who was absent yesterday"
  • Voice input — Tap the microphone and speak your question
🤖
Stuck? Ask the AI. Whenever you're unsure how to do something in StaffPay, your AI assistant is the fastest way to get help. It knows your data and can walk you through any task.

11

Reports The right data, to the right people, automatically

Reports is a scheduled email subscription service. Add any email address, choose what data they receive, and set how often it gets sent. Each recipient can have a completely different report on a completely different schedule.

1

Add a Recipient

Go to Reports on the web dashboard. Click Add Email and enter any email address.

2

Choose a Frequency

Daily (every day), Weekly (every Sunday), or Monthly (1st of each month). All reports send at 1:30 AM.

3

Pick What Data to Include

Toggle on the sections you want. Mix and match per recipient — one person can get attendance only, another can get the full breakdown.

Available Report Data

📋

Attendance

Absentees, late arrivals, early departures. Compares roster vs actual sign-ins with a 5-minute grace period.

🕑

Sign In / Out Activity

Full daily activity log. Optionally grouped by zone.

Hours

Regular and overtime hours with daily breakdowns. Lists individual overtime staff with zone info.

💰

Staff Cost

Total wage cost for the period. Split regular vs overtime. Daily breakdowns and individual staff figures.

⚠️

Stale Shifts

Staff who clocked in but never clocked out (shifts older than 12 hours with no sign-out).

💡
Test before you go live. Use the Send Test button on any subscription to preview exactly what the recipient will receive — no need to wait for the scheduled send.

12

Get Support We're here to help

If you need human help beyond what the AI assistant can provide, you can submit a support ticket directly from the app.

1

Go to Support

Management Support Tickets on mobile.

2

Create a Ticket

Choose a type (billing, technical, upgrade, etc.), set priority, and describe your issue.

3

Track & Message

Track your ticket status (open, in progress, resolved) and exchange messages with the support team directly in the app.


13

Your Apps Which app does what

AppPurposeWho Uses It
StaffPay AI Admin Full management: staff, rosters, payroll, settings, AI chat. Also includes a built-in registry. Business owner / manager
StaffPay AI Registry Standalone sign-in kiosk. Face scan + QR. Runs on a dedicated device at the workplace. Placed at entrance (staff scan in/out)
StaffPay AI Staff Staff portal. View shifts, request leave, check payslips, personal QR code for sign-in. Individual employees
Web Dashboard Full management from any browser. Same features as the Admin app, plus Reports. Business owner / manager

Quick Reference The complete setup flow at a glance

Link Registry
Create Pay Groups
Create Zones
Enrol Staff
Build Roster
Staff Sign In
Run Payroll

Key Locations

  • Registry Link Code: Settings › Security
  • Pay Groups: Settings › Pay Groups
  • Zones: Settings › Zones
  • Staff: Management › Staff List
  • Rosters: Rosters tab
  • Payroll: Payroll tab
  • Leave: Settings › Leave Management
  • AI Assistant: Floating chat button (mobile) or AI section (web)
  • Reports: Reports section (web dashboard)
  • Support: Management › Support Tickets
🎉
You're all set! You now know everything you need to get started with StaffPay. Set up your pay groups, create your zones, enrol your staff, and start running payroll — it's that simple.

Remember: your AI assistant is always there to help. Just ask!
← Back to Home