POS integrations

POS integrations connect SupaOrder to the point-of-sale system you already run — Clover, Square, or Toast — so online orders flow into your POS automatically and your team works from one screen. Connecting is a guided account-link flow in the admin dashboard with a built-in connection test, and an integration health indicator tells you immediately if the link ever needs attention.

Why connect your POS

One screen for staff. Online orders appear in the POS alongside walk-in sales — no second tablet to watch, no re-typing orders.
One sales record. End-of-day totals in your POS include online sales.
Kitchen routing you already have. If your POS drives kitchen printers or displays, online orders ride the same rails.

Orders still appear in the partner app too — the POS copy is in addition, not instead. You can run both views or let staff live entirely in the POS.

Supported systems

POS	Orders sync	Notes
Clover	Yes
Square	Yes	Connects via a secure Square sign-in popup
Toast	Yes

Menu and price syncing varies by provider — what can be pushed or matched between SupaOrder and the POS depends on what each system exposes. Your SupaOrder account manager can confirm the current capabilities for your specific POS before you commit to a workflow.

Connecting a POS

Before you start, have ready:

The login credentials for your POS account (the connect step signs into it).
A quiet moment outside service hours — you’ll want to place a test order afterwards.

Then:

Open Dashboard → Settings → Integration → Plugin List (/configuration/integrations/integration/plugin-list) and pick your POS from the available integrations.
Fill in the integration form — a name for the integration, its type, priority, and any conditions that control when it applies.
Complete the provider-specific connection step. For Square, this is an OAuth popup: log into your Square account when prompted and authorize the connection. Other providers have their own connect step on the same form.
Save, then run the Test Connection action to confirm the link works before relying on it during service.

Once configured, the integration appears under Plugin Config (/configuration/integrations/integration/list), where you can edit, test, or disable it later.

How orders sync

When an order is placed in SupaOrder, it’s sent to the connected POS automatically. The order keeps progressing through its normal lifecycle in SupaOrder regardless — the POS copy is for your staff’s workflow, not a dependency for the customer’s experience.

What stays in SupaOrder

The POS shows the order; SupaOrder still runs it. Keep doing these in the partner app or dashboard, not the POS:

Order status updates — accepting, marking ready, completing. Customers are notified from SupaOrder’s statuses, so updating only the POS leaves them in the dark.
Order edits and refunds and cancellations — these must happen in SupaOrder so payments and customer notifications stay correct.
Menu changes and availability — manage them in SupaOrder (see Building your menu); whether they flow to the POS depends on the provider’s sync capabilities.

Running more than one integration

The integration form’s priority and conditions fields control when each integration applies — useful if different outlets use different POS systems. Keep one clearly-named integration per POS account, and disable (rather than delete) one you’re pausing, so its configuration survives.

Health monitoring

Each configured integration has a health indicator so a broken link surfaces instead of silently dropping orders — for example, if the POS credentials expire or the provider rejects requests. When health shows a problem:

Open the integration under Plugin Config.
Run Test Connection to confirm the failure.
Re-run the connection step (e.g. log into the POS account again) and re-test.

Troubleshooting

Symptom	Try this
Connection popup doesn’t open or appears blank	Allow popups for the dashboard in your browser; make sure you can log into the POS account directly first, then retry
Test Connection fails after it used to work	The POS credentials or authorization likely expired — redo the connect step from Plugin Config
Orders not appearing in the POS	Check the integration’s health indicator and run Test Connection; confirm the integration is enabled and its conditions match the orders you expect
Order arrives in the POS but looks wrong	Note exactly what differs (items, prices, modifiers) and contact SupaOrder support — provider-specific mapping may need adjustment
Unsure whether your POS supports menu sync	Ask your SupaOrder account manager — capabilities differ per provider