Square POS Integration

Connect your Square POS system to TypeMenu so that online orders automatically appear in Square. This guide covers setup, how payments work, and troubleshooting.

What the Integration Does

When connected, TypeMenu will:

• Sync orders to Square — every online order placed through your storefront is automatically sent to your Square POS
• Process card payments through Square — customers pay via Square instead of Stripe, keeping all transactions in one place
• Sync order status — when you update an order in Square (e.g. mark as prepared or completed), the status updates in TypeMenu too

Orders still appear in your TypeMenu dashboard as normal. The integration adds them to Square as well, so your POS has a complete picture of all sales.

Requirements

Before connecting, make sure you have:

• A Square account (free to create at squareup.com)
• At least one Square location set up in your Square dashboard
• The POS Integrations feature enabled on your TypeMenu plan

Connecting Square

You can find Square POS in two places:

• App Store — go to Settings > Apps & Integrations and find Square POS in the POS category
• Integrations — if already connected, go to Integrations > Square POS in the sidebar

Step 1: Start the Connection

1. Go to Settings > Apps & Integrations (or Integrations > Square POS if you see it in the sidebar)
2. Find Square POS and click Connect with Square

You will be redirected to Square’s website to authorise the connection.

Step 2: Authorise in Square

1. Log in to your Square account if prompted
2. Review the permissions TypeMenu is requesting
3. Click Allow to authorise the connection

You will be redirected back to TypeMenu.

Step 3: Select a Location

1. You will see a grid of your Square locations with their addresses
2. Select the Square location you want to link with your TypeMenu business
3. Click Activate Integration

Your integration is now active. Card payments switch to Square automatically and online orders will begin syncing to your Square POS.

How Order Sync Works

What Gets Sent to Square

When a customer places an order on your storefront, the following is automatically sent to your Square POS:

• Line items — product names, variants, quantities, and prices
• Modifiers — any extras, toppings, or customisations the customer selected
• Discounts — deals or coupon discounts applied to the order
• Customer details — name, email, and phone number
• Fulfilment type — whether the order is for delivery or collection
• Delivery address — full address for delivery orders
• Fulfilment time — when the order should be ready or delivered
• Item notes — any special requests on individual items

Order Status Sync

When you update an order’s status in Square, the change is reflected in TypeMenu:

Square Status	TypeMenu Status
Reserved	Confirmed
Prepared	Ready
Completed	Completed
Cancelled	Cancelled

This works via webhooks — updates typically appear in TypeMenu within seconds.

How Payments Work with Square

When Square is connected:

• Card payments are processed through Square instead of Stripe
• Stripe is automatically disabled to avoid duplicate payment processing
• Cash payments continue to work as normal

If you disconnect Square later, Stripe will be re-enabled automatically (provided you have a Stripe account set up).

Managing the Integration

Integration Dashboard

Go to Integrations > Square POS in the sidebar to see your integration dashboard. It shows:

• Connection status — whether the integration is active, pending, or disconnected
• Connected location — the Square location name and merchant ID
• Last sync — when the last order was successfully synced to Square
• Test Connection button — verify Square is reachable
• Storefront payments toggle — enable or disable Square payments on your storefront without disconnecting the integration entirely

Testing the Connection

1. Go to Integrations > Square POS in the sidebar
2. Click Test Connection
3. A success or failure message will appear

Use this to check connectivity after setup or if you suspect sync issues.

Enabling/Disabling Storefront Payments

You can turn Square payments on or off for your customer storefront without disconnecting the integration:

• Toggle on: Customers pay via Square at checkout
• Toggle off: Square payments are disabled on the storefront (useful for temporary maintenance)

This does not affect the integration connection itself — orders can still sync, but card payments will not be processed through Square while disabled.

Viewing Sync Status

Each order shows its POS sync status:

• Synced — the order was sent to Square successfully
• Failed — the sync failed (see Troubleshooting below)
• Skipped — the sync was skipped (usually due to repeated failures)
• Pending — the order is waiting to be synced

Menu Mapping (Coming Soon)

A menu mapping feature will allow you to link your TypeMenu products directly to items in your Square catalogue. This improves reporting in Square by attributing sales to the correct catalogue items rather than using product names alone.

Currently, orders sync with your TypeMenu product names and prices, which works well for most businesses. Menu mapping will be an optional enhancement.

Disconnecting Square

1. Go to Integrations > Square POS in the sidebar
2. Click Disconnect
3. Confirm the disconnection

When you disconnect:

• Orders will no longer sync to Square
• If you have a Stripe account, card payments will switch back to Stripe automatically
• Your existing orders in Square are not affected

Troubleshooting

Orders Not Appearing in Square

• Check the sync status on the order in TypeMenu — if it says “Failed”, there may have been a temporary issue
• Test the connection from the Square POS dashboard (Integrations > Square POS)
• If the problem persists, try disconnecting and reconnecting Square

”Connection Lost” or “Authorisation Revoked”

This happens when the Square authorisation is revoked — either from your Square dashboard or by Square itself.

• You will receive a notification explaining what happened
• Card payments will switch back to Stripe automatically if available
• To restore the connection, click Connect Square and go through the authorisation again

Card Payments Not Working After Disconnection

If you disconnect Square and card payments stop working:

• Check that your Stripe account is set up and verified
• Go to Payments and ensure Stripe is showing as active
• If you never set up Stripe, you will need to do so before accepting card payments again

Sync Failures After Multiple Retries

If an order fails to sync after several attempts, you will receive an alert. The order is still recorded in TypeMenu — you may need to enter it manually in Square.

Related Guides

• Payments — payment method setup and management
• Apps & Integrations — other available integrations