FieldFoxx Setup

Getting Started Guide

Use this checklist to configure FieldFoxx for day-to-day use. Most companies can complete initial setup in under 30 minutes.

ClientsQuotesInvoicesStripe ConnectInvoice Reminders

Quick Start Checklist

Use this to confirm your account is fully configured before onboarding your team.

Open
Open
Open
Open
Open
Open

1. Complete Your Company Profile

Go to Settings and add your company name, phone number, and address so all client-facing documents are branded correctly.

  • Set Company name, phone, and address in the Company card.
  • Confirm your personal name in the Profile card.
  • If you have technicians, verify role access from Team.

2. Connect Stripe for Online Payments

Enable Stripe Connect so clients can pay invoices online and funds are deposited to your connected Stripe account.

  • In Settings, open the Online Payments card.
  • Click Connect Stripe and complete onboarding in Stripe.
  • Return to Settings and confirm account status shows Active.

3. Create Your First Client

Add at least one client before creating quotes, jobs, or invoices.

  • Enter client name, email, and phone.
  • Include address to support job scheduling and maps.
  • Save and verify the client appears in your Clients list.

4. Build a Quote and Send It

Use quote line items to present pricing before work begins.

  • Select the client and add line items with quantity and unit price.
  • Review subtotal, tax, and total before saving.
  • Open the quote and mark/send it to the client.

5. Convert Work Into an Invoice

Create invoices from completed work and send clients a payment-ready link.

  • Select client and add billable line items.
  • Set due date and verify totals.
  • Open invoice and use Send Invoice to email the client.

6. Turn On Automatic Invoice Reminders

Configure reminder timing so unpaid invoices are followed up automatically.

  • In Settings, open the Invoice Reminders card.
  • Enable reminders and choose due/overdue timing.
  • Click Save Reminders to persist your automation rules.

Go-Live Day Playbook

Follow this sequence for your first production transaction to verify everything end-to-end.

  1. Create a real client record with valid email.
  2. Send a quote and confirm the client receives it.
  3. Create and send an invoice from that client record.
  4. Make a real or low-dollar test card payment.
  5. Verify invoice status changes to Paid and one payment notification appears.
  6. Confirm funds and payout status in Payments/Stripe dashboard.

Troubleshooting First Week

Client cannot pay invoice online

Confirm Stripe Connect is Active in Settings and that the invoice status is Sent or Overdue.

Invoice reminder toggle resets after save

Save reminders from the Invoice Reminders card, then refresh Settings and verify values persisted.

Duplicate payment toast appears

Update to the latest version with atomic paid-status updates in invoice payment processing.

Stripe webhook says signature verification failed

Make sure STRIPE_WEBHOOK_SECRET matches the exact webhook endpoint secret for the current mode.

FAQ

Should we create a quote before every invoice?

Recommended. Quotes help lock scope and pricing before work, then invoices track final billing.

Where do client payments go?

Invoice payments route to the company Stripe Connect account, not held in the platform account.

How often should reminder jobs run?

Daily is the standard setup and matches most due/overdue reminder schedules.

Who should access billing settings?

Owners and admins only. Technicians should be restricted from subscription and payment controls.

Need Help?

If anything in setup does not work as expected, submit a support request and include a short description plus screenshots.