Managing Fieldworker Commission, Pay Rates & Payroll Payment

Configure Fieldworker Commission, Pay Rates & Payouts

Overview of Fieldworker Compensation in OctopusPro

OctopusPro is built to handle every mainstream fieldworker payment and compensation model used in field-service operations—hourly wages, percentage-based commissions, flat fees, product-upsell bonuses, or any hybrid mix. This guide shows administrators how to:

  • establish company-wide default pay rates
  • apply service-level rules (e.g., higher commission on premium jobs)
  • create worker-specific agreements for senior or subcontracted technicians
  • make one-off overrides at the booking level for bonuses or custom splits

You’ll also learn how to automate disbursements with Stripe Connect, allocate revenue on multi-technician jobs, and generate audit-ready payroll reports—guaranteeing that every contractor or employee is paid accurately and on schedule.


What you’ll master

Capability Why it matters
Fieldworker share Define the exact portion of each booking that flows to the technician.
Multi-tier pay structures Configure rates globally, per service, per product, or per individual worker.
Hourly vs. commission logic Combine standard time, overtime premiums, flat payouts, or percentage splits.
Multi-crew payouts Split a single job’s revenue across multiple fieldworkers in seconds.
Automated payouts Route each worker’s share directly to their bank via Stripe Connect.
Payroll analytics Filter paid / unpaid jobs, export to CSV, ABA, NACHA, SEPA XML, or sync to your accounting stack.

Use this guide to turn OctopusPro into your end-to-end payroll engine—from rate setup to automated settlement and reporting.

Fieldworker Share & Payment Structures

What is a Fieldworker Share?

In OctopusPro, a Fieldworker Share is the exact slice of every booking that goes to the technician or contractor who completes the job. You decide whether that slice is:

  • a percentage of the job subtotal, or
  • a flat payout in your account currency.

Because different jobs—and different workers—often require different pay plans, OctopusPro lets you apply unique rates per service, per worker, or per booking. A one-time override on an individual booking always wins, making bonuses or special splits effortless.

Pay Structures

OctopusPro supports two primary pay structures for fieldworkers:

Compensation Model How OctopusPro Calculates It Best-Fit Use Cases
Commission (Flat or %) Base Commission on the core service price.
Upsell Commission on add-ons or product markup.

Only one commission applies to each revenue stream.

Piece-rate contractors, mobile beauty, auto detailing, pest control.
Hourly Wage Standard Hourly Rate
Overtime Rate (optional)
First-Hour Premium (optional)
In-house staff, trades, maintenance work, long on-site jobs.

Hybrid friendly: Run certain services on hourly pay and others on commission—or combine hourly labour with product commissions in the same booking.

Key Rules To Remember

  1. Tax smart: Shares calculate on pre-tax amounts, keeping GST / VAT correct.
  2. Set commission rates or hourly wages for every service you sell.
  3. Prevent over-allocation: Combined shares for all workers on a service should never exceed 100 % of the revenue.
  4. Adjust Fieldworker Share on individual bookings for bonuses or refunds without changing your global pay rules.
  5. Track unpaid vs. paid jobs in real-time payroll reports.

With these flexible, industry-standard pay structures—commission, hourly, or a hybrid—OctopusPro delivers precise, transparent fieldworker compensation for every service business.

Configuring Pay Rates: Global, Service, Product, Hierarchy, and Overrides

OctopusPro uses a four-tier pay-rate hierarchy so you can mirror any compensation policy, from simple hourly wages to complex commission splits:

Priority Layer Typical Use
1 (highest) Booking-level override One-off bonus, special discount, or custom split on a single job
2 Worker-specific » Service rate Pay a senior tech 60 % on HVAC installs but 50 % on general repairs
3 Worker Payment Agreement (global) Set a contractor’s default 40 % commission or $30/hr for all work
4 (fallback) Service default rate Company-wide baseline: e.g. 50 % commission on “Standard Cleaning”

OctopusPro checks each level in order and stops at the first match, guaranteeing the right rate every time.


Worker Payment Agreement (Global Defaults)

Only Admin users can edit a fieldworker’s Payment Agreement.


