How to Link Square to Booking Koala: Payments, Setup, and What to Expect

Connecting Square to Booking Koala is one of the more common configuration steps for cleaning and home service businesses that want to collect payments through their booking software. The integration allows Booking Koala to process charges, deposits, and recurring payments using Square as the underlying payment gateway — but how smoothly that works in practice depends on several moving parts worth understanding before you start.

What the Square–Booking Koala Integration Actually Does

Booking Koala is a booking and business management platform built specifically for home service businesses — think house cleaning, lawn care, and similar recurring-service models. It handles scheduling, customer accounts, automated emails, and payment collection.

Square is a payment processor. When you link the two, Square becomes the engine that processes card transactions initiated inside Booking Koala. Customers enter their card details on your Booking Koala booking form, and Square handles the actual charge, decline logic, and fund transfer to your bank account.

The integration is API-based, meaning Booking Koala communicates with Square's servers in the background. You don't manually export and import transactions — the connection is live and automatic once configured.

Step-by-Step: Linking Square to Booking Koala

The general process follows a consistent path, though the exact interface labels can shift with platform updates. Always verify against Booking Koala's current dashboard if anything looks different.

1. Have an active Square account You need a fully verified Square account — not just a sign-up. Square requires identity verification and a linked bank account before it will process live payments. Complete this first.

2. Log into your Booking Koala dashboard Navigate to your admin panel. Look for a section labeled Settings, then find Payments or Payment Gateway within it.

3. Select Square as your payment processor Booking Koala typically supports multiple gateways. Choose Square from the available options. If you've previously used another processor like Stripe or Authorize.net, switching to Square will change how future transactions are processed — existing stored cards may not transfer.

4. Authorize the connection via OAuth Booking Koala will redirect you to a Square authorization page. This is a standard OAuth flow — you log into your Square account and grant Booking Koala permission to create charges on your behalf. You're not handing over passwords; you're issuing a permission token.

5. Confirm the connection and run a test Once authorized, return to Booking Koala and confirm the integration shows as active. Many setups include a test mode or sandbox environment — use it. Attempt a test booking and verify the charge appears in your Square dashboard under Transactions.

🔑 Key Variables That Affect How This Works

Not every business will experience the integration identically. Several factors shape your specific outcome:

Square processing fees are separate from Booking Koala subscription costs. Square charges a percentage per transaction (card-not-present rates apply for online bookings), and those fees are deducted before funds reach your bank. Booking Koala does not set or control those rates.

How Different Business Setups Experience This Differently

A solo operator just starting out will have a straightforward experience: one Square account, one Booking Koala workspace, and a single currency. The OAuth connection takes a few minutes and payments flow immediately after a successful test.

Businesses with multiple locations or franchises face more complexity. Square has its own location and team management structure. If you're running multiple Booking Koala instances or serving distinct territories, you'll need to think through how those map to your Square account hierarchy — whether that's multiple Square locations under one account or separate Square accounts entirely.

Businesses migrating from another gateway — say, moving from Stripe to Square — need to account for the fact that tokenized card data doesn't transfer between processors. Customers whose cards are stored in Booking Koala under a Stripe token will need to re-enter their payment details after you switch. This has customer experience implications, particularly for businesses with large recurring client bases.

High-volume operations should also be aware that Square has transaction limits and account review triggers, especially in the early weeks of a new account. A sudden spike in processing volume on a new Square account can trigger a hold. Understanding Square's own policies — not just Booking Koala's — is part of managing this integration well.

🛠 When Things Don't Connect Cleanly

If the OAuth authorization fails or the integration shows as disconnected after setup, common causes include:

• Pop-up blockers preventing the Square authorization window from opening
• Square account not fully verified (pending identity or banking documents)
• Browser session conflicts — try the process in an incognito window
• Booking Koala plan restrictions — confirm your current plan supports the Square integration

Booking Koala's support documentation and Square's developer status page are both worth checking if the connection stays broken, since issues can originate on either side of the integration.

What the Integration Doesn't Handle Automatically

Linking Square to Booking Koala doesn't automatically configure everything. Refunds initiated in Booking Koala should flow back through Square, but how refunds appear to customers and how they're processed depends on your settings in both platforms. Similarly, dispute handling (chargebacks) is managed through Square's dashboard, not Booking Koala.

Tax reporting, payout schedules, and transaction categorization all live on the Square side. Booking Koala shows you booking-level revenue data; Square shows you payment-level transaction data. 💡 Running reports across both systems gives a more complete financial picture than either one alone.

How well this integration fits your operation ultimately comes down to your business structure, volume, existing customer payment data, and which Booking Koala plan you're running — factors that vary enough from one business to the next that the setup experience can look quite different even when the technical steps are identical.