WPPayments

Payments Square Connect lets you accept card and wallet payments through Square Hosted Checkout. Customers pay on Square’s pages (not on your site), then return to your store or form automatically.
Connect your Square account once. After that, WooCommerce checkout, Contact Form 7 forms, and subscription sign-ups all use the same connection — no duplicate setup.
<h4>Getting started in 2 minutes</h4>
This short walkthrough covers install → connect Square → first payment:
<ol>
<li>Activate Payments Square Connect.</li>
<li>Open Payments Square Connect in the admin sidebar.</li>
<li>Choose Sandbox, click Payments Square Connect, sign in, and save a Square Location.</li>
<li>Contact Form 7: add <code>[square_pay amount:25.00]</code> to a form and submit a test payment.</li>
<li>WooCommerce (optional): enable the gateway under WooCommerce → Settings → Payments.</li>
</ol>
See the Screenshots section below for each admin screen. A video tutorial will be embedded here once published on YouTube.
<h4>Quick start</h4>
<ol>
<li>Install and activate the plugin.</li>
<li>Open Payments Square Connect in the WordPress admin sidebar.</li>
<li>Choose Sandbox (testing) or Live (real payments).</li>
<li>Click Payments Square Connect, sign in with Square, and pick a Square Location.</li>
<li>Click Save connection settings.</li>
<li>Turn on the payment method you need (WooCommerce gateway and/or Contact Form 7 tags — see below).</li>
</ol>
<h4>Where to find settings</h4>
Everything is under the top-level menu Payments Square Connect in the WordPress sidebar:
<ul>
<li>Payments Square Connect — connect your account, choose Sandbox/Live, pick a location, copy the webhook URL, and enable debug logging.</li>
<li>Checkout Settings (Beta) — customize how Square hosted checkout looks and behaves (payment methods, tipping, branding, policies). Live mode only — Square does not support this API in Sandbox.</li>
<li>Subscription Plans — view subscription plan variations from your Square Catalog and copy IDs for forms or WooCommerce products.</li>
<li>Support – report a technical issue (email form), open WhatsApp chat, or visit the WordPress.org support forum.</li>
</ul>
<h4>Connect Square (required for all payments)</h4>
This is the main setup screen. Every payment flow depends on it.
Step-by-step
<ol>
<li>Go to Payments Square Connect → Payments Square Connect.</li>
<li>Environment — select Sandbox while testing, or Live when you are ready to charge real cards.</li>
<li>Click the Payments Square Connect button and sign in with your Square seller account.</li>
<li>After a successful login, choose your Square Location from the dropdown. This location receives payments for WooCommerce orders and Contact Form 7 submissions.</li>
<li>Webhook URL — copy the URL shown on this page and paste it into your <a href="https://developer.squareup.com/apps" rel="nofollow ugc">Square Developer Dashboard</a> webhook settings if you use webhooks for order updates.</li>
<li>Debug Log — turn on only while troubleshooting; leave off in production.</li>
<li>Click Save connection settings.</li>
</ol>
Tips
<ul>
<li>Use Sandbox first to run test checkouts without moving money.</li>
<li>If you change your site URL, open this page and connect again so OAuth stays valid.</li>
<li>Disconnect Square appears after you are connected if you need to switch accounts.</li>
</ul>
<h4>WooCommerce store checkout</h4>
WooCommerce is optional. Install it only if you sell products through a WooCommerce store.
Setup
<ol>
<li>Complete Connect Square above (Sandbox or Live + location saved).</li>
<li>Go to WooCommerce → Settings → Payments → Payments Square Connect.</li>
<li>Check Enable/Disable to turn the gateway on.</li>
<li>Set Title and Description — these are what shoppers see on the checkout payment methods list. Example title: “Pay with Square”.</li>
<li>Save changes.</li>
</ol>
How checkout works
<ul>
<li>The customer chooses Payments Square Connect at checkout and places the order.</li>
<li>They are redirected to Square Hosted Checkout to enter payment details.</li>
<li>After payment, Square sends them back to your Order received page.</li>
<li>In Sandbox, a test-mode note is added to the gateway description automatically.</li>
</ul>
WooCommerce Subscriptions (optional)
If you use WooCommerce Subscriptions:
<ol>
<li>Create subscription plans in your Square Catalog (Square Dashboard or API).</li>
<li>Open Payments Square Connect → Subscription Plans and click Refresh from Square.</li>
<li>Edit your WooCommerce subscription product → General tab.</li>
<li>Choose a Square subscription plan variation from the dropdown (leave empty for one-time payment).</li>
<li>At checkout, the buyer is sent to Square’s Subscription Plan Checkout instead of a one-time payment link.</li>
</ol>
<h4>Contact Form 7 payments</h4>
Contact Form 7 is optional. Install it only if you want to collect payments through forms (donations, fees, registrations, etc.).
One-time payment
<ol>
<li>Complete Connect Square above.</li>
<li>Edit your CF7 form and add one of these tags:
<ul>
<li>Fixed amount: <code>[square_pay amount:25.00]</code></li>
<li>Amount from a field: <code>[square_pay amount-field:your-amount]</code> (add a number field named <code>your-amount</code> in the same form)</li>
</ul>
</li>
<li>Publish the form. When a visitor submits, they are redirected to Square to pay, then returned to the form page with a success message.</li>
</ol>
Subscription signup 
1. Create plan variations in Square Catalog. 
2. Copy a variation ID from Payments Square Connect → Subscription Plans. 
3. Add a tag like this to your form: <code>[square_subscribe variation:YOUR_VARIATION_ID name:"Silver Membership" amount:15.00]</code> 
 * variation (required) — Square subscription plan variation ID, not the parent plan ID. 
 * name (optional) — label on the Square checkout page. 
 * amount (optional) — should match the price in Square for that variation. 