Open a worker’s profile and expand Payment Agreement (an in-page drawer, not a pop-up). This panel sets two things:

  1. Default Pay Structure & Rates

    • Hourly Rate – standard labour rate

    • Overtime Rate – applied to OT hours

    • First-Hour Premium – optional call-out fee

    • Base Commission – % or flat cut of the service subtotal

    • Upsell Commission – % or flat cut of add-ons / product markup

  2. Payout Details
    Bank or wallet credentials (BSB/Account, IBAN, etc.). OctopusPro—and Stripe Connect if enabled—use these details to send automated payouts.

Best practice: Review a worker’s Payment Agreement whenever their rates change or they update banking info. Keeping this current prevents failed Stripe transfers and ensures payroll accuracy.

Global & Service-Level Pay Structures – How They Work Together

OctopusPro gives you two permanent layers for defining pay rates plus a temporary booking-level override. Use these layers to mirror any real-world agreement, from straight hourly wages to complex commission splits.


1 · Worker-Wide “Payment Agreement” (Global Default)

A Payment Agreement is the contract stored on a fieldworker’s profile.
It sets that person’s baseline pay rules for every service—unless a more specific rule overrides it.

Where to edit Admin path
Global Payment Agreement Fieldworkers → [Name] → Profile → Payment Agreement (collapsible drawer)

What you enter

Field What it controls Example
Pay Structure Commission or Hourly Choose the model first.
Base Commission % or flat cut of the service subtotal 60 % or $40
Upsell Commission % or flat cut of add-ons / product markup 10 % of retail addons
Hourly Rate Standard labour rate $32 /hr
Overtime Rate Optional premium for OT hours $48 /hr
First-Hour Premium Optional call-out charge $50 first hour
Payout Details BSB/Account, IBAN, or Stripe-Connect ID Where automated payments land

Pro tip: Update this agreement whenever a worker’s rates or banking details change. Stripe Connect payouts will fail if deposit info is wrong.


2 · Service-Level Pay Rates

2A · Company Default for a Service

Use when every technician should earn the same baseline on a given service.

Admin path Steps
Settings → Services → Edit → Cost & Pay Rates 1. Pick Commission or Hourly.
2. Enter the default rates.
3. Save.

Example – “Standard Cleaning” pays 50 % commission company-wide.

2B · Worker-Specific Rate for a Single Service

Use when one worker needs a special rate on just one service (senior tech, subcontractor, incentive).

Admin path Steps
Fieldworkers → [Name] → Profile → Job Settings → Services Provided → Payrate & Commission 1. Click the service row.
2. Set unique commission or hourly rates.
3. Save.

Example – Jane gets 60 % on “Lawn Mowing” while everyone else stays at 50 %.

Why configure commission at the service level?
• Keeps your pay policy transparent and consistent – every worker sees the same baseline for that service.
• Lets you reward harder or more expensive jobs with higher percentages or hourly rates.
• Avoids manual edits on every booking; most jobs will “just work” with the default.
• Makes future changes simple: adjust the service once and every future booking follows suit.


3 · Product / Upsell Commission – How OctopusPro Splits Item Revenue

Selling parts, consumables, or retail add-ons can boost a booking’s value—and OctopusPro can credit the right share to your technicians automatically. Below is the complete logic, including edge-cases that aren’t obvious at first glance.


3.1 Commission Formula

Who supplied the item? Fieldworker receives Worked example Cost $20 → Sell $30 (markup $10, rate 50 %)
Fieldworker-supplied Cost + % of markup $20 (cost) + $5 (50 % × $10) = $25
Company-supplied % of markup only 50 % × $10 = $5

Markup = Selling price – Cost (pre-tax). Commission is always calculated on the net amount before GST/VAT.

Typical use-cases

Industry Common upsell items Why it matters
Mobile auto detailing Wax, ceramic coating Tech earns extra for selling premium finishes
HVAC repair Thermostats, filters Covers parts a tech carries on the truck
Mobile beauty Skincare, nail polish Rewards therapists for retail sales
Plumbing Replacement valves, hoses Encourages stocking van inventory
Pest control Rodent traps, bait stations Technician-supplied products get paid cost + markup share

