The Square settings page in Settings → Integrations is where each garage manages its Square connection. You'll come here three times: to connect initially, to check status if something looks off, and to disconnect if you ever change Square accounts.
What's on the page
| Section | What it shows |
|---|---|
| Connection status | "Connected" + Merchant ID, or "Not connected" with a button |
| Disconnect button | Removes the connection (revokes the token Square-side) |
Connecting
Click Connect Square → OAuth flow → you're back in Pistonlog with the connection live. See Connecting Square for the full walkthrough.
Disconnecting
Disconnecting revokes the access token in Square and clears the encrypted tokens from Pistonlog's database. After disconnect:
- The "Take payment" button on jobcards no longer offers Square methods
- Any pending Square payments stay in your jobcards as historical records but can't be re-fetched
- You can reconnect at any time — same flow as initial connect
When you might need to reconnect
- You switched Square accounts — different merchant, different setup
- Token revoked on Square's side — rare, but possible if you revoked Pistonlog from your Square dashboard, or if Square invalidated the token for security reasons
- Pistonlog added a new permission requirement — if a future release needs scopes that weren't granted on your original connection, you'd need to reconnect. There's no automatic in-page warning for this today; if a payment action starts failing, reconnecting is a reasonable first step