Originally published: November 18, 2021 · Last updated: August 17, 2026
If you already use WooCommerce and Square, the official WooCommerce Square extension is the most direct way to connect online payments with your Square account. It can act as a payment gateway, synchronize products and inventory, or do both depending on how your store is managed.
Decide whether you need payments, synchronization or both
A business that only wants to accept Square at WooCommerce checkout may not need product synchronization. A retailer using Square in a physical location may benefit from keeping inventory aligned between the point of sale and the online store.
Configure only the functions you need. Synchronization adds operational consequences that a payment-only setup does not have.
Check the requirements first
WooCommerce’s current documentation requires an active Square account, SSL for payment processing and a compatible WordPress, WooCommerce and PHP environment. Square payments are available only in supported countries and the WooCommerce store currency must match the Square account currency.
Verify the current requirements before installation because payment integrations change more frequently than a normal content plugin.
Connect the Square account
After installing the WooCommerce Square extension, connect it from the WooCommerce Square settings. The authorization process sends you to Square to grant the required access and then returns you to WordPress.
The Square account owner must authorize the connection. Choose the correct Square business location if the account contains more than one.
Choose the source of truth for products
This is one of the most important decisions in the setup. WooCommerce Square can synchronize catalog and inventory data, but you need to know which platform is authoritative.
If Square is your source of truth, product information managed there can overwrite corresponding WooCommerce data during synchronization. If WooCommerce is the main catalog, configure the sync direction accordingly.
Do not edit the same product independently in both systems and assume the integration will know which version you meant to keep.
Configure payment methods
WooCommerce Square can support card payments and, depending on location and configuration, additional methods such as Apple Pay, Google Pay, Square Gift Cards and Cash App Pay.
Enable only the methods your store can support and test how they appear on desktop and mobile checkout.
Use Sandbox before accepting live payments
The integration provides a sandbox environment for testing without processing real transactions. Use it to verify connection, checkout behavior and error handling before switching the store to production.
For an existing live shop, test changes on staging when practical, but remember that payment and account credentials must be handled carefully in copied environments.
Test synchronization separately from checkout
If you enable product or inventory sync, create a small controlled test before applying it to an established catalog. Check product matching, SKUs, inventory updates and the behavior of images, categories and variations.
The official documentation describes the fields that synchronize and the fields that do not. Do not assume every WooCommerce property has a Square equivalent.
Plan refunds and order operations
After a Square payment, WooCommerce stores Square transaction information with the order. Test the normal operational workflows your team will use, including refunds, failed payments and order-status changes.
A payment gateway is successful only when the back-office workflow is understandable after the customer has paid.
A practical setup sequence
- Confirm Square country, currency and account requirements.
- Back up the WordPress store.
- Install the official WooCommerce Square extension.
- Connect the correct Square account and location.
- Decide whether payments, sync or both are required.
- Define which platform owns product data.
- Test in Sandbox.
- Test a small synchronization set if sync is enabled.
- Run a complete checkout, refund and failure test.
- Document the operational workflow before going live.
The practical rule
Treat Square integration as a business-system connection, not simply another checkout button. Decide where product data is managed, test payments and synchronization independently, and keep the configuration simple enough that the person running the store understands what each system will overwrite.
Official references: WooCommerce Square documentation, WooCommerce Square setup and WooCommerce Square synchronization.