---
title: How to Connect Square to OneSuite
description: "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…"
url: "https://help.onesuite.io/docs/how-to-connect-square-to-onesuite/"
updated: "2026-11-19"
category: Payment Integration
---

# How to Connect Square to OneSuite

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?

1. Click your name at the bottom of the sidebar, then click **Settings**.
2. Under **Integrations**, click **Payment**.
3. On the **Payment Methods** page, find **Square** and click **Connect**.
4. In the Square Developer Console, open your application, then **Credentials**. Copy the Production access token.
5. Paste it into **Access token** in OneSuite.
6. In the same application, open **Locations**. Copy the Location ID.
7. Paste it into **Location ID**.
8. Check the **Currency** setting.
9. Click **Save**.

![](https://help.onesuite.io/wp-content/uploads/2026/11/open-payment-settings-in-onesuite-1-925x1024.png)

## 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:

1. Open the invoice.
2. Switch Square on in its **Payments** panel.
3. 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](https://help.onesuite.io/docs-category/payment-integration/).

**Record the money that arrives:** Log payments made outside a gateway with [How to Record Invoice Payments](https://help.onesuite.io/docs/how-to-record-invoice-payments/).
