What linking Square to Booking Koala does
Linking Square to Booking Koala connects your payment processor to your booking calendar, so payments and reservations sync automatically. When a customer books through Booking Koala and pays with Square, the payment goes through Square's system, the booking appears in your Booking Koala calendar, and you avoid manual entry on both sides.
This connection works one direction for most small businesses: Booking Koala sends booking information to Square, and Square processes the payment. You still manage your calendar in Booking Koala and your payment history in Square, but they talk to each other instead of sitting in separate silos.
The setup takes about 10 to 15 minutes if you have both accounts already open and your Square API credentials ready. If you do not have a Square account yet, add another 5 to 10 minutes to create one.
Key Takeaways
- You need an active Square account and a Booking Koala account before you can link them; both are free to set up, though Square charges per transaction.
- The connection happens inside Booking Koala's settings, not inside Square, so you will spend most of your time in the Booking Koala dashboard.
- Square requires you to generate API credentials (a specific code that lets Booking Koala talk to Square) before the link will work.
- Once linked, new bookings and payments sync automatically, but you should test with a small transaction before relying on it for real customers.
- If the link breaks, the most common cause is an expired or revoked API credential, which you can regenerate in Square's settings in under a minute.
Create or confirm your Square and Booking Koala accounts
Before you link anything, you need both accounts active and accessible. If you already use Square for in-person or online payments, you are halfway there. If not, go to square.com, click "Sign Up", and follow the prompts to create a business account. Square asks for your business name, your personal name, and a phone number. The account is free; you only pay when you process a payment.
For Booking Koala, go to bookingkoala.com and create an account using your email. Booking Koala is also free to set up. Once both accounts exist and you can log into each one, move to the next step.
You do not need to set up your full Square payment terminal or Booking Koala calendar yet — just confirm the accounts exist and you can access them. The linking process will guide you through any additional setup that is required.
Generate your Square API credentials
Square uses API credentials — a unique code that proves Booking Koala is allowed to talk to your Square account — to authorize the connection. You generate this code inside Square, then paste it into Booking Koala. Without it, the two systems cannot communicate.
Log into your Square account at squareup.com. Click the menu icon (three horizontal lines) in the top left, then select "Developer". On the Developer page, click "API Keys" in the left sidebar. You will see two sections: "Production" and "Sandbox". For a real business, use Production.
Under Production, look for "Access Token". Click "Show" next to it. A long string of letters and numbers will appear. Copy this entire string — do not edit it or add spaces. You will paste it into Booking Koala in the next step. Keep this tab open or write the token down; you will need it in the next 10 minutes.
If you do not see an Access Token, click "Generate" first, then copy it. Square will create one for you automatically.
Connect Square to Booking Koala through the settings menu
Log into Booking Koala. In the main dashboard, look for "Settings" — usually a gear icon in the top right or a menu option in the left sidebar. Click Settings, then look for a section called "Integrations", "Payment Methods", or "Connected Services". The exact name varies depending on your Booking Koala plan, but it will be in the settings area.
Find "Square" in the list of available integrations. Click "Connect" or "Link". Booking Koala will ask you to paste your Square Access Token. Go back to your Square tab, copy the Access Token again (or use the one you wrote down), and paste it into the Booking Koala field. Do not add any extra text or spaces.
Click "Save" or "Confirm". Booking Koala will test the connection by sending a small request to Square. If the token is correct, you will see a confirmation message like "Connected successfully" or "Square is now linked". If you see an error, double-check that you copied the entire token with no extra spaces at the beginning or end.
Set up your payment settings in Booking Koala
Now that Square is connected, you need to tell Booking Koala to use Square for payments. Still in Settings, look for "Payment Methods" or "Checkout Settings". You should see Square listed as an option. Click it and select "Enable" or toggle it on.
Booking Koala will ask you to choose whether customers pay when they book or later. For most small businesses, "Collect payment at booking" is simpler — the customer pays when ready, and you know the booking is solid. If you offer services where payment later makes sense (like a deposit now, full payment on the day), choose that option instead.
You can also set a deposit amount if you want customers to pay only part of the total at booking. For example, you might collect 50% when they book and the rest when they arrive. Booking Koala and Square will handle the math automatically.
Test the connection with a small transaction
Before you send this link to real customers, test it yourself. Create a test booking in Booking Koala using a test credit card number. Square provides test card numbers for this purpose: use 4111 1111 1111 1111 as the card number, any future expiration date, and any three-digit security code.
Complete the booking and payment flow as a customer would. Watch for the booking to appear in your Booking Koala calendar and the payment to show in your Square dashboard. Both should happen within a few seconds. If the booking appears but the payment does not, or vice versa, the link is incomplete — go back to the integration settings and check that your Access Token is still valid.
Once the test booking works, delete it from your calendar (Booking Koala usually has a delete option in the booking details). You are now ready to share your booking link with real customers.
Troubleshoot a broken connection
If bookings stop syncing or payments fail to process, the most common cause is an expired or revoked Access Token. Square automatically rotates tokens for security reasons, and if yours expires, Booking Koala will not be able to reach Square.
To fix this, log into Square, go to Developer > API Keys > Production, and generate a new Access Token. Copy it, go back to Booking Koala Settings > Integrations > Square, and paste the new token into the field. Save and test again with a small transaction.
If you see an error message that says "Invalid token" or "Connection failed", the token you pasted is incomplete or has extra characters. Copy it again directly from Square, making sure you start at the first letter and end at the last letter with no spaces before or after.
If bookings sync but payments do not process, check that you enabled Square as a payment method in Booking Koala's checkout settings (step 4 above). If it is enabled and payments still fail, contact Booking Koala support with the booking ID and the error message you see — they can check whether the issue is on their end or Square's.
Frequently Asked Questions
Do I have to use Square, or can I link a different payment processor?
Booking Koala supports Square, Stripe, and PayPal, depending on your plan. Square is one of the most common choices because it works with both online bookings and in-person payments. Check your Booking Koala plan to see which processors are available to you.
What happens if a customer books but the payment fails?
The booking usually does not appear in your calendar until the payment goes through. If the payment fails (for example, the card is declined), Booking Koala will show an error to the customer and ask them to try a different card. The booking is not confirmed until the payment succeeds.
Can I charge different prices for different services?
Yes. In Booking Koala, you set the price for each service or time slot separately. When a customer books, they see the price for that specific service, and Square charges that amount. The link itself does not care about the price — it just processes whatever amount Booking Koala sends.
How long does it take for money to appear in my bank account?
Square deposits funds to your bank account on a schedule that depends on your account type and location. Most businesses see deposits within one to two business days. Check your Square dashboard under "Payouts" to see when your next deposit is scheduled.
What if I want to refund a customer?
You process refunds in Square, not in Booking Koala. Log into Square, find the transaction, and click "Refund". The refund goes back to the customer's card. You should also delete or cancel the booking in Booking Koala so your calendar is accurate. The two systems do not automatically sync refunds, so you have to manage both sides.