3.2 Where to Set the Percentage / Flat Fee

Scope Path When to use
Service default Settings → Services → Edit → Cost & Pay Rates → Upsell Commission Every tech earns the same cut on upsells for this service.
Worker default Fieldworkers → Profile → Payment Agreement → Product Share One tech (e.g., subcontractor who buys their own stock) needs a different cut across all services.
Worker × Service override Fieldworkers → Profile → Services Provided → Payrate & Commission A single tech gets a special cut on one service only.
Booking override Booking → Fieldworker Earnings → Actions → Set Fieldworker Share One-off bonus or custom split on a specific job.

Priority ladder: Booking override → Worker × Service → Worker default → Service default.


3.3 Optional Flat-Rate Scenario

If a worker’s pay model is Flat-Rate (e.g., $50 per job), that flat amount is paid regardless of products.
However, if the flat-rate worker supplies a product, you can still let them recoup cost + markup share by adding a Worker-level Product Share percentage. Without that, they receive only the flat fee.


3.4 Enabling Product Entry

Admins can add products while creating or editing a booking.
Fieldworkers can add products in the mobile app at Check-in or Complete Job (enable in Settings → Permissions → Fieldworker can add products).

Once a product is added:

  1. The technician toggles Supplied by Fieldworker or leaves it as Company.
  2. OctopusPro instant-calculates the commission and appends it to the Fieldworker Earnings card.
  3. The extra revenue adjusts the invoice total; the commission adjusts the payroll total—no manual math.

3.5 Company-Share Transparency

OctopusPro also records the company’s cut on every product:

  • If company-supplied, company keeps (100 % – worker %) of markup.
  • If worker-supplied, company keeps nothing on that product (but still profits on the service fee).

These values appear in Booking → Cost Breakdown and in Fieldworker Payroll Reports.


3.6 Reporting & Export

  • Reports → Fieldworker Bookings Summary shows service vs. product earnings per job.
  • Reports → Payment to Fieldworkers groups unpaid product commissions for batch payout.
  • Exports (CSV / ABA / NACHA / SEPA XML) include separate columns for Service Share and Product Share so your accountant can reconcile inventory margins vs. labour margins.

3.7 Best-Practice Checklist

  • Create a product catalogue with accurate Cost & Sell prices first.
  • Choose one upsell policy (percent or flat) and apply it at Service level, then override only if necessary.
  • Educate fieldworkers to mark who supplied the item—this drives the correct split.
  • Audit monthly: run a Products-Sold report vs. inventory to catch mismatch between “Fieldworker supplied” and actual stock movement.
  • Use Stripe Connect: product commissions are released automatically alongside the service share, improving cash-flow for contractors.

With these settings in place, OctopusPro turns product sales into a seamless, commission-friendly revenue stream—no spreadsheets, no manual calculations, just automatic, transparent earnings for both your business and your field team.


4 · Pay-Rate Priority Ladder

  1. Booking-level override – one-off bonus / custom split
  2. Worker ↔ Service rate – special skill premium
  3. Worker Payment Agreement – global contract
  4. Service default – company baseline
  5. Manual entry – only if nothing else is defined

Multi-Service Bookings & Over-Allocation Warning

If a booking contains multiple service lines, open the drawer and set a share for each line.

Important: The combined shares per line must not exceed 100 % of that line’s value; over-allocating puts the job at a loss.


Why Use Both Layers?

Benefit Payment Agreement (worker-wide) Service Default (job-wide)
Company consistency
Individual contracts / seniority
Quick future rate changes ✓ (one profile) ✓ (one service)
Works with Stripe Connect payouts

Together, these layers let you replicate any pay scheme—40 % commission for new hires, 70 % for senior staff, or $30 /hr plus OT for employees—while keeping every payout precise, automated, and audit-ready.

Adjusting a Fieldworker’s Share on an Individual Booking

Sometimes you need a one-off pay change—bonus, correction, or a custom split when multiple technicians work the same job. The Fieldworker Earnings drawer inside each booking lets you make that adjustment in seconds.

