> ## Documentation Index
> Fetch the complete documentation index at: https://help.tiretutor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Square setup

> Connect Square to TireTutor, map your shop to a Square location, and check payment readiness.

Connect your Square account once, then map each shop to its Square location. The connection supports payment links and card payments on a Square Terminal.

## Connect Square

You need **Admin** or **Owner** access to this shop or its dealer to connect Square or change the location mapping. Otherwise, ask an **Owner** or **Admin** at your shop.

Open [**Settings → Integrations**](https://dealers.tiretutor.com/settings/organization/integrations). Find the Square panel.

<Steps>
  <Step title="Connect your Square account">
    Select **Set up Square**.
  </Step>

  <Step title="Complete the Square connection">
    Complete the connection in Square.
  </Step>

  <Step title="Return to TireTutor">
    Return to TireTutor. The Square panel shows **Connected**, **Warning**, or **Not Connected**.
  </Step>

  <Step title="Check the location mapping">
    Read the **Square location** line in the Square panel.
  </Step>

  <Step title="Change the mapping if needed">
    If the location shows **Not set** or the wrong location, select **Change location**.
  </Step>

  <Step title="Choose the location">
    In **Map Square location**, select the correct **Square location**. A location already mapped to another shop is unavailable.
  </Step>

  <Step title="Save the mapping">
    Select **Save**.
  </Step>

  <Step title="Run Connection health">
    Select **Connection health**.
  </Step>

  <Step title="Review the checks">
    Review each row in **Square connection health**.
  </Step>

  <Step title="Complete the fixes">
    Follow the action on each row that needs attention.
  </Step>

  <Step title="Check again">
    Select **I’ve verified in Square — re-check** after completing the fixes.
  </Step>
</Steps>

<Frame caption="The Square panel after setup — Connected, a location mapped, and Connection health a click away.">
  <img src="https://mintcdn.com/tiretutor/Qj_5eXIbhLXzK4kA/images/square/square-panel-connected-desktop.png?fit=max&auto=format&n=Qj_5eXIbhLXzK4kA&q=85&s=ac9c5665aaa8c3756c11837742ea0ef7" alt="Square panel in Settings showing a green Connected chip, a Connection health link, Reconnect with Square or switch account, Connect Square Terminal, Buy a terminal, and Square location: Demo Tire & Auto — Main Street with a Change location button." width="1800" height="648" data-path="images/square/square-panel-connected-desktop.png" />
</Frame>

<Frame caption="A healthy Connection health run — every required check green, payment links ready.">
  <img src="https://mintcdn.com/tiretutor/Qj_5eXIbhLXzK4kA/images/square/square-connection-health-desktop.png?fit=max&auto=format&n=Qj_5eXIbhLXzK4kA&q=85&s=803386360aaaacd7cc029ca79daf1a9a" alt="Square connection health dialog showing Payments ready!, green checks in Square setup progress, and a Re-check button." width="1360" height="1216" data-path="images/square/square-connection-health-desktop.png" />
</Frame>

<Check>
  **Square connection health** shows **Payments ready!** Payment links work before you pair a terminal.
</Check>

## When Connection health flags something

The Square panel shows one of these status chips:

* **Connected**: the required checks passed.
* **Warning**: the Square connection works, but a required check needs attention.
* **Not Connected**: connect or reconnect Square.

Select the chip or **Connection health** to open **Square connection health**.

### Read the checklist

TireTutor runs nine checks in this order:

1. **Square connected to TireTutor**
2. **Square authorization valid**
3. **Permissions granted**
4. **Merchant active**
5. **Location mapped**
6. **Location capable**
7. **Payments observed**
8. **Payment link enabled**
9. **Terminal connected**

A later required row shows **Waiting on an earlier step** until the earlier issue clears, but **Payments observed** runs independently.

**Payments observed** and **Terminal connected** are optional. They do not block payment links, so pair a terminal only when you need card payments on the device.

### Follow the fix on each row

A row can show a fix with a button or link. Follow the action shown on each check.

* A button opens the step in TireTutor: the Square connection, **Map Square location**, or **Connect Square Terminal**.
* A link opens Square or a guide in a new tab. Finish the fix there, then return to TireTutor.

After a Square-side fix, select **I’ve verified in Square — re-check**. When all required rows pass, the footer changes to **Re-check**.

<Frame caption="Connection health naming what's missing — here, the shop's Square location.">
  <img src="https://mintcdn.com/tiretutor/Qj_5eXIbhLXzK4kA/images/square/square-connection-health-issue-desktop.png?fit=max&auto=format&n=Qj_5eXIbhLXzK4kA&q=85&s=2249eb32cf8a6ecf5548f42f7ac3f300" alt="Square connection health dialog showing unfinished setup, a Choose location button, and Payment link enabled waiting on an earlier step." width="1360" height="1440" data-path="images/square/square-connection-health-issue-desktop.png" />
</Frame>

### Follow the payment warnings

TireTutor also shows setup warnings outside **Settings**:

* **Finish setup to start taking payments** or **Payment setup needs attention** appears in the app banner. Select **View details** to open **Square connection health**.

- **Process Payment** is unavailable on a work order when a required check fails. Select **Please complete Square setup** to open the same dialog.

## Where to go next

<Columns cols={2}>
  <Card title="Square Terminal" icon="credit-card" href="/dealers/pos/square-terminal">
    Pair a terminal and choose which device takes a payment.
  </Card>

  <Card title="Text to Pay and Tap to Pay" icon="link" href="/dealers/pos/managing-payment-links">
    Take payment without a paired terminal.
  </Card>
</Columns>
