=== Connect Square Payments – WordPress Square Hosted Checkout for WooCommerce, Fluent Forms, CF7, WPForms, Pay Links & More ===
Contributors: wppayments
Tags: square payments, square, woocommerce square, inventory sync, woocommerce
Requires at least: 6.0
Tested up to: 7.0.2
Requires PHP: 7.4
Stable tag: 1.3.57
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Square hosted checkout for WooCommerce, forms & pay links. Reliable Square payment gateway for WordPress with secure off-site payments.

== Description ==

**Connect Square Payments** is the most reliable **WooCommerce Square** alternative that adds a professional **Square payment gateway** using **Square Hosted Checkout**. 

* **Square Online users:** Switch to WooCommerce and keep Square for payments.
  Need help migrating? Install the plugin and open a support request — we can
  assist with product sync, store setup, and payment configuration.

Send buyers to Square's secure hosted payment page — **no card fields in your theme**, no JavaScript conflicts, and a permanent fix for common **payment nonce is missing** or **EMPTY_VALUE** errors on WooCommerce checkout and Pay for Order pages.

Connect Square once and accept payments across your entire WordPress site:
* **WooCommerce Square** gateway (classic and Blocks checkout)
* **Paid Memberships Pro** (recurring memberships without WooCommerce Subscriptions)
* **Fluent Forms**, **Contact Form 7 (CF7)**, and **WPForms**
* **Ninja Forms**, **Formidable Forms**, **MetForm**, **SureForms**, and **Forminator**
* **Square Payment Links** (buttons for Gutenberg, Elementor, Beaver Builder, and shortcodes)
* **Square Subscriptions** for recurring billing

Optional Android companion app (Connect Square Payments App) — scan a QR code from the Mobile App admin screen to monitor today's Square sales and connection status on your phone. APK download link included in plugin settings; no Square credentials are stored in the app.