Solo-operator note: If no human worker is assigned, the job sits with Unassigned Task Manager. Open the drawer and set the share to 100 % to pay yourself the full amount.


Step-by-step (Admin portal)

  1. Open the booking
    Bookings → All Bookings → select the job to reach the Booking Details page.
  2. Launch the drawer
    In Fieldworker Earnings, click Actions (⋮) → Set Fieldworker Share.
    A side drawer expands, showing every assigned worker, the current pay-rate type, and editable share fields.
  3. Enter new amounts
    Single tech: type the new figure.

    Multiple techs: edit each worker’s line—e.g., Lead 70 % / Assistant 30 %.

  4. Check the totals

    Warning: The shares for each service line must add up to ≤ 100 % of that line’s value. Over-allocating puts the job in the red.

  5. Save
    Click the Save button at the bottom. Collapsing the drawer without saving discards your edits.
  6. Verify & notify
    The Fieldworker Earnings panel refreshes; technicians immediately get notified and see the new amount in the OctopusPro Fieldworker App under My Earnings.

Good to know

  • Works after completion: You can adjust shares even when a job is marked Complete—ideal for post-job corrections.
  • Override hierarchy: Booking-level overrides trump worker-specific or service defaults for that job only.
  • Multi-service invoices: If the booking has several service lines, set a share for each line; any line left at 0 % keeps its prior value.
  • Use sparingly: Rely on default Service Pay Rates or Payment Agreements for routine jobs; reserve overrides for bonuses or exceptions.

Automating Fieldworker Payouts with Stripe Connect

Manually issuing checks or bank transfers is slow, error-prone, and hard to audit.
OctopusPro’s Stripe Connect integration turns every customer card payment into an automatic split-payment:

  1. Customer pays for the booking by card.
  2. Stripe routes the fieldworker’s share to their Stripe-linked bank account.
  3. Your company keeps its platform fee or profit margin—instantly, in the same transaction.

No spreadsheets, no second invoice, no end-of-month payout run.


Why Stripe Connect?

Why choose Stripe Connect for field-worker payouts?

Key advantage How it translates into business value
Real-time split settlement Each charge is split the instant the customer’s card is captured—no holding buckets, no second transfer. Workers see “Deposit pending” in Stripe within minutes.
Hands-free bookkeeping OctopusPro sends the share rule; Stripe executes it. No ABA/NACHA batch files, no double-entry in accounting software, no risk of fat-finger errors.
Stronger cash flow for contractors Standard payouts arrive in 2-3 days, or in minutes with Instant Payouts*. Fast cash keeps your best technicians loyal to the platform.
End-to-end audit trail Every split event is timestamped in both Stripe and OctopusPro. Finance teams can trace a dollar from customer card to technician bank in two clicks—drastically fewer payout disputes.
Global multi-currency rails Supports 40+ currencies across 30+ countries. Ideal for franchises or marketplaces that onboard providers in multiple regions without opening local bank accounts.
Built-in compliance & KYC Stripe handles identity checks, tax-form collection (e.g., W-9 / W-8BEN in the US), PSD2, and GDPR requirements—saving you from expensive legal overhead.
Chargeback & dispute routing If a customer disputes a payment, Stripe automatically assigns the contested amount to the platform, not your workers—protecting their cash flow and your brand.
Flexible payout scheduling Choose automatic daily/weekly payouts or hold funds until a job is marked complete—perfect for milestone or escrow-style workflows.

*Instant Payouts availability depends on country and risk tier. See Stripe’s documentation for eligibility.


How Stripe Connect Splits a Payment – Worked Example

Step Amount (USD) Explanation
1. Customer authorises card $100.00 Booking total for a “Deep-Clean” service.
2. Stripe processing fee ¹ – $3.20 2.9 % + 30¢ card fee (U.S. Visa/Mastercard example). Stripe deducts this first.
3. Net amount available for split $96.80 $100.00 – $3.20 processing fee.
4. OctopusPro sends split rule 70 % worker / 30 % platform Rule comes from the Fieldworker Share value you configured.
5. Funds routed automatically $67.76 → cleaner’s Stripe account
$29.04 → company Stripe account
Stripe Connect executes the split in real time. No separate transfer needed.