4. After signup, the visitor returns to the form with a thank-you message.
<h4>Subscription Plans</h4>
Open Payments Square Connect → Subscription Plans to:
<ul>
<li>See all subscription plan variations synced from your Square Catalog.</li>
<li>Click Refresh from Square after you add or change plans in Square.</li>
<li>Copy Variation ID values for CF7 <code>[square_subscribe]</code> tags or WooCommerce product mapping.</li>
</ul>
Square limits to know
<ul>
<li>Only variations with one paid phase (or one free trial + one paid phase) work with hosted checkout.</li>
<li>Cash App Pay and Afterpay are not available for subscription checkout.</li>
</ul>
<h4>Checkout Settings (Beta)</h4>
Open Payments Square Connect → Checkout Settings to control Square hosted checkout for payment links created by this plugin.
Important: This screen works in Live mode only. Switch to Live on the Connect screen first; Sandbox shows a notice and fields stay read-only.
Merchant settings tab
<ul>
<li>Apple Pay, Google Pay, Cash App Pay — enable or disable wallets on hosted checkout.</li>
<li>Afterpay / Clearpay — read-only; enable or disable in the Square Dashboard.</li>
</ul>
Location settings tab
<ul>
<li>Customer notes — let buyers leave a note during checkout.</li>
<li>Tipping — tip percentages, default tip, smart tipping.</li>
<li>Branding — button color and shape on the Square checkout page.</li>
<li>Policy — title and description for a policy block on checkout.</li>
</ul>
Changes are stored in Square and apply to checkout pages this plugin creates.
<h4>Requirements</h4>
<ul>
<li>WordPress 6.0 or later</li>
<li>PHP 7.4 or later</li>
<li>Square seller account (Sandbox for testing, Live for production)</li>
<li>WooCommerce — optional; required only for store checkout</li>
<li>Contact Form 7 — optional; required only for form-based payments</li>
<li>WooCommerce Subscriptions — optional; required only to map subscription products to Square plans</li>
</ul>
<h3>External services</h3>
This plugin is a client for third-party services. By using it you direct WordPress to contact those services.
<ul>
<li>
Square (required for payments and connection)
<ul>
<li>What: OAuth, REST API (locations, payment links, catalog search, checkout merchant/location settings), hosted checkout pages, and webhooks. </li>
<li>When: When an admin uses Payments Square Connect, when checkout or a CF7 form creates a payment or subscription link, when checkout settings are saved, when subscription plans are refreshed from catalog, and when Square sends webhooks. </li>
<li>Endpoints (summary): <code>https://connect.squareup.com</code> or <code>https://connect.squareupsandbox.com</code> (OAuth and API), plus Square hosted checkout URLs returned in API responses. </li>
<li>Data sent: OAuth tokens after connection, order/form totals and references, subscription plan variation IDs, checkout setting payloads, and webhook payloads as defined by Square. </li>
<li>Terms: https://squareup.com/legal — review Square’s developer and seller terms for your region.</li>
</ul>
</li>
<li>
WPPayments OAuth relay (required for Payments Square Connect)
<ul>
<li>What: Registers your site and completes Square OAuth so application secrets are not stored in WordPress. </li>
<li>When: When a store admin clicks Payments Square Connect. </li>
<li>Endpoint: <code>https://shc4wc-square-oauth.wordpress-ingenious.workers.dev</code> (override with <code>SHC4WC_OAUTH_WORKER_BASE</code> in <code>wp-config.php</code> if needed). </li>
<li>Data sent: Your site URL, sandbox/live environment, and signed session identifiers needed to finish OAuth. </li>
<li>Terms: https://squareup.com/legal (Square OAuth); contact the plugin author for questions about the relay service.</li>
</ul>
</li>
</ul>
Store admins explicitly start OAuth by clicking Payments Square Connect; customers are sent to Square’s hosted pages only during checkout or after submitting a Contact Form 7 payment form.
<h3>Privacy</h3>
<ul>
<li>Site owners: OAuth and API usage are initiated by an administrator with <code>manage_options</code>. Tokens are stored in the WordPress database (options) like other payment settings. </li>
<li>Customers: Personal and payment data on hosted checkout is processed by Square under Square’s policies, not by card fields on your WordPress site. </li>
<li>Logging: Optional debug logs may record technical details when debug logging is enabled on Payments Square Connect; disable debug in normal production. </li>
<li>For compliance questions, consult Square’s documentation and your legal advisor; this readme is not legal advice.</li>
</ul>

