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.

XLPlugins

Aman

Team FunnelKit (formerly WooFunnels)

FunnelKit Payment Gateway for Square WooCommerce is a powerful and reliable payment solution that enables you to accept payments both online and in person with ease.
It’s ideal for store owners looking for a secure, synchronized, and fully integrated way to handle payments, products, and inventory, all without switching platforms.
With Square Payment Gateway for WooCommerce, you can accept major credit and debit card payments, as well as popular digital wallets like Apple Pay and Google Pay, and alternative payment methods like Cash App Pay, Afterpay, ACH bank transfers, and gift cards directly on your WooCommerce store.
Whether you’re selling products online or at a physical store, Square ensures all your inventory, product data, and order history remain perfectly synced in real-time.
It goes beyond just accepting payments. With Square, you can:
<ul>
<li>Automatically sync inventory between Square and WooCommerce</li>
<li>Keep your product catalog consistent across platforms</li>
<li>Track orders and customer data in real time</li>
<li>Manage refunds and variable products with no hassle</li>
</ul>
Plus, with its sandbox testing mode, you can simulate transactions and test everything before going live, making Square a safe and developer-friendly option for any WooCommerce merchant.
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/b_207FpOvr8?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe>
<h3>Why Square?</h3>
Square is one of the most trusted and widely used payment platforms in the world, serving millions of businesses across the globe.
<ul>
<li>No monthly fees. Pay only per transaction.</li>
<li>Accepts multiple currencies and supports both online and offline transactions.</li>
<li>Built-in fraud prevention, PCI compliance, and detailed analytics.</li>
</ul>
With Square, you’re not just getting a payment processor, you’re getting a complete commerce solution that scales with your WooCommerce store.
<h3>Features of Square Payment Gateway for WooCommerce</h3>
Here are the key features that make Square a standout payment solution for WooCommerce:
<h3>1. Quick Onboarding Process</h3>
Get started in just a few minutes. Connect your Square account with WooCommerce and start accepting payments instantly, eliminating the need for complex setup and manual API key addition.
<h3>2. Multiple Payment Methods</h3>
Accept all major credit and debit cards, including Visa, Mastercard, American Express, and more, plus Apple Pay, Google Pay, Cash App Pay, Afterpay, ACH bank transfers, and gift cards for flexible, customer-friendly checkout experiences.
<h3>3. Real-Time Inventory Sync</h3>
Square keeps your product inventory in sync across both platforms. Whether you make a sale online or in person, your stock levels update automatically in WooCommerce and Square. This ensures accurate stock management at all times.
<h3>4. One-Click Product Catalog Sync</h3>
Easily sync your entire product catalog, including product names, categories, prices, images, and stock, between Square and WooCommerce in just one click.
<h3>5. Variable Product Support</h3>
Sell products with multiple variations (like size, color, etc.)? Square handles variable products with ease, ensuring your catalog stays consistent across platforms.
<h3>6. Real-Time Order & Customer Sync</h3>
Automatically sync order and customer data between WooCommerce and Square. Keep track of every transaction and customer record in one unified system.
<h3>7. Seamless Refund Management</h3>
Initiate refunds from WooCommerce and have them instantly reflect in Square and vice versa. This ensures your customers have a smooth experience, and your records stay accurate.
<h3>8. Sandbox Testing Mode</h3>
Square offers a Sandbox API so you can test your entire checkout flow, sync settings, and transactions before going live without affecting real data or payments.
<h3>9. Detailed Transaction Tracking</h3>
Track payments, refunds, disputes, and adjustments directly from your WooCommerce dashboard with Square’s detailed reporting.
<h3>Compatible Payment Methods</h3>
Here’s what your customers can use to pay when you integrate Square with WooCommerce:
<h3>1. Credit and Debit Cards</h3>
Accept payments from major credit and debit cards, such as Visa, Mastercard, American Express, Discover, Diners Club, JCB, and more.
<h3>2. Apple Pay</h3>
Offer your Apple users a secure, one-click checkout experience using Face ID or Touch ID without entering card details manually.
<h3>3. Google Pay</h3>
Let Android users complete their purchases in just a few taps with Google Pay, offering convenience and top-notch security.
<h3>4. ACH Bank Transfer</h3>
Allow customers to pay directly from their bank account using ACH transfers, offering lower processing fees and a familiar payment flow for US-based customers.
<h3>5. Cash App Pay</h3>
Give your customers the option to pay using Cash App, one of the most popular peer-to-peer payment apps. It provides a quick, seamless checkout experience that millions of users already know and trust.
<h3>6. Gift Cards</h3>
Customers can redeem gift card balances at checkout, making it easy to support gifting, store credit, and loyalty programs.
<h3>7. Afterpay</h3>
Offer your customers the flexibility to buy now and pay later with Afterpay. They can split their purchase into interest-free installments, helping increase average order value and reduce cart abandonment.
That’s not all! FunnelKit Team is committed to bringing you many more payment gateways to enhance your WooCommerce store experience.
<h3>ABOUT FUNNELKIT</h3>
The Square Payment Gateway for WooCommerce is proudly developed by FunnelKit’s expert team: the same people behind some of the most powerful sales and marketing tools for WooCommerce.
With over a decade of experience and a thriving ecosystem, FunnelKit helps thousands of businesses worldwide boost conversions, streamline checkout, and maximize revenue.
Here’s a look at other game-changing plugins from FunnelKit’s suite:
<h3>Here are some of our plugins:</h3>
<a href="https://wordpress.org/plugins/funnel-builder/" rel="ugc">FunnelKit’s Funnel Builder</a> – The most flexible funnel builder for WordPress. Build profitable funnels using conversion-friendly templates, analyze performance and improve with built-in A/B testing.
<a href="https://funnelkit.com/woocommerce-checkout-pages-aero/" rel="nofollow ugc">FunnelKit Checkout</a> – Increase your conversions with FunnelKit’s optimized WooCommerce checkout pages. Choose from ready-to-use checkout page templates, embed forms, create one-page checkouts, and more. Offer order bumps to boost your business revenue.
<a href="https://funnelkit.com/woocommerce-one-click-upsells-upstroke/" rel="nofollow ugc">FunnelKit One-Click Upsells</a> – Boost your average order value (AOV) by pitching hyper-relevant post-purchase upsell offers after the checkout.
<a href="https://wordpress.org/plugins/wp-marketing-automations/" rel="ugc">FunnelKit Automations</a> – Engage with your customers with automated WooCommerce email marketing and SMS campaigns. Automate your abandoned cart recovery sequence, post-purchase follow-up emails, winback campaigns, and more.
<a href="https://wordpress.org/plugins/cart-for-woocommerce/" rel="ugc">FunnelKit Cart</a> – Adds a beautiful sliding cart to your WooCommerce store. Let the buyers add items, edit quantity and add upsells (Pro) on the side cart. Skip traditional cart page and reach checkout faster.
<a href="https://wordpress.org/plugins/funnelkit-stripe-woo-payment-gateway/" rel="ugc">FunnelKit Payment Gateway for Stripe WooCommerce</a> – Accept payments with Stripe-powered gateways such as Apple Pay, Google Pay, BNPL, and more while supporting upsells and advanced checkout flows.
<h3>External Services</h3>
This plugin integrates with the following external services:
<h3>1. Google Pay API</h3>
<ul>
<li>Purpose: Google Pay is used to process payments securely during checkout.</li>
<li>Data Sent: Transaction details such as the total amount and the customer’s Google Pay account information are sent when the user selects Google Pay as a payment method.</li>
<li>Terms and Privacy: This service is provided by Google LLC. You can view the terms of service and privacy policy at <a href="https://pay.google.com/about/terms/" rel="nofollow ugc">Google Pay Terms of Service</a> and <a href="https://policies.google.com/privacy" rel="nofollow ugc">Google Privacy Policy</a>.</li>
</ul>
<h3>2. FunnelKit AUTH API (Square Connect OAuth)</h3>
<ul>
<li>Purpose: The FunnelKit AUTH API is used to authenticate and securely connect to Square’s payment gateway for OAuth purposes.</li>
<li>Data Sent: Authentication tokens and user details are sent to ensure a secure connection during the payment process.</li>
<li>Terms and Privacy: This service is provided by FunnelKit. The terms of service and privacy policy are available upon request.</li>
</ul>
<h3>3. Square Direct APIs (JavaScript & PHP)</h3>
<ul>
<li>Purpose: Square Direct APIs handle payment processing and transaction syncing between the plugin and Square.</li>
<li>Data Sent: Customer information (name, email, payment method) and order details are transmitted during payment processing. The plugin also syncs transaction status and updates after each purchase.</li>
<li>Terms and Privacy: This service is provided by Square, Inc. You can view the terms of service and privacy policy at <a href="https://squareup.com/legal/terms" rel="nofollow ugc">Square Terms of Service</a> and <a href="https://squareup.com/legal/privacy" rel="nofollow ugc">Square Privacy Policy</a>.</li>
</ul>

FunnelKit Payment Gateway for Square WooCommerce

FunnelKit Payment Gateway for Square WooCommerce is a powerful and reliable payment solution that enables you to accept payments both online and in pe …

Payments Square Connect vs FunnelKit Payment Gateway for Square WooCommerce