¹ Exact fee depends on card type, country, and your Stripe pricing plan. Instant-Payout surcharge not included.


What happens under the hood?

  1. Destination charge – OctopusPro creates a single payment intent for $100 with your platform listed as the “destination.”
  2. Application fee – Stripe deducts $29.04 (your 30 % platform fee) and routes the remainder—after card fees—to the cleaner.
  3. Ledger entries – Both amounts appear in Stripe’s dashboard and in the OctopusPro booking ledger, so Finance can trace each cent.

Tip: If you prefer to absorb the Stripe fee yourself, set the fee-payer flag to the platform. The worker then receives the full $70.00 (70 % of $100), and Stripe subtracts the $3.20 entirely from your $30.00 platform fee.

This end-to-end flow happens in seconds, giving workers near-instant visibility of upcoming funds while your business captures its margin automatically.


Quick-Start Checklist

  1. Connect your Stripe account
    Settings ▸ Financial Settings ▸ Payment Integration ▸ Stripe
    Paste your live API keys and tick Enable Stripe Connect.
  2. Invite fieldworkers
    OctopusPro emails each worker a secure onboarding link. They create (or connect) a Stripe Express account—5-minute KYC.
  3. Set or confirm pay rules
    Commission %, hourly rates, or manual overrides—Stripe just follows the “Fieldworker Share” value OctopusPro sends.
  4. Go live
    From the first paid booking onward, Stripe splits every charge automatically.
    Optional manual trigger: Release Payment to Fieldworker if you prefer holding funds until job completion.

Compliance handled: Stripe collects tax info and verifies IDs so you stay ahead of global KYC/KYB rules.


Popular Workflows Unlocked

  • Multi-vendor marketplace – Beauty-services platform routes 70 % to therapists, keeps 30 % platform fee.
  • Franchise network – National HVAC brand pushes each branch’s cut direct to their own Stripe account.
  • On-demand trades – “Uber-for-plumbers” pays the technician automatically when the job is marked complete.
  • Tutoring platform – Tutors receive their lesson fee minus your margin without waiting for a monthly cycle.

Need step-by-step screenshots or troubleshooting? See the OctopusPro × Stripe Integration Guide.

Fieldworker Payroll Management & Reporting

Automating pay rules is only half the job— you still need audit-grade reports to confirm what every technician earned, was paid, and is still owed. OctopusPro ships with two purpose-built payroll reports plus multi-format export tools so Finance can reconcile in minutes, not hours.


1 · Fieldworker Bookings Summary

Menu: Reports ▸ Fieldworker Reports ▸ Bookings Summary

A live ledger of each booking and its payable status.

What you can do Why it matters
Filter by worker, fieldworker label, fieldworker invoice status (Paid / Unpaid), date range, booking status, client invoice status (Draft, Void, Open, Closed, Overdue), trading name or invoice # Isolate “All completed jobs last fortnight still unpaid” in one click.
See Earnings Details such as Booking ID, service, customer charge, worker share, paid/unpaid to fieldworker flag One screen shows the money trail for every job.
Batch tools: • Save as Paid (group jobs into one payout number) • Assign Invoice (upload contractor invoice if required) • Calculate Selected (sum selected invoices before you pay) Process dozens of jobs, then lock them as paid—no double-paying.
Custom invoice ref Add your internal payroll or remittance number if required.

Typical workflow

  1. Filter by Last week + Unpaid.
  2. Tick all results → Calculate Selected → view total.
  3. Pay via Stripe Connect or bank batch.
  4. Click Save as Paid so the report closes out those lines.

2 · Payment to Fieldworkers Report

Menu: Reports ▸ Payment Reports ▸ Payment to Fieldworkers

Think of this as your payout ledger—each row is a payment record (single job, batch, or Stripe transfer).

