Square + Adobe Commerce (Magento 2) integration

Vendor pluginLast verified 2026-09-12 · Reviewed by a person 2026-09-24

Yes. Square publishes and maintains its own free extension for Magento 2 and Adobe Commerce (square/module-squareup-omni) on the Adobe Commerce Marketplace. It is at version 1.19.0 (updated 29 December 2025) and covers payments plus catalog, inventory and customer sync. Webkul sells a paid, payments-only alternative.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 Adobe Commerce (Magento 2) integration itself has not been run.

Sources checked: 17 claims from 5 sites, listed at the foot of the page.

Connects through Marketplace extension installed with Composer (square/module-squareup-omni); Square-hosted card form plus express wallet buttons. Biggest gotcha: Square's two pages disagree on dates and countries.

How it connects

Method
Marketplace extension installed with Composer (square/module-squareup-omni); Square-hosted card form plus express wallet buttons1
Maintained by
Square1
Cost of the integration
Free, per the Adobe Commerce Marketplace listing (Apache License 2.0). Square's own processing fees apply separately.1
Latest release
2025-12-291
Requires
2.41
Checkout modes
embedded card form, express checkout wallets, admin order, square terminal1

What works on this platform

Yes: a source confirms it on this integration. Limited: supported, but only under meaningful conditions or through a subset of connector paths. 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
CardsYes1Card payments through a Square-hosted iframe, with Authorize Only or Authorize and Capture as the payment action.
Apple PayYes1You have to register and verify the store domain in the Square Developer Console before Apple Pay works.
Google PayYes1Listed as a checkout and express-checkout method.
ACH bank paymentsYes1ACH bank transfer is listed as a payment method; release 1.19.0 reworked the ACH integration.
Buy now, pay laterYes1Afterpay, added in release 1.14.0 and available in express checkout.
3-D SecureYes13D Secure / SCA is switched on under Stores > Configuration > Sales > 3D Secure; release 1.12.0 made it possible to turn off.
Saved cards (vault)Limited2Customers can save cards when card-on-file is enabled, but not on admin-created orders or while 3DS is enabled.
SubscriptionsYes1Subscription plans are billed through Square invoices, and each paid invoice creates a Magento order.
Partial refundsYes1Refunds run from Magento credit memos; release 1.14.3 fixed orders refunded in two or more partial refunds.
Multi-currencyNo3Square charges in the seller location's single currency; release 1.16.0 fixed amounts when base and display currencies differ.
Network tokensNot verified here4Square 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 a Square application in the Developer Console to get Sandbox credentials. Enter them in the extension's Square configuration (Stores > Configuration > Square), pick a location and complete the OAuth token step. Sandbox v2 has been supported since release 1.5.0, and gift cards since 1.8.0. Apple Pay needs its own domain registration in Sandbox and in production over HTTPS (localhost does not work), and Apple Pay rejects Sandbox test cards, so test it with a real wallet card. Webhooks need a public HTTPS URL. Sync jobs run on cron, mostly twice an hour, so run cron or wait before asserting on catalog, inventory, customer or transaction sync. For payments, check the order status (Processing, and whether the amount was authorized or captured), a void on cancel under Authorize Only, and credit-memo refunds showing in the Square Dashboard.1

UAT-Ops runs integration flows like this against the real sandbox and keeps the evidence. Get one email when it opens.

Gotchas

Square's two pages disagree on dates and countries

The Adobe Marketplace listing shows version 1.19.0 updated on 29 December 2025 and limits availability to the US, Canada, the UK, Australia and Japan. Square's own App Marketplace page was last updated on 7 February 2024 and lists eight countries, adding Spain, France and Ireland. Before promising support in Ireland, France or Spain, confirm it with Square and check the Adobe release notes, not the Square page.

Source: squareup.com7

CSP restrict mode can break the card form

From 2.4.7, Adobe runs CSP in restrict mode on payment pages. Inline scripts that are not whitelisted get blocked, and the payment methods can quietly disappear. Patch releases of 2.4.4 to 2.4.6 are affected too. Square added CSP enforcement compatibility in extension 1.18.0 for 2.4.6-p6+ and 2.4.7-p1+, so an older copy of the module on a patched store is a likely cause of a blank checkout.

Source: experienceleague.adobe.com8

Saved cards stop working when 3DS is on

Square's user guide says customers cannot store a card while 3DS is enabled, and cannot use a stored card on orders created in the Magento Admin. Merchants in regions where SCA is required have to choose between buyer verification and card-on-file convenience. Test both settings before launch, not just the default.

Source: commercemarketplace.adobe.com2

Sync runs on cron, and so does the token refresh

Catalog, inventory, customer, transaction and refund sync run as Magento cron jobs, mostly twice an hour, and the OAuth token is refreshed once a day at 4 am. If Magento cron is not running, stock goes stale and the token eventually expires. Release notes list token-renewal fixes in 1.13.2 and 1.16.2.

Source: commercemarketplace.adobe.com2

Order totals can differ between Magento and Square

Release notes return again and again to amounts that do not match between the two systems. Version 1.19.0 fixed tax being calculated on the discounted price regardless of Magento's tax settings, plus rounding on fractional quantities. Version 1.16.0 fixed stores whose base and display currencies differ. Reconcile a sample of orders after every upgrade.

Source: commercemarketplace.adobe.com1

Alternatives

Other gateways on Adobe Commerce (Magento 2)

Square on other platforms

Sources

  1. https://commercemarketplace.adobe.com/square-module-squareup-omni.htmlmarketplace listing, changelog · describes the connector · checked 2026-09-11
  2. https://commercemarketplace.adobe.com/media/catalog/product/square-module-squareup-omni-1-19-0-ce/user_guides.pdfofficial documentation · describes the connector · checked 2026-09-11
  3. https://developer.squareup.com/docs/international-development/paymentsofficial documentation · describes the gateway · checked 2026-09-12
  4. https://developer.squareup.com/docs/cards-api/overviewofficial documentation · checked 2026-09-11
  5. https://developer.squareup.com/docs/devtools/sandbox/overviewofficial documentation · checked 2026-09-11
  6. https://developer.squareup.com/docs/devtools/sandbox/paymentsofficial documentation · checked 2026-09-11
  7. https://squareup.com/us/en/app-marketplace/app/magento
  8. https://experienceleague.adobe.com/en/docs/commerce-knowledge-base/kb/troubleshooting/payments/storefront-checkout-page-in-csp-restricted-mode

Last verified 2026-09-12 · Reviewed by a person 2026-09-24

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.