Payments Square Connect

Square Hosted Checkout for WooCommerce and Contact Form 7. Connect once for one-time and subscription payments.

WPExperts.io

<a href="https://wcshopsync.com/pricing/?utm_source=wp_org&utm_medium=read_me" rel="nofollow ugc">👑 Get Pro</a> | <a href="https://apiexperts.io/documentation/woosquare-plus/?utm_source=wp_org&utm_medium=readme&utm_campaign=documentation" rel="nofollow ugc">Documentation</a> | <a href="https://objectsws.atlassian.net/servicedesk/customer/portal/5/group/38" rel="nofollow ugc">Support</a>
<h3>A complete tool to connect WooCommerce with Square</h3>
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/_PmNGXUC6Y8?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent&listType=playlist&list=PLfn9RBQ-tb1BtYcNsRKlNoeeLN2m5ZolQ" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe>
Can’t keep your Square and WooCommerce store in sync❓ If so, then you need to install the ✨ WC Shop Sync ✨ plugin.
Besides just a credit card, using the WC Shop Sync plugin, you can add multiple payment options such as (Google Pay, Apple Pay, Afterpay, Cash App, and ACH Payments) through Square.
Isn’t that amazing? Wait, there is more! 😀 👇
Additionally, you can sync inventory, customer data, orders, and even sale prices between Square and WooCommerce with just one click.
Furthermore, let your customers earn and redeem loyalty points directly during WooCommerce checkout using their Square rewards. WC Shop Sync now integrates the Square Loyalty Program on your WooCommerce store.
The WC Shop Sync plugin simplifies your e-commerce operations, saving time and improving accuracy between WooCommerce and Square.
<h3>Why Should You Install WC Shop Sync? — 5 Key Reasons</h3>
Managing your online store can be challenging, especially when using multiple platforms (i.e., Square and WooCommerce). An inaccurate stock count often leads to overselling, stockouts, and frustrated customers.
But not anymore! 🎉😀
WC Shop Sync solves this problem by connecting Square with WooCommerce so that your inventory, orders, and customer data stay in sync.
Here are four key reasons to install WC Shop Sync today!
⚡ Reason #1: Add Multiple Payment Options for WooCommerce
<a href="https://baymard.com/lists/cart-abandonment-rate#:~:text=10%25,enough%20payment%20methods" rel="nofollow ugc">According to Baymard Institute</a>, 10% of customers will abandon their shopping carts if their preferred payment methods aren’t available.
But don’t worry! With WC Shop Sync, you can easily integrate Square Payment Gateway with your WooCommerce store, so besides just debit and credit cards, your customers can pay with Google Pay, <a href="https://apiexperts.io/blog/apple-pay-in-woocommerce/" rel="nofollow ugc">Apple Pay</a>, ACH payments, and Square Gift Cards.
Having this flexibility with Square Gateway enables you to provide a smooth and convenient checkout experience for your customers.
⚡ Reason #2: 1-Click Inventory Sync Between Square and WooCommerce
As you know, manual inventory updates are time-consuming and prone to errors.
According to a study by <a href="https://www.waspbarcode.com/buzz/5-reasons-why-small-businesses-need-inventory-cloud" rel="nofollow ugc">Wasp Barcode Technologies</a>, 43% of small businesses manually manage inventory, meaning they either do not track inventory at all or rely heavily on manual processes.
To make inventory sync management easier, WC Shop Sync offers a 1-click <a href="https://apiexperts.io/blog/sync-inventory-between-square-and-woocommerce-stores/" rel="nofollow ugc">inventory sync between Square and WooCommerce</a>. 🎉
This way, you will always be sure that your stock levels are always up-to-date, thus significantly reducing the risk of overselling or stockouts.
⚡ Reason #3: Real-time Orders and Customer Data Synchronization
Are you having trouble tracking orders and customer data between your Square and WooCommerce stores?
Worry no more! 🙂
WC Shop Sync empowers you to synchronize orders and customer information between Square and WooCommerce in real time. This helps streamline your order management and improve customer service.
⚡ Reason #4: Detailed Activity Log of Each Inventory Sync Coming Soon
Monitoring activities such as product sync, orders, customer data, etc., helps maintain transparency and accountability. However, keeping track of all these changes can be a nightmare, especially when you are managing a large inventory. 😣
WC Shop Sync’s upcoming feature, a detailed activity log screen, will record every sync action. This will enable you to quickly monitor changes and resolve discrepancies, maintaining smooth operations and accurate inventory management between Square and WooCommerce.
⚡ Reason #5: Boost Repeat Sales with Square Loyalty Sync
Returning customers spend up to 5x as much as new customers. With Square Loyalty support in WC Shop Sync, shoppers can earn and redeem loyalty points in your store. When customers have points available, a simple checkbox lets them redeem rewards instantly, and the discount is applied to their order total in real time. 
Since loyalty activity syncs automatically between WooCommerce and Square, you never have to track rewards manually. No more hurdles, just more repeat purchases!
<h3>What Makes WC Shop Sync Ideal for WooCommerce❔</h3>
Wouldn’t you love to have a seamless integration between Square and WooCommerce, which allows you to;
<ul>
<li>1-Click Product Sync / Inventory Sync</li>
<li>Orders Synchronization</li>
<li>Customer Data Sync</li>
<li>Sale Price Synchronization</li>
<li>Add multiple payment options (Google Pay, Apple Pay, ACH payments, and Square Gift Cards) via Square Gateway.</li>
</ul>
Aren’t you? 🤔
Here are some of the key features that make WC Shop Sync integrate WooCommerce with Square an ideal choice for managing your WooCommerce store in tandem with Square.
<h3>Key Features That Our Users 💜 About WC Shop Sync</h3>
✅ Square Payment Gateway Integration:
Accept payments directly through Square Gateway on your WooCommerce store. You can even enable multiple payment methods, which in turn will provide a secure and convenient checkout experience for your customers.
✅ Product Synchronization:
Easily sync simple and variable products between WooCommerce and Square. This ensures that your product listings are always consistent across both platforms, reducing the risk of discrepancies.
✅ Order Synchronization: PRO
It simplifies order management so you can easily keep your sales records consistent.
✅ Square Connection Logs:
Record Square connection responses. Making troubleshooting and monitoring fast and simple.
✅ Square Loyalty Sync PRO
Give customers more reasons to shop again! With WC Shop Sync, you can let your customers earn loyalty points on WooCommerce orders and redeem them directly at checkout with a single click.
✅ Customer Data Sync: PRO
Sync customer details between WooCommerce and Square without manual intervention. Thus, you can provide consistent customer experiences across both platforms by keeping their information accurate and up-to-date.
✅ Auto Inventory Sync: PRO
Automate square inventory sync and WooCommerce inventory sync to avoid stock discrepancies. With auto inventory sync, you can prevent overselling and stockouts, ensuring smooth operations.
✅ Square Modifier: PRO
Create custom products with Square Modifiers, allowing customers to choose additional options or variations. This is particularly useful for businesses that offer custom-made items.
✅ Variable Product Sync
Create custom products with Square Modifiers, allowing customers to choose additional options or variations. This is particularly useful for businesses that offer custom-made items.
✅ Sandbox API Integration:
Utilize the Sandbox API to test transactions before they go live. It is a must-have for developers and store owners to ensure everything works perfectly without affecting real transactions.
✅ Square POS Order Sync: PRO
Sync orders between your <a href="https://apiexperts.io/blog/square-pos-woocommerce/" rel="nofollow ugc">Square POS and WooCommerce</a> so you can see all of your sales in one place. This feature helps you maintain consistent order records across both systems.
✅ Sync Order Refunds: PRO
Manage and process refunds directly from your WooCommerce dashboard, which makes it easier to handle customer cancellations and returns.
✅ Detailed Transaction Tracking: PRO
View complete order details, including tax, shipping values, and individual item sales across Square and WooCommerce. This detailed tracking helps you monitor your sales performance and financials accurately.
✅ Afterpay Integration:
Offer flexible (BNPL) payment options like Afterpay to provide customers with more payment flexibility.
✅ Cash App Integration:
Enable Cash App payments to offer customers another convenient checkout option.
✅ ACH Payment Gateway:
Accept payments directly from customers’ bank accounts via ACH payments. This reduces the dependency on credit cards and offers a cost-effective payment alternative.
✅ Google Pay & Apple Pay:
Enable secure, fast payments through Google Pay and Apple Pay. These widely used mobile wallets improve the checkout experience and can lead to higher conversion rates.
✅ Square Gift Card:
Provide Square eGift Cards as a payment method on your WooCommerce store so customers can use gift cards for their purchases, making shopping easier and more convenient.
✅ Save Cards at Checkout: PRO
Let customers save their card details during checkout for future purchases. This speeds up the checkout process and encourages repeat purchases.
✅ Product Sync Activity Log:
Keep a detailed log of all product synchronization activities between WooCommerce and Square. This helps you troubleshoot any issues that arise during the sync process.
✅ Sync Product with GTIN: PRO
Ensure your products are globally recognizable by syncing products with Global Trade Item Numbers (GTIN). This is essential for businesses that sell internationally.
✅ Priority Customer Support: PRO
Get dedicated support for any issues or queries related to the plugin. Priority support ensures that you get timely and effective assistance to keep your business running smoothly.
<h3>Compatible with FunnelKit and Cartflows</h3>
WC Shop Sync is compatible with FunnelKit and Cartflows for advanced sales funnel management. 😀 🎉
⭐ FunnelKit Integration
This compatibility allows you to design advanced sales funnels tailored to your store’s checkout process.
⭐ Cartflows Integration
Cartflows integration with the Square Payment Gateway is good for conversion-optimized sales flows.
<h3>Need Help? Get Expert Assistance</h3>
Our support team is here to help you with any issues you may encounter. Whether it’s installation, configuration with Square Gateway and WooCommerce, or troubleshooting, simply <a href="https://apiexperts.io/support/" rel="nofollow ugc">click here</a> to open a ticket. We will reach out to you as soon as possible.
Enjoy peace of mind knowing you can access professional assistance whenever needed.
<h3>Access Detailed Technical Documentation</h3>
For more in-depth information, <a href="https://apiexperts.io/documentation/woosquare-plus/" rel="nofollow ugc">check out the detailed technical documentation</a>. which covers setup instructions and advanced configuration options.
<h3>Love This Plugin? You’ll Love These Too!</h3>
<a href="https://postmansmtp.com/" rel="nofollow ugc">Post SMTP</a> – Reliable WordPress email delivery plugin with detailed email logs and multiple SMTP integrations.
<a href="https://gutenaforms.com/" rel="nofollow ugc">Gutena Forms</a> – Create modern, responsive contact forms directly in the Gutenberg block editor. Add advanced fields, protect against spam with reCAPTCHA and Cloudflare Turnstile, manage form entries, and more.
<a href="https://passwordprotectedwp.com/" rel="nofollow ugc">Password Protected</a> – Secure your WordPress site, posts, pages, and categories with simple password protection.
<a href="https://cf7apps.com/" rel="nofollow ugc">CF7 Apps</a> – It allows you to add honeypot, hCaptcha, and Database entries to the Contact form. Our team is constantly adding new Contact Form 7 extensions.
<a href="https://wpeasypay.com/" rel="nofollow ugc">WP EasyPay</a> – Accept Square payments and donations easily on your WordPress site.
<a href="https://mycred.me/" rel="nofollow ugc">myCred</a> – Add gamification, rewards, ranks and points management systems to your WordPress website.
<a href="https://advancedfilemanager.com/" rel="nofollow ugc">Advanced File Manager</a> – Easily manage and organize your WordPress files directly from the dashboard.
<a href="https://aiologin.com/" rel="nofollow ugc">All In One Login</a> – Secure your WordPress login page, change the wp-login.php url, and add Google, Facebook, Microsoft, and LINE, and other social logins to your WordPress site.
<a href="https://wpexperts.io/store/" rel="nofollow ugc">WP Experts WooCommerce Store</a> – Explore premium WooCommerce plugins and solutions by WPExperts.
<a href="https://wpbookify.com/" rel="nofollow ugc">Bookify</a> – Your go-to online bookings and appointment scheduling plugin for WordPress.
<a href="https://newuserapprove.com/" rel="nofollow ugc">New User Approve</a> – Control user registrations by manually approving or denying new signups.

WC Shop Sync – Square Payment Gateway and Product Synchronization for WooCommerce

Works like a charm


I installed this to support a store being able to accept Square.  First, the directions are out of date.  Plugin name and interface have been changed.  It installed easily and immediately connected.  The first three transactions had two failures but both messages indicated a failure from Square, however, Square didn't show them.  By the end of the day, the cart just showed "initializing" and we had several failed transaction that indicated that the API call was missing data.  Moving on to another solution.


Good Start Bad Finish, Moving On

Want to add Square Payment Gateway for WooCommerce? Download WC Shop Sync plugin to add Square payments, inventory sync, customer data, orders, etc.

Payments Square Connect vs WC Shop Sync – Square Payment Gateway and Product Synchronization for WooCommerce