Column What it tells you
INV# Payout reference (auto or manual).
Bookings Count How many jobs were rolled into that payout.
Worker Who got paid.
Payment date When the money left your account.
Invoice Total Total amount invoiced by fieldworker (could be sum of multiple jobs).
Method / Ref Bank batch ID, Stripe payout ID, Cheque #, etc.
Amount Paid / Due Track partial payments to fieldworker; ideal for large/staged projects. If everything is paid, Amount Due will be $0.
Notes “August Freelance Cycle”, “Invoice #1234”, etc.

You can filter this report by fieldworker, date range, and status (just like others). For instance, to see all payments made this year to a particular electrician, filter by their name and “This Year”. Click any INV# to drill into the exact bookings behind that payment—perfect for dispute resolution.


3 · Export & Bulk-Pay Options

Both reports can be exported for further analysis or payroll processing. OctopusPro supports exporting to Excel/CSV for simple reporting needs, but also to specialized bank formats for bulk payments:

Format Region / Use case Button
CSV / Excel Universal import to Xero, QuickBooks, or Google Sheets Export → CSV
ABA Australia (BECS batch payments) Export → ABA
NACHA USA (ACH file for banks) Export → NACHA
BACS United Kingdom (Direct Credit) Export → BACS
SEPA XML Eurozone (SEPA Credit Transfer) Export → SEPA
CPA 005 Canada Export → CPA 005

After exporting, upload the file to your bank portal, process the EFT, then return to OctopusPro and mark those payouts Paid if Stripe hasn’t already.


4 · Other Actions

  • Edit / Delete a payout record (admin-only) to correct data entry.
  • Email Report to send a PDF or CSV remittance advice to fieldworkers or finance managers in one click. For instance, emailing a fieldworker a remittance advice of what jobs were paid in a cycle and their payment breakdown.
  • Attach receipts (e.g., bank confirmation PDF) to a payout for audit completeness.

5 · Best-Practice Playbook

Habit Why it helps
Reconcile on a schedule (weekly or bi-weekly) Fresh data = fewer “Where’s my money?” emails.
Use the “Unpaid” filter first Cuts noise—see what actually needs paying.
Group micro-jobs with Assign Invoice One payout ID, one bank fee, simpler books.
Keep an off-system backup Export CSV each cycle as a backup or to import in Xero or QuickBooks for accounting reconciliation.
Transparency with Fieldworkers
Show them My Earnings in the Fieldworker App—self-service reduces support tickets. They can view weekly/monthly earnings charts and see upcoming vs. paid amounts right from the app.

6 · Putting It All Together

  1. Rates & rules drive automatic splits (Service defaults, Payment Agreements, booking overrides).
  2. Stripe Connect (or bank exports) pushes money out with zero admin math.
  3. Bookings Summary and Payment to Fieldworkers give you a tamper-proof audit trail.

The result: payroll you can run on a Friday afternoon in minutes—with fieldworkers, finance, and compliance teams all seeing the same numbers.


Real-World Example Set-ups – Industry Playbooks

The tables below show how different sectors combine OctopusPro’s Service Pay Rates, Payment Agreements, Product Commissions, and Stripe Connect to match their market norms.


1. Mobile Beauty & Wellness

Topic Typical configuration Where to set it
Core services 70 % commission to each therapist; 30 % platform fee Settings ▸ Services → each treatment → Commission 70 %
Senior-level uplift Senior therapists earn 75 % Fieldworker ProfilePayment Agreement 75 %
Retail products 10 % Upsell Commission on company-stock skincare Service Upsell Commission = 10 %
Self-supplied oils Therapist keeps cost + 80 % markup Worker Payment Agreement → Product Share 80 %
Cash flow Stripe Connect – Destination Charges Client card ➜ 70/30 split in real time

Why it works: High commission attracts freelancers; same-day payouts reduce churn.


2. Property Maintenance & Trades (HVAC, Electrical, Plumbing)

Employee electricians Hourly structure – $40/hr, OT $60/hr, First-hour call-out $120.
Contractor HVAC techs Same service, but worker profile overrides to 100 % commission (contractors bill through the platform).
Parts & materials Thermostats, filters pre-loaded as Products (Cost + Mark-up). • Company-stock → tech earns % of markup only. • Tech-stock → tech earns cost + % markup.
Two-person crew Assign both techs, then Set Fieldworker Share to 70/30 or 50/50.
Payroll batch End of month → filter Bookings Summary by “Unpaid” → export ABA (AU) or NACHA (US) → pay employees.

