FAQ — Square Payment & WooCommerce
Answers about Square payment, the WooCommerce payment gateway, hosted checkout, and common checkout errors.
Is this a WooCommerce payment gateway plugin?
Yes. Enable Payments Square Connect under WooCommerce → Settings → Payments. It appears as a WooCommerce payment gateway at checkout and on Pay for Order pages. Customers pay on Square Hosted Checkout and return to your store. Works with classic checkout and WooCommerce Blocks checkout. See the WooCommerce guide.
Payment nonce is missing — can hosted checkout fix it?
Yes — for most stores. Payment nonce is missing usually means Square's on-site Web Payments SDK could not tokenize the card (JavaScript conflicts, caching, page builders, or minification). Square Hosted Checkout avoids on-site nonce generation. This also helps EMPTY_VALUE and broken Pay for Order pages.
→ Full guide — Fix WooCommerce Square nonce errors
Details: WooCommerce checkout guide.
How is this different from WooCommerce Square?
The official WooCommerce Square plugin embeds card fields and offers heavy catalog / inventory sync with Square POS. Payments Square Connect uses Square Hosted Checkout only — plus forms, payment links, and light SKU-based stock sync. See the comparison table.
Can I accept Square payments without WooCommerce?
Yes. Use Contact Form 7, WPForms, Fluent Forms, or payment links with the same Square connection — no WooCommerce cart required.
Does this work with Apple Pay, Google Pay, and Cash App Pay?
Yes. Enable wallets under Payments Square Connect → Checkout Settings (Live mode). Buyers see Apple Pay, Google Pay, Cash App Pay, and Afterpay on Square Hosted Checkout when enabled in Square.
Does Square payment work in the UK, Canada, and Australia?
Yes — wherever Square supports sellers: United States, Canada, United Kingdom, Australia, Ireland, France, Spain, and Japan (subject to Square account rules). Connect in Sandbox or Live, pick a location, and accept Square payments on WooCommerce, forms, or payment links.
Square vs Stripe for WordPress — when should I use Square?
Choose Square when you run Square POS, want Square Hosted Checkout, or need WooCommerce + forms on one connection. Choose Stripe when your stack is Stripe-first. This plugin avoids on-site card field conflicts that affect both Square and Stripe on-site gateways. No extra plugin fee.
WooCommerce Square sync broke my products — is this safer?
This plugin does not run full bidirectional catalog import. It uses Square Hosted Checkout and optional SKU-matched inventory updates when orders are paid — no mass product overwrite from Square to WooCommerce.
Do I need WooCommerce?
No. You can take Square payment through Contact Form 7, WPForms, Fluent Forms, or payment links without WooCommerce.
Where are the settings?
Payments Square Connect in the WordPress admin sidebar.
Sandbox vs Live?
| Mode | Use for |
|---|---|
| Sandbox | Testing — no real money |
| Live | Real customer payments |
Start in Sandbox, then switch to Live when ready.
Is card data stored on my site?
No. Customers enter payment details on Square Hosted Checkout only.
Does the plugin charge an extra fee?
There is no platform fee on each payment — you pay Square’s normal processing rates. Hosted Checkout and the free feature set stay free. Optional Plus / Pro unlock gift cards, loyalty redeem, and location stock (see Premium features). Upgrade under Payments Square Connect → Pricing.
What is free vs Premium?
Free: Square Hosted Checkout, OAuth connect, wallets, forms & payment links, refunds, payment reminders, and Square Loyalty earn / My Account balance.
Plus: location-linked Woo → Square stock, Square gift cards at checkout, loyalty redeem.
Pro: Plus features plus Square → Woo inventory webhooks.
→ How gift cards and loyalty redeem flow
Do Square gift cards work?
Yes on Plus (and Pro). At WooCommerce checkout the customer enters their Square gift card number. The balance is applied to the order; if anything remains, they complete payment on Square Hosted Checkout. If the gift card covers the full total, the order can be paid without a card redirect.
Does Square Loyalty work?
Earn is free — paid Payments Square Connect orders can earn Square Loyalty points, and customers can view balance under My Account → Square Loyalty. Redeeming rewards at checkout is a Premium upgrade.
Are gift cards and location stock free?
No — those are Premium features (upgrade under Pricing). Free includes hosted checkout and loyalty earn.
How does the customer return to my site?
Square redirects them after payment. WooCommerce shoppers see the order confirmation page. Form visitors return with a success message.
Can I remind customers to pay unpaid orders?
Yes. Enable Payment reminders under WooCommerce → Settings → Payments → Payments Square Connect. See Pay for Order — automatic reminders.
Can I sync Square customers with WordPress?
Yes. Under Payments Square Connect → Connect, enable Customer sync, choose a direction (Square → WordPress, WordPress → Square, or both), and optionally Include existing for a background full sync. See the Customer sync guide.
Can I use automation or AI tools?
Yes. Admins can use REST API shc4wc/v1 (status, send payment link). Developers can hook into shc4wc_square_connected, shc4wc_pay_for_order_email_sent, shc4wc_payment_reminder_sent, and related actions. The optional AI setup assistant on Get started uses your own OpenAI API key — card data and Square tokens are never sent.
Why is my refund button missing?
See Refunds — the order must be paid with a stored Square payment ID.
Orders show Processing too early?
Orders stay Pending until Square confirms payment. Enable webhooks and update to the latest plugin version if issues persist.
Connection keeps dropping?
OAuth tokens renew automatically. Reconnect only if Square revoked access or you changed app credentials.