TillDocs
IntegrationsSquare

Square

Connect your Square account to Till with one click using OAuth. Get full item-level sales data, categories and payment breakdowns.

Overview

Square is Till's most feature-rich integration. Because Square is a full point-of-sale system, Till can access detailed order data including individual items, categories, modifiers, taxes, discounts, tips and refunds.

Square

Square

OAuth 2.0 · one-click authorisation

Full POS reporting with item-level sales data, categories, modifiers and payment breakdowns.

What Till can access

When you connect Square, Till requests read-only access to:

  • Orders: completed orders with line items, quantities and prices
  • Payments: payment methods, amounts and tender details
  • Merchant profile: your business name and location information
  • Items and catalogue: product names, categories and catalogue structure

Till never modifies your Square account. All access is read-only.

How to connect

Open settings

In the Till app, navigate to Settings then Connections.

Click Connect Square

Click the Connect Square button. You will be redirected to Square's login page.

Sign in to Square

Sign in with your Square account credentials. If you have multiple locations, make sure you are signing in with the correct account.

Authorise Till

Square will show you the permissions Till is requesting:

  • Read orders and transactions
  • Read payment information
  • Read merchant profile
  • Read items and catalogue

Click Allow to grant Till access.

Return to Till

You will be redirected back to Till automatically. Your Square connection status will show as Connected with your business name and location.

Till will begin importing your sales data straight away.

What you will see in Till

Once connected, your sales dashboard will show:

  • Total sales and order count for any date range
  • Average order value and trends over time
  • Sales by hour so you can see your busiest trading periods
  • Top-selling items ranked by revenue or quantity
  • Category breakdown showing which product categories drive revenue
  • Payment method breakdown covering card types, cash and other tenders
  • Refunds and discounts to track returns and promotional impact
  • Tips if your Square account collects tips

Troubleshooting

Connection failed

If you see "Failed to complete authorisation":

  1. Make sure you are signing in with the correct Square account
  2. Check that your Square account is active and in good standing
  3. Try disconnecting and reconnecting from Settings then Connections

Missing data

  • Till only imports completed orders. Pending or cancelled orders are excluded
  • Items without a linked catalogue entry will appear as "Uncategorised"
  • Historical data may take a moment to load for the first time

Disconnecting

To disconnect Square, go to Settings then Connections and click Disconnect next to Square. This revokes Till's access to your Square data. You can reconnect at any time.

Data capabilities

FeatureAvailable
Order-level data
Item-level data
Categories
Refunds
Tips
Tax breakdown
Discounts
Payment methods
Staff attribution
Custom date ranges

Live account access

Till connects to your live Square account using OAuth 2.0 with automatic token refresh, so you should not need to reconnect unless you explicitly revoke access.

Reviewed by Till

Last updated 25 April 2026

Was this page helpful?

We use this to improve the docs.

On this page

Jump to the section you need.

On this page