3. Tutoring & Home Education

Per-session rate “Math Tutoring 1 hr” set to 60 % commission (student pays $50 → tutor $30).
Premium subjects Senior tutor gets 70 % on “Advanced Calculus” via worker-service override.
Hourly classes Group class service switched to Hourly $25/hr.
Multi-student webinar One tutor assigned; higher flat session fee covers workload.
Instant payout Parents pay at booking; Stripe Connect releases tutor share next day.

4. Pet Care & Mobile Grooming

Grooming services 50 % commission + optional tip line (tips routed 100 % to groomer).
Dog-walking Hourly $20/hr (no commission).
Retail upsells Pet shampoo, leashes: company stock → groomer earns 10 % markup. Self-supplied accessories → 80 % markup share.
Weekly batch payroll Export CPA 005 (Canada) or BACS (UK) file from Payment-to-Fieldworkers report.

5. Logistics / Same-Day Delivery (bonus example)

Per-parcel drivers 75 % commission on each “Delivery Stop”.
Fuel surcharge Added as a Product; driver recovers cost + 100 % markup (they supplied the fuel).
Multi-driver route Lead driver 60 %, rider helper 40 % via booking override.
Instant payouts Stripe Instant Payouts—funds land in driver debit card within minutes.

Key Take-aways

  1. Start with Service defaults to keep pricing transparent.
  2. Layer Payment Agreements for individual contracts or senior tiers.
  3. Use Product Share to reward on-site sales or parts usage.
  4. Booking overrides are for one-offs—bonuses or custom splits.
  5. Stripe Connect gives every example rapid, automated settlement.

Mix and match these elements to copy industry best practice—or invent your own blend to motivate workers and maximise platform margin.

Troubleshooting & Pro-Tips for Fieldworker Compensation

Even with automated rules, the occasional “Why didn’t this pay out?” moment will pop up. Start with the checklist below—95 % of pay issues trace back to one of these points.

Symptom Most common cause Quick fix
Share shows $0.00 Service has no default rate and worker has no Payment Agreement. Edit the service (Cost & Pay Rates) or add a Payment Agreement on the worker profile, then re-open the booking.
Wrong % applied Hidden override on worker profile. In the booking’s Fieldworker Earnings drawer look at the “Rate origin” text (e.g., “Profile override: 70 %”). Remove or edit the override if incorrect.
Base vs Upsell mix-up Both percentages filled but no product lines on invoice. Set whichever rate isn’t used to 0 % to avoid confusion; base applies to labour, upsell to products.
GST / VAT mismatch Worker flagged “Not tax-registered” but booking created with tax. Update worker tax status or adjust share to pay net-of-tax as required by your jurisdiction.
“Release Payment” does nothing Worker hasn’t finished Stripe onboarding or customer card still “Pending”. Check Settings ▸ Stripe Connect for “Connected” status; confirm the booking invoice is paid.
Worker can’t see earnings Booking still unassigned or app not refreshed. Assign booking correctly, then ask worker to pull-to-refresh My Earnings.
Second tech added, but still 100 % on first tech No split defined yet. Use Set Fieldworker Share to allocate percentages, then Save.
Payment report shows “Amount Due” after payout One or more completed bookings were left Unpaid. Run Bookings Summary filtered by worker + “Unpaid”; mark missing jobs “Save as Paid”.
Need to correct an over/under-payment Amount already marked Paid. Edit the payout invoice (add adjustment line) or revert booking to Unpaid and re-process next cycle.

Tip: Any time you tweak pay rules, create a test booking with a sandbox card to validate the new calculation before launch.


Deep-Dive Scenarios

Multi-currency or overseas workers
Stripe Connect handles FX automatically, but remember: the share is calculated in the booking currency before conversion. Check the FX rate on the payout if the numbers look off.

