Steadysync – Inventory Sync for Square

Description

Steadysync keeps your WooCommerce store in sync with your Square catalog and inventory. It is built around one idea: a sync should never destroy data. An empty, partial or non-numeric stock update is rejected instead of being written, so your WooCommerce stock is never silently set to 0.

The plugin connects to your Square account, imports your catalog and keeps stock levels up to date in real time using Square webhooks. Before anything is written you can run a dry-run preview that shows exactly which catalog and stock changes a sync would make.

What it does

• Square → WooCommerce inventory sync for the selected Square location, with an anti-zeroing guard: empty, partial or non-numeric quantities are rejected and never applied as 0.
• Catalog import — product name, description, price, SKU and the item image are imported from Square. Simple and variable products are supported. Images are only re-downloaded when the Square image actually changes, so repeated syncs do not bloat your media library.
• Real-time updates via Square webhooks — incoming events are HMAC signature-verified and de-duplicated so the same event is never applied twice.
• Secure Square connection — connect a sandbox access token, or connect a production account via OAuth. Tokens are stored encrypted (AES-256-GCM) and refreshed automatically before they expire.
• Dry-run preview — compute the catalog and stock changes a sync would make, without writing anything.
• Timeout-safe batch import — large catalogs are imported one page per background run, so imports do not time out.
• Health monitor — an hourly connection check with an admin panel and an optional email alert on persistent errors.
• WP-CLI — wp steadysync status, preview, catalog_sync, sync_start, sync_status, sync_cancel.

Extended features (separate add-on)

Two-way sync and migration are available through Steadysync Pro, a separate add-on distributed at steadysync.net and not hosted here: WooCommerce → Square push (inventory, catalog and images), order/refund sync as Square ledger adjustments, multi-location stock aggregation and a one-click import of an existing Square product mapping. The add-on is optional; this plugin is fully functional on its own.

Trademarks

Square is a trademark of Block, Inc. WooCommerce is a trademark of Automattic Inc. Steadysync is an independent, unofficial plugin and is not affiliated with, endorsed by or sponsored by Block, Inc. or Automattic Inc. These names are used only to describe compatibility.

External services

This plugin connects to the Square API (provided by Block, Inc.). Square is required for the plugin to work: it is the source of the catalog and inventory data that the plugin imports into WooCommerce, and the connection that lets your store stay in sync with your Square account.

What the plugin sends to Square and when:

• When you connect your account (OAuth authorization and token exchange, or when you save a sandbox access token) and when your stored token is automatically refreshed: your Square application credentials and OAuth/refresh tokens are exchanged with Square.
• When you test the connection or load your locations: an authenticated request is sent to Square to list your business locations.
• On every catalog import, dry-run preview and inventory read (manually, on a schedule, or when a Square webhook is received): authenticated requests are sent to Square to read catalog objects and inventory counts. These requests contain your access token and the catalog/location identifiers being queried; no WooCommerce customer data is sent.
• Product images shown in Square are downloaded from Square-hosted image URLs during catalog import.

The plugin also receives webhook notifications from Square at a REST endpoint it registers (/wp-json/steadysync/v1/square-webhook); those requests are verified with the HMAC signature key from your Square webhook subscription.

Square’s terms and privacy policy:

• Square Terms of Service: https://squareup.com/us/en/legal/general/ua
• Square Privacy Notice: https://squareup.com/us/en/legal/general/privacy