Square + WooCommerce integration

Official pluginLast verified 2026-09-13 · Reviewed by a person 2026-09-14

Yes. Square connects to WooCommerce through the free WooCommerce Square extension, which Woo (Automattic) builds and maintains, not Square. It takes card, wallet and Cash App Pay payments and syncs products and stock with Square POS on a schedule, in one direction you choose.1

UAT-Ops testing: Square's sandbox was verified by UAT-Ops on 2026-09-11 with the directory's card flow (6 passed) → evidence on the Square hub. The WooCommerce integration itself has not been run.

Sources checked: 15 claims from 4 sites, listed at the foot of the page.

Connects through Free extension (WooCommerce Square / Square for WooCommerce) installed from WordPress.org or the WooCommerce Marketplace; production connects with Square OAuth, sandbox takes a pasted Application ID and access token. Biggest gotcha: Woo maintains it, and the listings disagree on minimums.

How it connects

Method
Free extension (WooCommerce Square / Square for WooCommerce) installed from WordPress.org or the WooCommerce Marketplace; production connects with Square OAuth, sandbox takes a pasted Application ID and access token.2
Maintained by
Woo (Automattic)1
Cost of the integration
free2
Latest release
2026-08-311
Requires
WooCommerce 10.9 per WordPress.org (10.8 per the Woo Marketplace); WordPress 6.9; PHP 7.41
Checkout modes
block checkout, classic checkout2

What works on this platform

Yes: a source confirms it on this integration. Not verified here: the gateway supports it, but no source confirms this integration exposes it. No: not available. A capability with no source either way is left off.

CapabilityOn this integrationNotes
CardsYes1Credit and debit cards through the Square payment form, with 3-D Secure.
Apple PayYes1In US, UK, CA, IE, FR, ES and AU only (USD, GBP, CAD, EUR, AUD); needs the domain association file to verify.
Google PayYes1Same country and currency list as Apple Pay; the button appears only when the shopper has a saved Google Pay method.
3-D SecureYes1The WordPress.org listing lists 3D Secure authentication; the sandbox SCA flow uses an SMS verification code.
SubscriptionsYes3Works with the separate WooCommerce Subscriptions and Pre-Orders extensions; relies on Square Customer Profiles to store cards.
Saved cards (vault)Yes4Cards can be stored for recurring payments through Square Customer Profiles.
Partial refundsYes5Full and partial refunds are issued from WooCommerce and processed through Square. An authorized-but-uncaptured order is captured first (set it to Processing); refunding it uncaptured cancels the authorization instead.
Multi-currencyNo6The WooCommerce store currency must match the Square account currency, and only one Square location links to a store.
ACH bank paymentsNot verified here7Square supports this; no source confirms it on this integration.
Buy now, pay laterNot verified here7Square supports this (afterpay, clearpay); no source confirms it on this integration.
Network tokensNot verified here8Square supports this; no source confirms it on this integration.

Capability status reflects the integration and documentation available at the time of verification, not necessarily every capability of the underlying gateway or platform.

Testing it

Create an application in the Square Developer Dashboard, copy the Sandbox Application ID and Sandbox access token from its Credentials tab, pick Sandbox under WooCommerce > Settings > Square, paste both, save, then choose a test business location. Pay with Square's sandbox test cards (future expiry; postal code required for USD, CAD and GBP, not for Japan). The only sandbox gift card is 7783 3200 0000 0000 with a $1.00 balance, and it tests full payment only. For Apple Pay, add the store domain in the Square app's Apple Pay settings. Sync and order status runs on Action Scheduler rather than inbound webhooks, so a dev store with no public URL still works. Check WooCommerce > Status > Scheduled Actions for wc_square_sync jobs, and check that Square orders set to Completed or Cancelled flow back to WooCommerce within the 15-minute polling interval.9

UAT-Ops runs integration flows like this against the real sandbox and keeps the evidence. Tell me when it opens