Over-allocation warning
If your combined shares exceed 100 % for a service line, OctopusPro will flag the error in red and refuse to save. Reduce one share or increase the service price to proceed.

Batch exports not matching bank total
Ensure you exported the same filter set you just marked Paid. Common slip-up: paying Friday’s jobs, then exporting “This Week” on Monday which now includes weekend work.


Best-Practice Safety Nets

  1. Weekly mini-reconcile
    Filter Bookings Summary by Unpaid ▸ This Week, review, and clear.

  2. Lock your master data
    Once pay rules are stable, restrict “Edit Pay Rates” permission to Finance admins only.

  3. Use internal notes
    Add a comment on overrides (“Holiday bonus”) so future auditors know why it exists.

  4. Shadow export
    Even with Stripe Connect, dump a monthly CSV to Google Drive; it’s cheap redundancy.

  5. Educate your crew
    Point workers to My Earnings ➜ Charts so they self-serve before emailing payroll.

Follow this checklist and your field-service payroll should run like clockwork—accurate, transparent, and nearly hands-free.


Conclusion

OctopusPro turns what is traditionally a payroll headache into a click-once workflow: clear rate hierarchies calculate the right share, Stripe Connect settles the money in real time, and finance-grade reports verify every cent. By pairing automated split-payments with audit-ready exports your business keeps cash-flow strong, reduces admin hours, and boosts worker trust—three factors research links to higher retention and productivity.

Why these tools matter

Paying contractors quickly is now an industry expectation; studies show that fast, transparent payouts rank just behind job availability when freelancers choose a platform. Manual EFT files and cheque runs not only slow cash-flow but also introduce reconciliation errors that good field-service software is designed to eliminate.

Real-time splits with Stripe Connect

Stripe Connect’s “destination-charge” flow lets OctopusPro take one card transaction and distribute funds instantly—worker share, platform fee, and Stripe processing cost—without secondary transfers or batch jobs.
Example: A $100 deep-clean triggers a $3.20 card fee (2.9 % + 30¢). Stripe then sends $67.76 (70 %) to the cleaner’s bank and $29.04 (30 %) to the business—fully logged in both systems for audit.

Lower admin overhead

Automated payouts eliminate the need for NACHA/ABA file prep, freeing finance teams to focus on analysis rather than data entry. OctopusPro still exports in ABA, NACHA, BACS, SEPA XML or CSV when you must use your own banking rails.

Cash-flow & retention

Workers who receive same-day or next-day funds via Stripe’s standard or Instant Payouts report higher platform loyalty and lower churn. Quick, predictable pay is especially valued in gig-style sectors like mobile beauty or urgent trades.

Transparency & compliance

Every split shows in OctopusPro’s Fieldworker Earnings drawer and in Stripe’s payout log, creating dual-ledger transparency that reduces disputes. Pay-equity research shows visible, rules-based compensation also improves worker trust and engagement.

Industry snapshots

Sector Typical model Why it works
Mobile Beauty 70 % commission + 10 % upsell on retail High split attracts freelancers; Stripe pays therapists in 2 days.
HVAC / Electrical Hourly for employees, 100 % commission for subcontractors; parts share via Product logic Mirrors union OT rules and wholesale parts margins.
Tutoring Flat session fee (60 %) or hourly $25; senior tutors 70 % Clear, session-based payouts parents understand.
Pet Grooming 50 % service commission, tips 100 %; retail shampoo 10 % Blends service, retail, and gratuity in one flow.

Best-practice wrap-up

  1. Define defaults first—Service Pay Rates or Payment Agreements— so every job auto-calculates.
  2. Use booking overrides sparingly for bonuses or corrections.
  3. Invite workers to Stripe early; payouts cannot process until onboarding finishes.
  4. Reconcile weekly with the Bookings Summary; export a backup CSV even if Stripe auto-pays.
  5. Leverage transparency—encourage staff to review their My Earnings charts; pay visibility is proven to boost engagement.

With these steps, OctopusPro becomes your field-service finance hub— calculating, splitting, exporting, and logging every dollar so you can scale operations instead of pushing paper.

For more information please subscribe to our YouTube channel.

Scroll to top