[Live demo](https://payments-connect-square.pages.dev/try?utm_source=wordpress_org&utm_medium=readme&utm_campaign=live_demo) · [Documentation](https://payments-connect-square.pages.dev/getting-started/?utm_source=wordpress_org&utm_medium=readme&utm_campaign=getting_started) · [Support](https://payments-connect-square.pages.dev/support/?utm_source=wordpress_org&utm_medium=readme&utm_campaign=support)

= Location stock demo =

See **Location stock** — link WooCommerce products to Square locations and update inventory from one screen:

[youtube https://www.youtube.com/watch?v=JwUuwea_D7Y]

= Square Hosted Checkout demo =

Watch **Square Hosted Checkout** with WooCommerce in action:

[youtube https://www.youtube.com/watch?v=kwNZSd_A_u4]

= Elementor payment links demo =

See **Square Payment Links** with **Elementor** — Pay Now buttons and Square Hosted Checkout on a WordPress page:

[youtube https://www.youtube.com/watch?v=oPFNxWvNS98]

= Why merchants choose this plugin: =

If you searched for **Square payment** for WordPress, you have probably seen on-site card fields break after a theme update or plugin conflict. **Connect Square Payments** is a no-code integration: connect Square once, enable the gateway, and send buyers to **Square Hosted Checkout** — no card form embedded in your theme.

* **Fix WooCommerce Square nonce error:** Hosted checkout removes failure points like `square-credit-card.js` conflicts, session timeouts, and **EMPTY_VALUE** on Pay for Order pages.
* **Digital wallets included:** Apple Pay, Google Pay, Cash App Pay, and Afterpay / Clearpay (BNPL) supported on Square's page.
* **No extra platform fees:** You pay Square's normal processing rates only; no per-transaction plugin fee.
* **Reliable Inventory Sync:** Simple SKU-based stock sync updates Square On hand when WooCommerce orders are paid.
* **POS orders in Woo (Pro):** Bring Square in-person sales into WooCommerce as orders. Creates Woo products for new Square items, links them to the order, and reduces stock.
* **Proactive Connection Alerts (Free):** Daily token health checks plus email and wp-admin notices when Square OAuth refresh fails or API calls report an expired or revoked token — reconnect before checkout breaks.

= Features =

* **Hosted checkout** — customers pay on Square's secure page and return to your store.
* **Refunds from wp-admin** — full or partial refunds directly on the WooCommerce order screen.
* **Pay for Order links** — email or copy a secure invoice payment link for unpaid orders.
* **Payment sync** — automatically check pending orders and mark them paid without needing complex webhooks.
* **Customer sync** — keep Square and WordPress customer directories in sync automatically.
* **Square Loyalty Rewards** — earn points on all paid orders (Free); redeem at checkout (Premium).
* **Proactive connection alerts (Free)** — email and wp-admin notice when Square OAuth renewal fails or tokens are rejected.
* **Automatic OAuth token renewal** — daily refresh cron keeps access tokens current.
* **24/7 Support** — dedicated help via email, WhatsApp, and the WordPress.org forum.

= Premium features =

Upgrade under **Payments Square Connect → Pricing** to unlock:
* **Location stock** — link products to specific Square locations for accurate inventory.
* **Bulk Location stock admin** — manage locations and stock levels for your entire catalog at once.
* **Square gift cards** at checkout.
* **Loyalty reward redemption** directly on the checkout page.
* **Bi-directional inventory** (Square → WooCommerce) for real-time stock updates.
* **Order import from Square (Pro)** — optionally create WooCommerce orders when Square POS / Register payments complete.
* **Dispute alerts (Plus)** — email admin and show dashboard notices when Square chargebacks/disputes arrive.
* **Payout reconciliation (Pro)** — log payout webhooks and link recent WooCommerce orders.
* **Refund sync (Pro)** — Square Dashboard refunds create matching WooCommerce refunds with stock restoration.
* **Terminal checkout sync (Pro)** — complete or cancel WooCommerce orders when Square Terminal checkout status changes.
* **And many more** — see **Payments Square Connect → Pricing** for the full Plus and Pro feature list.

== Installation ==

[→ Getting started guide](https://payments-connect-square.pages.dev/getting-started/?utm_source=wordpress_org&utm_medium=readme&utm_campaign=getting_started)

1. Activate **Payments Square Connect**.
2. Open **Payments Square Connect** in the admin sidebar.
3. Choose **Sandbox** or **Live**, sign in with Square, and save a location.
4. Enable **WooCommerce Square** checkout, or your preferred form plugin integration.

== Frequently Asked Questions ==

= Payment nonce is missing — can hosted checkout fix it? =

Yes. The **payment nonce is missing** error usually happens when Square's on-site JavaScript cannot tokenize the card due to theme conflicts or caching. **Connect Square Payments** avoids on-site nonce generation entirely by using **Square Hosted Checkout**.

= How is hosted checkout different from on-site Square card fields? =

Many Square integrations embed card fields in your checkout theme. **Connect Square Payments** uses **Square Hosted Checkout** (off-site), which can be more reliable for sites with complex themes or caching. We also support **WPForms, Fluent Forms, and CF7** on the same connection.

= Do Square POS sales create WooCommerce orders? =

Not by default. On **Pro**, enable **Order import (Square → WooCommerce)** under connection settings. Completed Square/POS payments for your selected location can create WooCommerce orders. Existing products match by SKU or catalog link; **new WooCommerce products are created** for unmatched Square catalog lines, linked to the order, and stock is reduced. Custom/ad-hoc POS lines also create simple products when possible.

= Can I get alerts when a Square dispute is opened? =

On **Plus**, enable **Dispute alerts** under connection settings. When Square sends a dispute webhook, the store admin gets an email and a WooCommerce admin notice with amount, reason, and dispute state.

= Will I be notified if my Square connection drops? =

Yes — **free on all plans**. Payments Square Connect runs daily OAuth token checks and emails the site admin (plus shows a wp-admin notice) when token refresh fails or Square rejects the stored access token. Reconnect under **Payments Square Connect → Connect** to restore checkout.

= Does this work with Apple Pay and Google Pay? =

Yes. Enable digital wallets under **Payments Square Connect → Checkout Settings**. Buyers will see Apple Pay, Google Pay, Cash App Pay, and Afterpay on the Square payment page.

= Does Square payment work in the USA, UK, and Australia? =

Yes. **Square payment** and **Square Hosted Checkout** work for merchants in the **United States, Canada, United Kingdom, Australia**, Ireland, France, Spain, and Japan.

== Changelog ==

= 1.3.57 =
* New (Free) — Connect Square Payments Android app: pair your store from Payments Square Connect → Mobile App via QR code.

= 1.3.56 =
* **Fix** — Google Pay express button renders correctly on checkout and product pages, including WooCommerce Blocks checkout.
* **Fix** — Cart express wallet buttons no longer stay hidden inside the Blocks cart mount.
* **Fix** — Express wallet button spacing on cart and product pages now matches WooCommerce Square (spacing below Proceed to Checkout / Add to Cart, full-width cart totals, consistent button gaps).
* **Improvement** — Clearer Apple Pay domain verification alerts and wp-admin connection notices when domain registration needs attention.

= 1.3.54 =
* **Fix** — Express wallet buttons (Google Pay / Apple Pay) on cart and product pages: proper spacing below Proceed to Checkout / Add to Cart, full-width layout in cart totals, and consistent button gaps (WooCommerce Square parity).

= 1.3.50 =
* **Apple Pay gateway (Free)** — on-site checkout (classic + Blocks), domain verification, refunds.
* **Google Pay gateway (Free)** — on-site checkout (classic + Blocks); enable separately from Apple Pay.
* **Express checkout (Free)** — wallet buttons on cart, product, and checkout (toggle per gateway).
* **Apple Pay / Google Pay Blocks fixes** — WC 10+ `onPaymentSetup` registration, correct Store API payment hook, token cache race fix, and less Blocks debug noise.
* **Apple Pay button & debug** — native Apple Pay button styling, optional debug logging (`?error-logapple=true`), tokenize audit in order notes and WooCommerce logs.
* **Human-readable wallet errors** — Square decline messages (e.g. transaction limit, card declined) instead of generic “Something went wrong” on Blocks checkout.

= 1.3.48 =
* **Connection alerts (Free)** — email the site admin and show a wp-admin reconnect notice when Square OAuth token refresh fails or API calls report an expired/revoked token. Includes daily cron monitoring and automatic alert clearing after a successful reconnect.

= 1.3.47 =
* **Update** — Freemius SDK 2.13.4 (Pricing App fixes, PHP compatibility, configurable API timeout).

= 1.3.46 =
* **Premium webhooks (Plus/Pro)** — dispute email and admin alerts (Plus); payout reconciliation log, Square Dashboard → WooCommerce refund sync, and Terminal checkout order sync (Pro). Uses the Payments Square Connect webhook relay (no merchant webhook setup).
* **Connect settings** — toggles for dispute alerts, payout reconciliation, refund sync, and Terminal sync.
* **Order import (Pro)** — Square POS line items match existing products or create new WooCommerce products; stock reduced on import; order notes show matched/created lines.

= 1.3.45 =
* **Order import (Pro)** — when a Square/POS order imports, create or match a WooCommerce customer and link the order (email / Square customer ID).

= 1.3.44 =
* **Fix** — Connect settings checkboxes for Location stock, Inventory sync, and Order import now save correctly when enabled.

= 1.3.43 =
* **Order import (Pro)** — optionally import completed Square POS / Square payments into WooCommerce as new orders (enable under connection settings).

= 1.3.42 =
* **Location stock (Plus)** — link each product to one Square location for online sales.
* **Location stock admin** — bulk screen to change locations and stock for many products at once.

= 1.3.41 =
* **Plans** — Free / Plus / Pro (annual) tiers.
* **Plus** — gift cards at checkout, loyalty redeem, and location-linked stock.

= 1.3.40 =
* **Square Loyalty Rewards** — earn Square Loyalty points on paid WooCommerce orders (Free).
* **OAuth** — request LOYALTY_READ and LOYALTY_WRITE scopes.

== Looking for Square on Odoo? ==

This plugin is for **WordPress / WooCommerce**. If you need a Square solution on **Odoo** instead — inventory sync, multi-location stock, Square Hosted Checkout, Google Pay, Apple Pay, Cash App Pay, Afterpay, and Square Terminal — use our free Odoo module **[Square Sync & Pay](https://apps.odoo.com/apps/modules/18.0/odoo_square_all_in_one?utm_source=wordpress_org&utm_medium=readme&utm_campaign=odoo_square_sync_pay)**.

Same team (WPPayments). No module subscription fee — you only pay Square's normal processing rates.