Gotchas

Woo maintains it, and the listings disagree on minimums

The extension is built by Woo (Automattic), not Square, so support and bug reports go to Woo. Its own pages don't agree on the minimum WooCommerce version. On 2026-09-11 WordPress.org listed WooCommerce 10.9 and WordPress tested to 7.1. The Woo Marketplace said WooCommerce 10.8, tested with WordPress 7.0. The setup guide still said WordPress 5.8 and WooCommerce 9.4. Plan upgrades against the WordPress.org header, the strictest of the three.

Source: wordpress.org1

Pick one system of record before the first sync

In Sync Settings, either WooCommerce or Square owns names, prices, descriptions, images, categories and stock. Products match by SKU, and items without a unique SKU in Square are skipped on import. When Square owns inventory, the scheduled check overwrites stock you edit by hand in WooCommerce, so an admin correction can disappear an hour later.

Source: woocommerce.com11

Sync is polled, not pushed

Stock from in-person POS sales arrives on the hourly product sync. Order status is polled every 15 minutes, and only Completed or Cancelled Square orders flow back. Everything runs on Action Scheduler, so if WP-Cron or background processing is off, sync stops quietly. Shortening the interval with a filter has no effect until you cancel the existing wc_square_sync actions.

Source: woocommerce.com9

One currency, one location

The WooCommerce store currency has to match the Square account's currency, and a store links to a single Square location. Only that location's products and stock sync. A multi-currency or multi-region store needs a separate Square account and store per currency.

Source: woocommerce.com6

Gift cards don't work in the block checkout

Square gift cards are not supported in the Cart and Checkout blocks, which have been the default for new stores since WooCommerce 8.3. A block-checkout store that promises gift card redemption either has to switch back to the classic shortcode checkout or drop the feature. There is also a limit of one gift card per order.

Source: woocommerce.com12

Alternatives

Other gateways on WooCommerce

Square on other platforms

  • Wix
  • BigCommerce
  • Adobe Commerce (Magento 2)

Sources

  1. https://wordpress.org/plugins/woocommerce-square/marketplace listing · describes the connector · checked 2026-09-11
  2. https://woocommerce.com/products/square/marketplace listing · describes the connector · checked 2026-09-11
  3. https://squareup.com/app-marketplace/app/woocommercepartner directory · describes this integration · checked 2026-09-11
  4. https://woocommerce.com/document/woocommerce-square/faq/official documentation · describes this integration · checked 2026-09-11
  5. https://woocommerce.com/document/woocommerce-square/administrator-experience-with-the-square-woocommerce-extension/official documentation · describes this integration · checked 2026-09-13
  6. https://woocommerce.com/document/woocommerce-square/setup-and-configuration-of-the-woocommerce-square/official documentation · describes this integration · checked 2026-09-11
  7. https://developer.squareup.com/docs/devtools/sandbox/paymentsofficial documentation · checked 2026-09-11
  8. https://developer.squareup.com/docs/cards-api/overviewofficial documentation · checked 2026-09-11
  9. https://woocommerce.com/document/woocommerce-square/customizing-woocommerce-square-extension/official documentation · describes this integration · checked 2026-09-11
  10. https://developer.squareup.com/docs/devtools/sandbox/overviewofficial documentation · checked 2026-09-11
  11. https://woocommerce.com/document/woocommerce-square/sync-settings/
  12. https://woocommerce.com/document/woocommerce-square/payment-settings/gift-cards-via-woocommerce-square/

Last verified 2026-09-13 · Reviewed by a person 2026-09-14

Integration capabilities, requirements, pricing, availability, and vendor policies may change over time. UAT-Ops documents information based on the authoritative sources and testing available at the time of review.

Where newer information, testing, or vendor documentation materially changes a published claim, UAT-Ops may revise the page to reflect the most current verified information. Readers should confirm time-sensitive requirements with the relevant vendor before making production or purchasing decisions.