Àpèjúwe
This plugin allows you to securely accept payments, synchronize sales, and seamlessly manage inventory and product data between WooCommerce and Square POS.
The Square plugin is PCI and SAQ A-level compliant.
Accept payments anywhere, anytime
- The Square plugin extends WooCommerce to allow you to accept payments via Square Ìtumọ̀ Yorùbá: – including support for Apple Pay®, Google Pay, WooCommerce Subscriptions and WooCommerce Pre-Orders.
- Recurring customers can save payment methods and use them at checkout.
- Customize payment forms with automatic formatting, mobile-friendly options, and retina card icons.
Manage your business all in one place
Sync your product and inventory information from WooCommerce to Square, or from Square to WooCommerce — set everything up once, and whenever you make a sale, your inventory automatically updates on both platforms.
- If you sell mainly online, set WooCommerce as your system of record so WooCommerce pushes product name, inventory, prices, categories, and images to Square.
- If you sell in multiple locations and online, set Square as your system of record so Square pushes product name, inventory, prices, categories, and images to WooCommerce.
Ìgbéwọlẹ̀
You can download an older version of this gateway for older versions of WooCommerce from here.
Automatic installation
Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t need to leave your web browser. To automatically install WooCommerce Square, log in to your WordPress dashboard, navigate to the Plugins menu, and click Add New.
In the search field type “WooCommerce Square” and click Search Plugins. Once youÌtumọ̀ Yorùbá: ’ve found our plugin you can install it by clicking Install Now, as well as view details about it such as the point release, rating, and description.
Manual installation
The manual installation method involves downloading our plugin and uploading it to your web server via your favorite FTP application. The WordPress codex contains instructions on how to do this here.
Updating
Automatic updates should work like a charm; as always though, ensure you backup your site just in case.
Note
If running PHP 8.2+, you may see some deprecation notices being logged. These notices are known and do not impact any plugin functionality.
FAQ
-
Does this require an SSL certificate?
-
Yes! An SSL certificate must be installed on your site to use Square.
-
Where can I find documentation?
-
For help setting up and configuring the plugin, please refer to our user guide.
-
Where can I get support or talk to other users?
-
If you get stuck, you can ask for help in the Plugin Forum.
Àwọn àgbéyẹ̀wò
Àwọn Olùkópa & Olùgbéejáde
“WooCommerce Square” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí plugin yìí.
Àwọn OlùkópaA ti túmọ̀ “WooCommerce Square” sí àwọn èdè agbègbè 6. Ọpẹ́lọpẹ́ fún àwọn atúmọ̀ èdè fún àwọn ìkópa wọn.
Túmọ̀ “WooCommerce Square” sí èdè rẹ.
Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè?
Ṣàwárí koodu, ṣàyẹ̀wò ibi ìpamọ́ SVN, tàbí ṣe àgbékalẹ̀ sí àkọsílẹ̀ ìdàgbàsókè nípasẹ̀ RSS.
Àkọsílẹ̀ àwọn àyípadà
5.5.2 Ìtumọ̀ Yorùbá: – 2026-10-15
- Fix Ìtumọ̀ Yorùbá: – Prevent duplicate Square items and categories when a failed sync batch is retried item by item, and stop saving temporary Square IDs on products.
- Fix Ìtumọ̀ Yorùbá: – Checkout with a Square credit card or Cash App Pay no longer fails with a “value too low” error when a WooCommerce gift card covers more than the order subtotal but less than the order total. The remaining balance is now charged.
- Fix Ìtumọ̀ Yorùbá: – Show the current cart total in the Apple Pay sheet on the Cart and Checkout blocks after the cart changes.
- Fix Ìtumọ̀ Yorùbá: – Ensure that the Checkout Block prevents submitting a card payment without a payment token.
- Fix Ìtumọ̀ Yorùbá: – Prevent a connected store from being disconnected after a successful Square access-token refresh.
- Fix Ìtumọ̀ Yorùbá: – Ensure Square digital wallet (Apple Pay / Google Pay) buttons are visible on cart and product pages when the shipping phone field is required.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 11.2.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 11.0.
5.5.1 Ìtumọ̀ Yorùbá: – 2026-09-21
- Fix Ìtumọ̀ Yorùbá: – Improved handling of Apple Pay domain registration on the Square settings screen.
- Fix Ìtumọ̀ Yorùbá: – The domain registered with Square for Apple Pay is now based on the Site Address setting.
5.5.0 Ìtumọ̀ Yorùbá: – 2026-08-31
- Fix Ìtumọ̀ Yorùbá: – Prevent product sync from getting stuck when a product set to sync with Square is deleted.
- Fix Ìtumọ̀ Yorùbá: – Automatically detect and recover a background sync job stuck in processing, unblock the sync queue, show an admin notice prompting a re run, and prune old failed scheduler actions.
- Fix Ìtumọ̀ Yorùbá: – Skip products that Square rejects during a sync instead of failing the whole sync, and report the name, SKU and reason for each skipped product.
- Fix Ìtumọ̀ Yorùbá: – Stop Square inventory pulls from writing zero stock for items Square has no real count for, never change a productÌtumọ̀ Yorùbá: ’s stock management setting on a zero, and honor the per product Sync with Square setting on all automatic pulls.
- Fix Ìtumọ̀ Yorùbá: – Allow “Manage stock” to be changed on a synced product when WooCommerce is the system of record, and keep it read-only when Square is.
- Fix Ìtumọ̀ Yorùbá: – Square inventory sync errors no longer interrupt checkout or refunds for orders paid through other payment gateways.
- Fix Ìtumọ̀ Yorùbá: – Reuse the Square catalog sync idempotency key on an unchanged retry and generate a new one when the request body changes, so a rate limited sync on stores with many categories recovers instead of getting stuck.
- Fix Ìtumọ̀ Yorùbá: – Sync no longer fails when Square already holds an item option whose name differs only by case, or when a store has more than 100 item options.
- Fix Ìtumọ̀ Yorùbá: – Reuse an existing Square item option that differs only by capitalization, so variations use SquareÌtumọ̀ Yorùbá: ’s spelling of the value instead of creating a duplicate option.
- Dev Ìtumọ̀ Yorùbá: – Bump WordPress “Tested up to” to 7.1.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 11.1.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 10.9.
- Dev Ìtumọ̀ Yorùbá: – Update PHP_CodeSniffer to 3.13.6 and WooCommerce Sniffs to 1.0.1.
5.4.3 Ìtumọ̀ Yorùbá: – 2026-08-06
- Fix Ìtumọ̀ Yorùbá: – Hardened validation of guest billing details submitted on the order payment page.
- Dev Ìtumọ̀ Yorùbá: – Update WordPress Coding Standards to 3.4.1.
5.4.2 Ìtumọ̀ Yorùbá: – 2026-07-22
- Update Ìtumọ̀ Yorùbá: – Remove deprecated beta Product Editor (
@woocommerce/product-editor) integration. - Fix Ìtumọ̀ Yorùbá: – Remove obsolete pre-7.6 WooCommerce compatibility code, as the minimum supported WooCommerce version is now 10.7.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 11.0.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 10.8.
- Dev Ìtumọ̀ Yorùbá: – Bump WordPress minimum supported version to 6.9.
5.4.1 Ìtumọ̀ Yorùbá: – 2026-06-24
- Fix Ìtumọ̀ Yorùbá: – Syncing new products to Square no longer leaves them at zero inventory if the sync fails partway through.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 10.9.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 10.7.
5.4.0 Ìtumọ̀ Yorùbá: – 2026-05-28
- Add Ìtumọ̀ Yorùbá: – Register seven read-only abilities with the WordPress Abilities API, gated behind the woocommerce_square_abilities_enabled filter (default off) and the WC 10.9 loader.
- Fix Ìtumọ̀ Yorùbá: – Correct button alignment in the Import Products modal on WP 7.0.
- Fix Ìtumọ̀ Yorùbá: – Allow extending the “Pay for Order” functionality via the WordPress capability system.
- Fix Ìtumọ̀ Yorùbá: – Square product syncs no longer fail entirely when one item has an outdated catalog ID.
- Fix Ìtumọ̀ Yorùbá: – Product categories are updated properly during manual sync.
- Fix Ìtumọ̀ Yorùbá: – Ensure stale category mappings are fully cleaned up when two WooCommerce categories share the same Square category ID.
- Dev Ìtumọ̀ Yorùbá: – Removed stale Action Scheduler DELETE hook from Plugin.php.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 10.8.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 10.6.
5.3.3 Ìtumọ̀ Yorùbá: – 2026-05-07
- Add Ìtumọ̀ Yorùbá: – Admin notice to inform merchants if a successful product sync has not occurred in a while.
- Fix Ìtumọ̀ Yorùbá: – Add SKU-based existence check before creating new Square catalog items to prevent duplicates.
- Fix Ìtumọ̀ Yorùbá: – Skip SKU-based product matching for Square variations with no SKU to prevent unrelated WooCommerce products from being overwritten during sync.
- Fix Ìtumọ̀ Yorùbá: – Push inventory now attempts SKU-based lookup for synced products missing a Square variation ID.
- Fix Ìtumọ̀ Yorùbá: – Syncs no longer crash when encountering certain malformed items in your Square catalog.
- Fix Ìtumọ̀ Yorùbá: – Add safeguard to skip disabling cards on Square when removing tokens from staging/non-production sites.
- Fix Ìtumọ̀ Yorùbá: – Ensure the debug mode admin notice link points to the correct settings page.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 10.7.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 10.5.
5.3.2 Ìtumọ̀ Yorùbá: – 2026-04-06
- Fix Ìtumọ̀ Yorùbá: – Prevent stale Square catalog IDs from breaking checkout while still surfacing genuine coupon redemption failures as checkout errors.
- Fix Ìtumọ̀ Yorùbá: – Ensure that the order note wordings for partial payments are translatable.
- Dev Ìtumọ̀ Yorùbá: – Replace deprecated
wc_enqueue_jswithwp_add_inline_script. - Dev Ìtumọ̀ Yorùbá: – Bump WordPress “Tested up to” to 7.0.
- Dev Ìtumọ̀ Yorùbá: – Bump WordPress minimum supported to 6.8.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 10.4.
5.3.1 Ìtumọ̀ Yorùbá: – 2026-03-26
- Fix Ìtumọ̀ Yorùbá: – Improved reliability when customers change or remove an applied gift card at checkout.
- Fix Ìtumọ̀ Yorùbá: – Improved authorization handling for order-related requests in the payment flow.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 10.6.
5.3.0 Ìtumọ̀ Yorùbá: – 2026-03-05
- Add Ìtumọ̀ Yorùbá: – Initial support for Square Discount Codes (Coupons).
- Fix Ìtumọ̀ Yorùbá: – Set the “Synced with Square” taxonomy to private.
- Fix Ìtumọ̀ Yorùbá: – Ensure that there is no
DivisionByZeroErrorfatal error in Square when the total amount is zero and the tax amount is non-zero. - Fix Ìtumọ̀ Yorùbá: – Partial-Total Verification when Gift Card is used.
- Fix Ìtumọ̀ Yorùbá: – Improved data access restrictions on payment method page.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 10.5.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 10.3.
5.2.0 Ìtumọ̀ Yorùbá: – 2026-01-15
- Add Ìtumọ̀ Yorùbá: – A notice for the inventory sync in bulk edit screen.
- Add Ìtumọ̀ Yorùbá: – Helper text and notices to clarify the difference between “Sync Now” and “Import all Products from Square”.
- Fix Ìtumọ̀ Yorùbá: – Ensure that the order is not marked as ‘On Hold’ when saving the card fails after a successful payment.
- Fix Ìtumọ̀ Yorùbá: – Prevent fatal errors occurring on incompatible environments.
- Fix Ìtumọ̀ Yorùbá: – Ensure default titles are displayed for payment methods if not set by the merchant.
- Fix Ìtumọ̀ Yorùbá: – Prevent images being updated from square when the “Enable to override Product images from Square” setting is turned off.
- Fix Ìtumọ̀ Yorùbá: – Improve sync settings language for better clarity.
- Fix Ìtumọ̀ Yorùbá: – CSV-imported products from Square with inventory tracking disabled are now correctly imported as “In Stock” instead of “Out of Stock” with stock management enabled.
- Fix Ìtumọ̀ Yorùbá: – Resolve fatal errors that may occur after a server migration.
- Dev Ìtumọ̀ Yorùbá: – Update
apimatic/unirest-phppackage to 4.0.7. - Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 10.2.
- Dev Ìtumọ̀ Yorùbá: – Bump WordPress minimum supported version to 6.7.
- Dev Ìtumọ̀ Yorùbá: – Error logging when gift card application fails due to missing session token or Square API errors.
- Dev Ìtumọ̀ Yorùbá: – Remove application of E2E status labels from GitHub actions.
5.1.2 Ìtumọ̀ Yorùbá: – 2025-12-10
- Security Ìtumọ̀ Yorùbá: – Resolve CVE-2025-13457.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 10.4.
- Dev Ìtumọ̀ Yorùbá: – Bump WordPress “tested up to” version 6.9.
5.1.1 Ìtumọ̀ Yorùbá: – 2025-11-03
- Fix Ìtumọ̀ Yorùbá: – Missing attribute names after Product Import.
- Fix Ìtumọ̀ Yorùbá: – Update for PHP 8.4 compatibility.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 10.3.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 10.1.
- Dev Ìtumọ̀ Yorùbá: – Updates to our QIT GitHub Action workflow.
- Dev Ìtumọ̀ Yorùbá: – Add new deploy workflow.
5.1.0 Ìtumọ̀ Yorùbá: – 2025-09-29
- Add Ìtumọ̀ Yorùbá: – Support for multiple categories in WooCommerce-Square product synchronization.
- Add Ìtumọ̀ Yorùbá: – Improve debugging with more options and verbose descriptions.
- Fix Ìtumọ̀ Yorùbá: – Sync only the utilized option values.
- Fix Ìtumọ̀ Yorùbá: – Fatal error when using partial product quantities.
- Fix Ìtumọ̀ Yorùbá: – Ensure the outline is properly visible when the Google Pay button is focused.
- Fix Ìtumọ̀ Yorùbá: – Ensure users are warned that clicking “Buy with GPay” opens in a new window.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 10.2.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 10.0.
5.0.1 Ìtumọ̀ Yorùbá: – 2025-12-10
- Security Ìtumọ̀ Yorùbá: – Resolve CVE-2025-13457 for version 5.0.
5.0.0 Ìtumọ̀ Yorùbá: – 2025-09-10
- Add Ìtumọ̀ Yorùbá: – Order fulfillment sync between WooCommerce and Square orders for those that opt-in.
- Fix Ìtumọ̀ Yorùbá: – Ensure inventory sync isn’t interrupted in case of a category insert failure.
- Fix Ìtumọ̀ Yorùbá: – Accurately count attribute values – 250 values, not characters.
4.9.9 Ìtumọ̀ Yorùbá: – 2025-12-10
- Security Ìtumọ̀ Yorùbá: – Resolve CVE-2025-13457 for version 4.9.
4.9.8 Ìtumọ̀ Yorùbá: – 2025-08-21
- Fix Ìtumọ̀ Yorùbá: – Ensure there is no fatal error on the product page when the product price is blank.
- Fix Ìtumọ̀ Yorùbá: – Corrected variation option assignment logic to prevent mismatched item option IDs during manual syncs to Square.
- Fix Ìtumọ̀ Yorùbá: – Prevent mixing Production tokens when in Sandbox mode.
- Fix Ìtumọ̀ Yorùbá: – Vertical spacing on “Enable Payment Methods” step.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 10.1.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 9.9.
- Dev Ìtumọ̀ Yorùbá: – Bump WordPress minimum supported version to 6.7.
- Dev Ìtumọ̀ Yorùbá: – Update vulnerable NPM packages.
- Dev Ìtumọ̀ Yorùbá: – Remove loading translations, as it is automatically handled by WordPress since version 4.6.
4.9.7 Ìtumọ̀ Yorùbá: – 2025-07-28
- Fix Ìtumọ̀ Yorùbá: – Resolve
CARD_DECLINED_VERIFICATION_REQUIREDerror for 3DS-required credit card payments. - Fix Ìtumọ̀ Yorùbá: – Unblock UI and show a generic error when buyer verification fails.
- Dev Ìtumọ̀ Yorùbá: – Update NPM packages with security issues.
4.9.6 Ìtumọ̀ Yorùbá: – 2025-07-10
- Add Ìtumọ̀ Yorùbá: – When importing products from Square, a new “View Progress” link on the “Update” page allows ability to more closely monitor that progress.
- Fix Ìtumọ̀ Yorùbá: – Ensure that Digital Wallet payment methods and Cash App Pay function properly in Block Checkout when using Safari.
- Fix Ìtumọ̀ Yorùbá: – Prevent the “Sync with Square” setting from getting unchecked.
4.9.5 Ìtumọ̀ Yorùbá: – 2025-06-30
- Fix Ìtumọ̀ Yorùbá: – Ensure the customer is created on the Square side without errors when adding a payment method.
- Fix Ìtumọ̀ Yorùbá: – Ensure that the request body is correctly logged in the debug logs.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 10.0.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 9.8.
4.9.4 Ìtumọ̀ Yorùbá: – 2025-06-13
- Fix Ìtumọ̀ Yorùbá: – Ensure no fatal error occurs at checkout when using a free local pickup shipping method.
4.9.3 Ìtumọ̀ Yorùbá: – 2025-06-09
- Add Ìtumọ̀ Yorùbá: – Support for SquareÌtumọ̀ Yorùbá: ’s EMV 3-D Secure authentication flow to comply with countries that have 3DS mandates and improve payment security.
- Add Ìtumọ̀ Yorùbá: – Pre-sync validations for Product Variations.
- Add Ìtumọ̀ Yorùbá: – Digit handling for country-specific currencies to prevent incorrect division by 100 for currencies like Japanese Yen.
- Add Ìtumọ̀ Yorùbá: – Indicate customer initiated payments in Square API requests.
- Fix Ìtumọ̀ Yorùbá: – Only sync attributes used for variations to Square, preventing item option mismatch errors when WooCommerce products have unused attributes.
- Fix Ìtumọ̀ Yorùbá: – Ensure consistent error messages between the Block Checkout and the Shortcode Checkout.
- Dev Ìtumọ̀ Yorùbá: – Bump Square PHP SDK version from
35.1.0.20240320to40.0.0.20250123.
4.9.2 Ìtumọ̀ Yorùbá: – 2025-05-27
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 9.9.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 9.7.
4.9.1 Ìtumọ̀ Yorùbá: – 2025-05-05
- Add Ìtumọ̀ Yorùbá: – Set the onboarding URL for the “Complete setup” button on the new payment settings page.
- Change Ìtumọ̀ Yorùbá: – Remove the
wc_square_update_product_set_variation_namefilter. - Fix Ìtumọ̀ Yorùbá: – Issue with Product Price override update logic.
- Fix Ìtumọ̀ Yorùbá: – Show detailed error messages on Checkout Page based on Debug Mode settings.
- Fix Ìtumọ̀ Yorùbá: – Ensure that debug logs for payment gateways are being generated as expected.
- Dev Ìtumọ̀ Yorùbá: – Add in performance logging during the checkout process.
- Dev Ìtumọ̀ Yorùbá: – Update E2E tests to accommodate payment modernization changes in WooCommerce Core.
4.9.0 Ìtumọ̀ Yorùbá: – 2025-04-07
- Add Ìtumọ̀ Yorùbá: – Support for syncing multiple Product Variations.
- Add Ìtumọ̀ Yorùbá: – Support for WooCommerceÌtumọ̀ Yorùbá: ’s new Email Improvements feature.
- Fix Ìtumọ̀ Yorùbá: – Digital Wallets and Cash App payment issues in Woo 9.8.
- Fix Ìtumọ̀ Yorùbá: – Deprecated PHP error for Gift Cards.
- Fix Ìtumọ̀ Yorùbá: – jQuery error on Cart & Checkout pages when a Subscription product is added to the cart, as Digital Wallets cannot be used for Subscription products.
- Fix Ìtumọ̀ Yorùbá: – Remove duplicate onboarding notice.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce “tested up to” version 9.8.
- Dev Ìtumọ̀ Yorùbá: – Bump WooCommerce minimum supported version to 9.6.
- Dev Ìtumọ̀ Yorùbá: – Bump WordPress minimum supported version to 6.6.
- Dev Ìtumọ̀ Yorùbá: – Bump WordPress “tested up to” version 6.8.
- Dev Ìtumọ̀ Yorùbá: – Updates to E2E tests setup.
- Dev Ìtumọ̀ Yorùbá: – Update all third-party actions our workflows rely on to use versions based on specific commit hashes.


