Connect Square so your clients can pay invoices online through it. Go to Settings > Integrations > Payment and click Connect on the Square card. Paste the Production Access token from your Square application and your Location ID. Choose a Currency and click Save.
In this guide you’ll learn how to:
- Find your Square Production access token
- Find your Square Location ID
- Connect Square to OneSuite
- Switch Square on for an invoice
Before you start
- You need access to Settings. If you can’t see Integrations, ask an admin.
- You need a Square account and an application in the Square Developer Console.
- An access token is a private code from Square. It lets OneSuite work with your Square account.
- Use the application’s own (personal) access token, not an OAuth token. An OAuth token is one an app gets when you let it sign in to Square for you.
- Square does not let OAuth tokens manage webhooks. A webhook is how Square tells OneSuite that a client has paid.
- Square gives each application separate Production and Sandbox tokens. Sandbox is Square’s test mode. Use the Production token to take real payments.
What does OneSuite ask for when you connect Square?
| Field | Where to find it | Required |
|---|---|---|
| Access token | In the Square Developer Console, open your application, then Credentials. Use the Production access token. The example in the field starts with EAAA. | Yes |
| Location ID | In the Square Developer Console, open your application, then Locations. Or in the Square Dashboard, open Settings, then Business, then Locations. Payments are taken in this location’s currency. | Yes |
| Currency | Starts as US Dollar (USD). OneSuite uses it when an invoice has no currency of its own. | No |
How do I connect Square to OneSuite?
- Click your name at the bottom of the sidebar, then click Settings.
- Under Integrations, click Payment.
- On the Payment Methods page, find Square and click Connect.
- In the Square Developer Console, open your application, then Credentials. Copy the Production access token.
- Paste it into Access token in OneSuite.
- In the same application, open Locations. Copy the Location ID.
- Paste it into Location ID.
- Check the Currency setting.
- Click Save.

How do I check if it worked?
The Square card on the Payment Methods page now says Connected instead of Not connected. You also see Square marked Connected under Invoices > Configure > Getting paid > Online payments.
OneSuite switches a connected gateway on for every new invoice. An invoice you created earlier keeps its own choice. To use Square on an older invoice:
- Open the invoice.
- Switch Square on in its Payments panel.
- Save the invoice and send it again.
FAQs
Can I use an OAuth token for Square?
No. Use the application’s own (personal) access token. Square does not let OAuth tokens manage webhooks.
Where do I find my Square Location ID?
In the Square Developer Console, open your application and go to Locations. Or in the Square Dashboard, open Settings, then Business, then Locations.
Which currency does Square use for payments?
Square takes payments in the currency of your Square location. OneSuite uses the Currency list when an invoice has no currency of its own.
What to do next
See every gateway: Browse all the guides in Payment Integration.
Record the money that arrives: Log payments made outside a gateway with How to Record Invoice Payments.