Square

Overview

Square is a full point-of-sale system. Because Square handles the whole transaction, Tilly can access detailed order data including individual items, categories, modifiers, taxes, discounts, tips and refunds.

What Tilly can access

When you connect Square, Tilly 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

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

How to connect

What you will see in Tilly

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

• Tilly 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 Tilly's access to your Square data. You can reconnect at any time.

Data capabilities

Live account access

Tilly 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.