Square Gateway for Magento 2

Key Features

Native Square payment method built on Magento's Payment Gateway command framework (CommandPool, ValidatorPool, request/response builders wired via di.xml)

Card payments plus Apple Pay and Google Pay via the Square Web Payments SDK, tokenized client-side (SAQ A-EQ scope)

Unified online + Square POS payments so both channels post to the same Magento order and Square dashboard

Two-way inventory and catalog sync between Magento (MSI source items) and Square via cron and webhooks

Tokenized stored cards using Square's Cards API for returning customers and faster checkout

Full refund and partial refund support tied to Magento credit memos, plus dispute/chargeback status sync

Webhook listener controller with x-square-hmacsha256-signature verification for real-time reconciliation

Authorize/capture/sale/void mapped to Magento's standard invoice and order lifecycle

Admin ACL-gated configuration: sandbox/production toggle, application ID, access token, location ID, payment action

REST and GraphQL API coverage for headless, PWA Studio and mobile checkout flows

Scheduled cron reconciliation job with retry and idempotency keys to prevent double-charges

Detailed gateway request/response logging (token-redacted) for debugging and audit

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

You order

Start with a one-time build price. We scope it with you at kickoff.

We build & install

ECOSIRE builds, configures and installs it on your Magento 2.

Go live + support

You go live in about 2–4 weeks, with a post-launch support window.

About this Product

Square Gateway for Magento 2 is a custom-engineered extension that makes Square a first-class payment method inside your Magento 2 Open Source or Adobe Commerce store — and keeps your online shop and your Square POS counter speaking the same language.

This is not an instant Adobe Commerce Marketplace download. ECOSIRE builds the module to your store's exact configuration (Magento version, theme, checkout type, Square account, locale and currency), installs it on your environment, and supports it after go-live. You get clean, upgrade-safe code under app/code/Ecosire/SquareGateway, not a black box.

Under the hood the extension implements Magento's payment service contracts and the Payment Gateway command framework — CommandPoolInterface, ValidatorPoolInterface and gateway request/response builders wired through di.xml — so authorize, capture, sale, refund and void all flow through Magento's standard order and invoice lifecycle. The storefront uses the Square Web Payments SDK to tokenize cards, Apple Pay and Google Pay client-side; raw PAN never touches your server, keeping you in SAQ A-EQ scope. Stored cards use Square's Cards API for tokenized, repeatable charges.

The omnichannel layer is what sets it apart. A scheduled cron job plus Square webhook listeners (a custom controller verifying the x-square-hmacsha256-signature header) reconcile payments, inventory counts and catalog changes between Square and Magento — so a sale at the POS decrements Magento stock, and a Magento order shows up in your Square dashboard. Refunds and disputes initiated in either system stay consistent.

Everything ships with admin ACL-gated configuration, full logging, sandbox-first testing, and REST/GraphQL coverage so headless and PWA Studio frontends work too.

What you get

Custom Magento 2 module installed under app/code/Ecosire/SquareGateway on your environment, version-matched to your Magento 2 / Adobe Commerce release

Square sandbox configuration and end-to-end test transactions before production go-live

Production cutover with your live Square application ID, access token and location ID configured under ACL-gated admin

Webhook and cron setup for online + POS payment, inventory and catalog reconciliation

Composer-installable package or zip with installation and upgrade instructions

Technical handover documentation: configuration reference, sync architecture, and troubleshooting guide

Post-launch support window with bug fixes and Magento minor-version compatibility checks

Who this is for

SMB retailer on Square POS

Runs a brick-and-mortar shop on Square POS and wants the same payment processor and unified reporting on their Magento storefront, without juggling two reconciliation systems.

Omnichannel store manager

Sells the same SKUs online and in-store and needs inventory to stay accurate across both — a POS sale should decrement web stock and vice versa, automatically.

Magento merchant switching processors

Currently on a generic gateway but consolidating onto Square for lower blended rates and one dashboard, and needs a reliable, supported integration rather than a brittle DIY plugin.

How Square Gateway for Magento 2 Compares

Criterion	ECOSIRE	Custom Build	Competitor
Native Square payment method (cards, Apple/Google Pay) in checkout	Included	Partial support	Included
Unified online + Square POS payments on one order	Included	Partial support	Partial support
Two-way inventory & catalog sync (cron + webhooks)	Included	Partial support	Partial support
Built, installed and supported for your exact store	Included	Partial support	Not included
REST & GraphQL coverage for headless / PWA Studio	Included	Partial support	Partial support
Tokenized stored cards via Square Cards API	Included	Partial support	Partial support
Upgrade-safe code you own under app/code	Included	Included	Not included
Instant self-service Marketplace download	Not included	Not included	Included

Frequently Asked Questions about Square Gateway for Magento 2

How long until it's installed and working on my store?

Typical delivery is 2 to 3 weeks (about 10-15 business days) from when we receive your Magento details and Square sandbox credentials. The first week covers building and version-matching the module; the second covers sandbox testing of online and POS flows, inventory sync, refunds and disputes; then we schedule the production cutover with you. Complex catalogs, custom checkouts, or Adobe Commerce B2B can add a few days, which we confirm in writing before starting.

What ongoing support and updates do I get?

Every build includes a post-launch support window for bug fixes and configuration help. Because Square's Web Payments SDK and API versions evolve and Magento ships regular security patches, we offer optional ongoing maintenance to keep the module compatible with your Magento minor upgrades and Square API changes. Since you own the source under app/code, you are never locked in — any Magento developer can read and maintain it.

Does this work with Adobe Commerce as well as Magento Open Source?

Yes. The module is built on standard Magento payment service contracts and the gateway command framework, which are identical across Open Source and Adobe Commerce (Cloud included). We version-match to your exact release and account for Adobe Commerce specifics such as B2B quotes, multiple websites, and shared catalogs during the build.

Is it PCI compliant, and where do card details go?

Card, Apple Pay and Google Pay details are tokenized client-side by the Square Web Payments SDK and never reach your Magento server — your store handles only Square tokens, keeping you in the lighter SAQ A-EQ self-assessment scope. Access tokens are stored in admin config gated by ACL, and all gateway logs are token-redacted.

Can the inventory sync run with my multi-location or Magento MSI setup?

Yes. We map Square locations to Magento MSI sources and stock so a POS sale at a given location decrements the correct Magento source. Sync runs through scheduled cron plus Square webhooks with idempotency keys to avoid double-counting. We confirm your exact source-to-location mapping during the build to match how you actually operate.