Connecting Square to take card payments (Terminal or Reader)
Updated
On this page
Sidebar: Business Settings → Payment Settings, on the Payment Settings tab.
Use this if you already take cards with Square and want to keep doing that. You do not need to set up Alaga Payments as well; Square is enough on its own.
Alaga works with two kinds of Square card hardware:
- Square Terminal. The handheld Square device with its own screen and a built-in receipt printer. Alaga sends each payment straight to it.
- Square Reader (the small reader that pairs with a phone or tablet), used through the Square Point of Sale app on your tablet or phone. At checkout, Alaga opens the Square app with the amount, you take the card on the Reader, and Square brings you back to Alaga.
What you need
- A Square account that you can sign in to.
- A Square Terminal, or a Square Reader with the Square app on the tablet or phone you check out on.
- About five minutes.
You must be the business owner to connect Square.
1. Connect your Square account
- Go to Business Settings → Payment Settings and open the Payment Settings tab.
- Open Already have a card processor? and choose Square.
- Click Connect with Square.
- Square opens. Sign in with your Square login and approve Alaga.
- You come straight back to Alaga, and it says Square is connected.
Alaga only gets permission to take payments on your Square Terminal or Square Reader and to issue refunds. It never sees your Square password.
Once you are connected, the Square card shows which Square business and location you are connected to. Square app payments must be taken at that location.
You do not need any codes or tokens from the Square Dashboard. Signing in with Square is the whole setup. If you have codes from Square's website, ignore them here.
2. Choose your Square device
Under How do you take cards with Square?, pick one:
- Square Reader with the Square app on this tablet. Sign in to the Square app on your tablet or phone with the same Square account you connected. That's all the setup there is.
- Square Terminal. Then pair it (next step).
If you don't choose, Alaga uses your Terminal when one is paired and the Square app otherwise.
3. Pair your Terminal (Square Terminal only)
- On the Square card, click Pair a Terminal.
- If your Square account has more than one location, pick the location this Terminal is at, then click Get pairing code.
- On the Terminal, if it is signed in, open Settings and sign out.
- On the Terminal's sign-in screen, tap Use a device code.
- Type in the code Alaga is showing.
- Wait a few seconds. Alaga says Your Terminal is paired.
The code lasts 5 minutes. If it runs out, click Get a new code and enter the new one.
Have more than one Terminal? Pair each one the same way. Give each a clear name, like "Front desk," because staff pick the Terminal by name at checkout.
While a Terminal is paired to Alaga, it takes the payments Alaga sends it. To use it on its own with Square's app again, sign out of it on the Terminal and sign in with your Square login.
4. Take a payment
On a Square Reader (Square app)
Do this on the tablet or phone that has the Square app.
- Check out as normal and press Pay.
- Choose Charge on Square.
- On Add a Tip, you can choose who gets the tip if the customer tips on Square. This is optional.
- Tap Charge on Square. The Square app opens with the amount.
- The customer taps, inserts or swipes their card on the Reader and adds any tip in the Square app.
- Square brings you back to Alaga, which shows Payment recorded.
Alaga checks the payment with Square before it records anything.
Checking out on a computer, charging on the tablet
If you check out on the front-desk computer, send the charge to the tablet:
- On the computer, check out as normal, press Pay and choose Charge on Square.
- Click Send to tablet. Keep the window open.
- On the tablet, have Alaga open and signed in. The charge pops up at the bottom of the screen.
- Tap Charge on Square on the tablet. The Square app opens with the amount, and you take the card on the Reader.
- The computer shows Payment recorded as soon as Square confirms it.
Changed your mind? Click Cancel charge on the computer, or Cancel on the tablet. If Square had already taken the card, Alaga still records the payment.
On a Square Terminal
- Check out as normal and press Pay.
- Choose Card.
- On Add a Tip, you can choose who gets the tip if the customer tips on Square. This is optional.
- Pick the Terminal.
- The customer taps, inserts or swipes their card on the Terminal.
- Alaga shows Payment Successful! when Square approves it.
Need to stop a payment that's waiting on the Terminal? Click Cancel Payment.
Either way
The customer adds their tip on the Square device, not on your screen. If the customer hands over a cash tip as well, record it on the Add a Tip step.
Choosing who gets the Square tip before the payment is optional. If the customer tips and nobody was chosen, the Payment recorded (or Payment Successful!) screen shows $X tip not assigned. Click Assign to give it to someone for payroll, or Don't assign to leave it on the payment only. On Send to tablet, whichever screen answers first counts; the other one stops asking. See Tips — how they are captured and paid out.
Alaga records the payment for you. That includes the amount, the tip and the Square payment, and the invoice or appointment is marked paid. If the screen is closed early or the internet drops, Alaga still picks up the finished payment from Square within a few minutes. Do not charge the card a second time.
Refunds
- Go to Reports → Payments & Transactions.
- Find the payment and click Refund.
- Choose Card (refund to the card via Square), enter the amount and click Refund on Square.
The money goes back to the customer's card, usually within a few business days. You can refund all of it or part of it, but never more than what is left on that payment.
Payouts and fees
Square still handles your money, just like before. Square sends payouts to your bank and takes its processing fees. Check payouts and fees in your Square Dashboard, not in Alaga. Alaga's reports show what the customer paid.
Disconnecting
On the Square card, open Advanced and click Disconnect Square. Alaga stops taking payments through Square and your paired Terminals are removed. Past payments stay in your records. You can reconnect any time.
If Alaga ever shows Square needs to be reconnected, Square has stopped accepting the connection. This can happen if someone removed Alaga from the Square Dashboard. Click Reconnect and sign in again.
If something is not working
- "The Square app is signed out." Open the Square app, sign in with the Square account you connected to Alaga, then charge again.
- "Signed in to a different Square account or location." The Square app must use the same Square account, and the location shown on Alaga's Square card. Switch it in the Square app, then charge again.
- Charge on Square does nothing. Make sure the Square app is installed on this tablet or phone, then try again.
- The Square app took the payment offline. Alaga can't confirm offline payments. Once Square syncs, check the sale in your Square Dashboard and record it in Alaga as Card (terminal).
- "Use a device code" isn't on the Terminal. The Terminal is still signed in. Sign out from the Terminal's Settings first.
- The code didn't work. It may have expired. Click Get a new code. Also make sure you are typing the code from Alaga, not one from the Square Dashboard.
- Alaga is stuck on "Waiting for your Terminal." Check the Terminal is on Wi-Fi or Ethernet.
- The Card button is missing at checkout. Square isn't fully set up. Check that Payment Settings says Square is connected. If you chose Square Terminal, a Terminal must be paired; until then, checkout offers Card (terminal) so you can record card payments by hand.
- "No active location." Add a location in your Square Dashboard, then come back and choose it on the Square card.
Still stuck? Contact support with your business name and what the screen says. A screenshot helps.