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

> Sign a Square Terminal in to your shop with a device code, and move a terminal that's already signed in somewhere else.

Pair a terminal with your Square location to take card payments from work orders. Generate its device code from **Settings** in TireTutor.

Follow the first procedure when the terminal shows Square's sign-in screen, and the second when another Square setup appears on the device.

## Before you start

You need these items:

* **A Square location mapped to your shop.** Open [**Settings → Integrations**](https://dealers.tiretutor.com/settings/organization/integrations). In the Square panel, use **Change location** when **Square location: Not set** appears.
* **Admin** access on the shop or its dealer. Without it, **Connect Square Terminal** is unavailable. Ask an **Owner** or **Admin** at your shop to grant access or to generate the code.
* **The terminal on your Wi-Fi.** A terminal that is off the network cannot redeem the code. Both procedures below include that step.

<Note>
  You can [take payment by link](/dealers/pos/managing-payment-links) before a terminal arrives. To order one, select **Buy a terminal**. Next, select **Continue to Square**; Square's website opens in a new tab.
</Note>

## Sign a terminal in

**When:** The terminal shows Square's sign-in screen.

<video controls title="Signing a new Square Terminal in with a device code" className="w-full aspect-video rounded-xl" src="https://solutions.tiretutor.ai/hubfs/How%20to%20Sign%20in%20to%20your%20Square%20Terminal.mp4">
  Your browser can't play this video. It walks through signing a Square Terminal in with a device code, which the written steps below cover.
</video>

<Tip>
  Keep TireTutor open next to the terminal. The code expires, so complete the steps before its countdown ends.
</Tip>

<Steps>
  <Step title="Open the terminal's settings">
    On the terminal, select the unlabeled gear icon beside **Sign in**.
  </Step>

  <Step title="Open Network">
    Select **Network**.
  </Step>

  <Step title="Join your Wi-Fi">
    Choose your Wi-Fi.
  </Step>

  <Step title="Return to the sign-in screen">
    Select the back arrow.
  </Step>

  <Step title="Open the Square panel">
    In TireTutor, open [**Settings → Integrations**](https://dealers.tiretutor.com/settings/organization/integrations).
  </Step>

  <Step title="Generate a device code">
    Select **Connect Square Terminal**. The dialog generates a device code.

    <Frame caption="The Connect Square Terminal dialog, with a device code and the time left before it expires.">
      <img src="https://mintcdn.com/tiretutor/YQTNOw3wAtHIIsvE/images/square-terminal/connect-dialog-device-code-desktop.png?fit=max&auto=format&n=YQTNOw3wAtHIIsvE&q=85&s=2ab537f1b27de16c93feaf7a3653e5cf" alt="Connect Square Terminal dialog showing the store and Square location, a six-character device code inside a green countdown ring, a chip reading Expires in 4:32, the four on-device steps, and a Verify terminal is connected button." width="1200" height="1356" data-path="images/square-terminal/connect-dialog-device-code-desktop.png" />
    </Frame>
  </Step>

  <Step title="Start sign-in on the terminal">
    On the Square Terminal, select **Sign in**.
  </Step>

  <Step title="Use the device code">
    Select **Use a device code**, below the **Continue** button. An email and password sign-in does not pair the terminal with TireTutor.
  </Step>

  <Step title="Enter the code">
    Enter the **Device code** from TireTutor.
  </Step>

  <Step title="Complete sign-in">
    Select **Sign in**. The terminal shows **Powered by Square** after pairing.
  </Step>

  <Step title="Verify the terminal">
    In TireTutor, select **Verify terminal is connected**.
  </Step>
</Steps>

<Check>
  TireTutor shows **Terminal paired to this location.** If the confirmation does not appear, complete the terminal steps. Then select **Verify terminal is connected** again.
</Check>

<Frame caption="The confirmation that appears once TireTutor can see the paired terminal.">
  <img src="https://mintcdn.com/tiretutor/YQTNOw3wAtHIIsvE/images/square-terminal/terminal-paired-confirmation-desktop.png?fit=max&auto=format&n=YQTNOw3wAtHIIsvE&q=85&s=80092fac1f65b77b6d455607c08d9a89" alt="Connect Square Terminal dialog after verifying, showing a green-bordered confirmation reading Terminal paired to this location beneath the Verify terminal is connected button, with the device code and countdown still above it." width="1200" height="1484" data-path="images/square-terminal/terminal-paired-confirmation-desktop.png" />
</Frame>

Pairing does not confirm payment readiness. Complete [Confirm the terminal is ready](#confirm-the-terminal-is-ready).

<Tip>
  If the code expires, select **Generate a new code**. Repeat the terminal steps with the replacement code.
</Tip>

## Set up a terminal that's already signed in

**When:** The terminal shows another Square setup instead of the sign-in screen.

<video controls title="Moving an existing Square Terminal to TireTutor" className="w-full aspect-video rounded-xl" src="https://solutions.tiretutor.ai/hubfs/Setting%20up%20an%20existing%20square%20terminal.mp4">
  Your browser can't play this video. It walks through moving a Square Terminal that's already signed in elsewhere, which the written steps below cover.
</video>

A terminal signs in to one place at a time. TireTutor cannot sign it out remotely, so sign out on the device.

<Note>
  A Square Point of Sale app sign-in needs one more step because signing out on the terminal alone does not clear it. Open [Square Dashboard → Devices](https://app.squareup.com/dashboard/devices). Select the device. Choose **Forget**. Then follow [Sign a terminal in](#sign-a-terminal-in).
</Note>

<Warning>
  Keep **This device only** when the terminal asks where to sign out. **Sign me out of all devices** signs out every terminal on these Square credentials.
</Warning>

<Steps>
  <Step title="Open More on the terminal">
    Select **More**, the last tab along the bottom of the screen.
  </Step>

  <Step title="Find the sign-out link">
    Scroll to the bottom. The **Sign out** link carries your business name, below **Customize** and above **Switch location**.
  </Step>

  <Step title="Start sign-out">
    Select **Sign out**.
  </Step>

  <Step title="Keep This device only">
    The terminal asks **Where do you want to sign out?** Keep **This device only** selected.
  </Step>

  <Step title="Confirm the sign-out">
    Select the red **Sign out** button at the top right. The terminal returns to the sign-in screen.
  </Step>

  <Step title="Open the terminal's settings">
    Select the unlabeled gear icon beside **Sign in**.
  </Step>

  <Step title="Open Network">
    Select **Network**.
  </Step>

  <Step title="Join your Wi-Fi">
    Choose your Wi-Fi.
  </Step>

  <Step title="Return to the sign-in screen">
    Select the back arrow.
  </Step>

  <Step title="Start sign-in">
    Select **Sign in**.
  </Step>

  <Step title="Use a device code">
    Select **Use a device code**.
  </Step>

  <Step title="Open the Square panel">
    In TireTutor, open [**Settings → Integrations**](https://dealers.tiretutor.com/settings/organization/integrations).
  </Step>

  <Step title="Generate the code">
    Select **Connect Square Terminal**.
  </Step>

  <Step title="Pair the terminal">
    Enter the code on the terminal.
  </Step>

  <Step title="Complete sign-in">
    Select **Sign in**.
  </Step>

  <Step title="Verify the connection">
    In TireTutor, select **Verify terminal is connected**.
  </Step>
</Steps>

TireTutor has no remote unpair action. Sign out on the terminal before you sell, return, or move it to another shop. If you no longer have the device, contact Square.

## Confirm the terminal is ready

**When:** You finished pairing, or the terminal does not take a payment.

Open [**Settings → Integrations**](https://dealers.tiretutor.com/settings/organization/integrations). In the Square panel, select **View terminals**.

Find the terminal. Review its **Status**.

| Column | What it tells you |
| - | - |
| **Device name** | The terminal name and Square device ID |
| **Connection** | **Device code** for a physical terminal paired with TireTutor, or **No device code** |
| **Status** | **Available** or **Offline** |
| **Square location** | The Square location for the device |
| **Paired** | The pairing date |

<Frame caption="The Square Terminals dialog listing two paired devices — one available, one offline.">
  <img src="https://mintcdn.com/tiretutor/YQTNOw3wAtHIIsvE/images/square-terminal/terminals-list-desktop.png?fit=max&auto=format&n=YQTNOw3wAtHIIsvE&q=85&s=99b327cbc9dfacdc45bd07b478d3bfa0" alt="Square Terminals dialog listing two devices in a table: Front counter marked Device code and Available, and Service bay marked Device code and Offline, each with its Square location and the date it was paired." width="1800" height="652" data-path="images/square-terminal/terminals-list-desktop.png" />
</Frame>

<Note>
  The dialog lists supported physical terminals with paired device codes at your mapped Square location. It is not Square's complete device inventory because it excludes mobile devices. Without a mapped location, the list covers paired terminals across the Square account's locations.
</Note>

<Tip>
  If you just powered on the terminal, select **Refresh** in the dialog. Square takes a moment to report a device as available.
</Tip>

<Check>
  The terminal appears with **Device code** and **Available**.
</Check>

## Choose which terminal takes a payment

**When:** Your shop has several terminals, or this browser needs a different terminal.

<Steps>
  <Step title="Open the terminal choice">
    On the work order, find the **Terminal:** row. It shows a terminal name or **Default**.
  </Step>

  <Step title="Open Choose a terminal">
    Select the swap icon beside it, labeled **Switch terminal**.
  </Step>

  <Step title="Check the status">
    Find the terminal you want. **Available** means Square reports it as available. **Offline** means Square does not report it as available.
  </Step>

  <Step title="Select the terminal">
    Select the row for that terminal.
  </Step>

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

<Check>
  The **Terminal:** row shows the selected device. TireTutor remembers the choice in this browser for this shop.
</Check>

To remove this browser's preference, open **Choose a terminal**. Select **Clear selection**.

Without a preference, TireTutor chooses the first paired physical terminal Square lists for the location. If the shop has only one, TireTutor chooses that terminal. This choice doesn't check availability, so select an **Available** terminal before you take a payment.

To rename a terminal, expand **How terminal selection works** in **Choose a terminal**. It shows the on-device path to **Device name**.

## When a terminal cannot take payments

Select **Connection health** in the Square panel first. The dialog identifies Square connection and setup issues.

Check these terminal-specific states:

* **Someone signed in to the Square Point of Sale app on the terminal.** TireTutor refuses the charge with **Not fully integrated with TireTutor POS**, and signing out on the terminal alone does not clear it. Open [Square Dashboard → Devices](https://app.squareup.com/dashboard/devices). Select the device. Choose **Forget**. Then pair it again with a device code.
* **A terminal shows Offline.** Check its power and its Wi-Fi connection. Select **Refresh** in **Square Terminals**.
* **A row shows Signed into a different Square location.** TireTutor refuses the charge with **Paired at a different location**. Sign out on the device. Pair it again with a device code generated from this shop.
* **A terminal is missing.** Pair it with **Connect Square Terminal** and a device code.

### Resolve a pending payment

<Warning>
  **Override Payment Pending** changes the work order's status. It does not cancel the payment in Square. Before retrying, confirm in Square that the original payment did not complete.
</Warning>

An **Owner** or **Admin** can return a work order at **Payment Pending** to **In Progress**. Then you can take the payment again.

<Steps>
  <Step title="Open the work order">
    Open the affected work order.
  </Step>

  <Step title="Open More Options">
    Select **More Options**, the three-dot button next to **Print Invoice**.
  </Step>

  <Step title="Select Override Payment Pending">
    Select **Override Payment Pending**. **Void Work Order** is not in the menu while the payment is pending. It returns when the work order is **In Progress**.

    <Frame caption="More Options on a work order at Payment Pending.">
      <img src="https://mintcdn.com/tiretutor/QkEkGGh6zlSi1-bM/images/square-terminal/more-options-payment-pending-desktop.png?fit=max&auto=format&n=QkEkGGh6zlSi1-bM&q=85&s=602dd9d8ad65227f222a76b002f42cd9" alt="Work order header with a Payment Pending status. The More Options menu is open and lists Override Payment Pending and Issue Store Credit, with no Void Work Order." width="2368" height="386" data-path="images/square-terminal/more-options-payment-pending-desktop.png" />
    </Frame>
  </Step>

  <Step title="Select Override">
    Select **Override**. The dialog says the work order goes back to **In Progress**. **Cancel** closes the dialog and keeps **Payment Pending**.

    <Frame caption="The Override Payment Pending confirmation.">
      <img src="https://mintcdn.com/tiretutor/QkEkGGh6zlSi1-bM/images/square-terminal/override-payment-pending-dialog-desktop.png?fit=max&auto=format&n=QkEkGGh6zlSi1-bM&q=85&s=e85f1d029547b035e27b5fadee414278" alt="Override Payment Pending dialog. It says the work order will be set back to In Progress so you can retry the payment, with Cancel and Override buttons." width="1696" height="1072" data-path="images/square-terminal/override-payment-pending-dialog-desktop.png" />
    </Frame>
  </Step>

  <Step title="Take the payment again">
    The work order shows **In Progress**. Take the payment on the terminal, or use a different payment method.
  </Step>
</Steps>

If the work order belongs to another shop, it opens in view-only mode without **More Options**. To change to that shop, select **Switch** in the view-only banner.

If the terminal still cannot take payments, contact support with the terminal's device name and the **Connection health** result.

<Note>
  A paired terminal is not required for [payment links](/dealers/pos/managing-payment-links).
</Note>

## Common questions

<AccordionGroup>
  <Accordion title="How can I identify a device-code terminal?">
    Look at the idle screen. A paired terminal shows **Powered by Square** and waits. Sales come from TireTutor.

    A Square Point of Sale sign-in prevents TireTutor from sending payments to that terminal.
  </Accordion>

  <Accordion title="Why does an available terminal reject TireTutor payments?">
    **Available** means Square can reach the device. It does not mean TireTutor can send payments to it. If someone signed in to Square's own app on that terminal, forget the device in [Square Dashboard → Devices](https://app.squareup.com/dashboard/devices). Then pair it again with a device code.
  </Accordion>

  <Accordion title="Why does Connection health pass while one terminal fails?">
    **Connection health** checks the shop's Square connection. It does not inspect the active app on each device.
  </Accordion>

  <Accordion title="Why is a terminal missing from Square Terminals?">
    Pair the terminal with a TireTutor device code. A Square account sign-in does not create that pairing.
  </Accordion>

  <Accordion title="Can one terminal run Square and TireTutor together?">
    Use one sign-in method at a time. Pair the terminal with a device code for TireTutor payments.
  </Accordion>

  <Accordion title="What happens after an account sign-in on the terminal?">
    TireTutor cannot send payments to that device. Signing out on the terminal alone does not clear the sign-in. Forget the device in [Square Dashboard → Devices](https://app.squareup.com/dashboard/devices). Then pair it again with a device code.
  </Accordion>
</AccordionGroup>

## Where to go next

<Columns cols={2}>
  <Card title="Taking payments" icon="cash-register" href="/dealers/pos/taking-payments">
    Take terminal and manual payments from a work order.
  </Card>

  <Card title="Overview" icon="book" href="/dealers/pos/overview">
    Learn how the Point of Sale pages fit together.
  </Card>
</Columns>