Square Integration

Square Integration

Connect your Square store and sync orders and inventory automatically

Connect your Square account to OmniOrders and manage everything from one place. Whether you sell online, in-person, or both, your products, orders, and inventory will sync automatically—no more manual updates or switching between platforms.

Quick Setup

Most Square accounts connect in under 5 minutes. You’ll need access to your Square Developer Dashboard to authorize the connection.

---

Why Connect Square?

Connecting Square to OmniOrders means orders from your Square Online Store and POS flow into OmniOrders automatically, inventory stays in sync across all your channels, and fulfillment updates push back to Square the moment they happen — no manual imports, no overselling, and no switching between systems.

Auto Sync Orders

Orders from Square Online and in-person sales flow directly into OmniOrders—no delays or manual imports needed.

Real-Time Inventory

Stock levels update automatically across Square and all your other channels. This prevents overselling.

Product Updates

Add or edit products in one place and changes sync everywhere instantly.

Tracking Updates

Shipping info and tracking numbers automatically update in Square when orders ship.

---

Before You Start

Gather these items before connecting—they make setup faster and smoother:

Square Account

You need an active Square account with access to the Square Developer Dashboard. Business owners and admins can authorize integrations.

Square Application

Create an application in the Square Developer Dashboard if you haven’t already. OmniOrders will use OAuth to connect securely.

Products Ready to Sync

Create at least one catalog item in Square before connecting. This lets you verify the sync works correctly right after setup.

---

Connect Your Square Account

1. Go to Integrations

   In OmniOrders, click Integrations in the main menu, then click Add Integration

2. Select Square

   Find Square in the list and click the Configure button

3. Authorize Access

   You’ll be redirected to Square. Sign in and review the permissions, then click Allow to authorize OmniOrders

   What We Access

   OmniOrders only requests access to catalog items, orders, and inventory—we never access payment details or customer payment info.

4. Choose Location

   Select which Square location(s) to sync. If you have multiple locations, you can connect them one at a time or map them to OmniOrders warehouses.

5. Configure Settings

   Back in OmniOrders, choose what to sync:

   • Products: Sync your Square catalog
   • Orders: Import new orders automatically
   • Inventory: Keep stock levels in sync
   • Fulfillment: Send tracking info back to Square

6. Start Sync

   Click Start Sync to begin importing your data. This may take a few minutes depending on your catalog size.

First Sync

The first sync imports your existing catalog items and recent orders. After that, everything updates in real-time.

---

What Gets Synced?

The Square integration syncs catalog items (names, SKUs, variants, images, pricing, inventory quantities), orders (line items, customer addresses, notes, payment and fulfillment status), and inventory updates — bidirectionally, so changes in either Square or OmniOrders reflect on both sides in real time.

Products

• Catalog item names and descriptions
• SKUs and barcodes
• Item variations (sizes, colors, etc.)
• Images and pricing
• Inventory quantities

Orders

• Order details and line items
• Customer shipping addresses
• Order notes and custom attributes
• Payment status
• Fulfillment status

Inventory

• Stock levels by location
• Inventory updates (both directions)
• Low stock alerts

Fulfillment

• Tracking numbers
• Carrier information
• Shipment status updates

---

Managing Your Connection

View Sync Status

Check if everything is syncing correctly:

1. Go to Integrations → Square
2. View the sync dashboard showing:
   • Last sync time
   • Products synced
   • Orders synced
   • Any errors or warnings

Pause Syncing

Need to temporarily stop syncing?

1. Open your Square integration settings
2. Toggle Sync Active to OFF
3. Syncing stops immediately (you can resume anytime)

Update Settings

Change what syncs:

1. Click Settings on your Square integration
2. Toggle any sync option on/off
3. Click Save Changes

---

Common Questions

How often does it sync?

Orders sync instantly when created. Products and inventory sync every 5 minutes or when you make changes.

Can I sync multiple locations?

Yes! Connect each Square location separately. Map them to OmniOrders warehouses for accurate inventory routing.

What about in-person sales?

Orders from Square POS and Square Online both sync to OmniOrders. Fulfillment updates apply to both.

Is my data secure?

Absolutely. We use OAuth 2.0 secure authentication and encrypt all data in transit and at rest.

---

Troubleshooting

Orders Not Syncing

Problem: New Square orders aren’t appearing in OmniOrders

Solutions:

• Check that Order Sync is enabled in integration settings
• Verify the order status—only paid orders sync by default
• Look for error messages in the sync log
• Try clicking Force Sync to trigger a manual refresh

Inventory Not Updating

Problem: Stock changes in Square don’t update in OmniOrders (or vice versa)

Solutions:

• Confirm Inventory Sync is turned on
• Check if catalog items are mapped correctly (same SKU in both systems)
• Verify inventory tracking is enabled in Square for the item
• Allow up to 5 minutes for updates to sync

Connection Expired

Problem: Square integration shows “Connection Expired” error

Solutions:

• Click Reconnect and authorize access again
• This happens if you revoked app access in Square or changed permissions
• No data is lost—syncing resumes immediately after reconnecting

---

Best Practices

For New Users

1. Start Small: Connect your Square account and let the initial sync complete before making changes
2. Test First: Create a test order in Square and verify it appears in OmniOrders
3. Map Locations: If you have multiple Square locations, map them to OmniOrders warehouses for accurate inventory

For Multi-Channel Sellers

1. Centralize Inventory: Let OmniOrders be your source of truth for stock levels
2. Use SKUs: Keep SKUs consistent across all platforms for automatic matching
3. Set Buffer Stock: Configure safety stock levels to prevent overselling across channels

For Order Fulfillment

1. Enable Auto-Fulfillment: Let OmniOrders automatically fulfill orders when ready
2. Sync Tracking: Turn on tracking sync so customers get updates in Square
3. Use Order Notes: Add notes in Square that help with fulfillment routing in OmniOrders

---

Need More Help?

Contact Support

Our team is here to help with setup, troubleshooting, or any questions. Get Support →

Square Developer Docs

Learn more about Square’s API and catalog structure. Square Developer →

More Integrations

Explore other platforms and integration options. View Integrations →

---

Pro Tip

If you sell both online and in-person with Square, connect your Square Online Store first. Then add POS locations to sync inventory across all sales channels.