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.

Freemius

wumento

Square Loyalty Points & Reward for WooCommerce integrates Square Loyalty Rewards in your WooCommerce store and automatically syncs Square loyalty points between WooCommerce and Square.
The plugin allows customers to earn Square reward points from WooCommerce purchases and view their Square Loyalty balance directly inside their WooCommerce account.
Square Loyalty settings, reward rules, and customer rewards are automatically synced using the Square Loyalty API, making it easy to run a complete Square Rewards program on WooCommerce.
This plugin is ideal for WooCommerce stores using Square payments that want: 
• Square Loyalty integration. 
• Square Rewards synchronization. 
• Square loyalty points for WooCommerce. 
• Square customer rewards. 
• Square rewards redemption. 
• WooCommerce Square loyalty rewards.
⚡ Prerequisites
This plugin Requires <a href="https://wordpress.org/plugins/woosquare/" rel="ugc">WooCommerce Square</a> Plugin pre-installed on your WooCommerce setup in order to work correctly. Contact our support on this support@wumento.com​ if you face any issue setting it up in your on your WooCommerce site. Our support will help you personally to add Square Loyalty Program in your square account.
<h3>Free Support</h3>
Many people find it difficult to set up Square Loyalty Program in their square account so we provide free support to setup Square loyalty program and also setting up this plugin on WooCommerce setup. Contact our support team for free support support@wumento.com​
<h3>Help us to make this plugin bug free</h3>
If you find a bug in the plugin, please email us on this email support@wumento.com . We will highly appreciate it.​
<h3>Loyalty Points & Rewards for Square Highlights</h3>
This plugin creates a square loyalty account for customers on Square and adds points using API whenever a user purchased a product on WooCommerce. Customer will earn loyalty/rewards points based on the loyalty program settings on store owners’ Square account’s loyalty program settings. Customer’s loyalty points remain sync seamlessly once customer account is created between Square and Woocommerce.
Users will be able to view their accumulated Square Loyalty Points right on my account section of WooCommerce store.
<h3>Square Loyalty Points % Rewards Features for WooCommerce</h3>
Free version includes following features:
✅ Square account automatically gets created when when a user purchase an item on WooCommerce store.
✅ Square rewards points automatically accumulated when an order is validated, completed and passes the square loyalty program settings.
✅ Square loyalty points can be seen in user’s my account page.
✅ Square and WooCommerce will start seamless syncing once a user purchases an item on the WooCommerce.
✅ Free support to help shop owners to setup this plugin, if user is facing any difficulty to setup this plugin. Contact us on support@wumento.com .
✅ Free support for shop owners if shop owner is facing difficulty to setup Square loyalty program on the Square site. Contact us on support@wumento.com
<h3>Premium Square Rewards Features</h3>
Premium version includes all the features of light version plus premium features as follows
✅ Square loyalty points can be used to redeem square rewards online during checkout on your WooCommerce setup.
✅ More settings in admin to control the label of Redeem section on checkout page.
✅ Auto adjustment of Square loyalty & rewards points if customer redeems the points online on WooCommerce Store.
✅ Seamless sync between WooCommerce and Square site.
✅ Premium and priority support to help shop owners to setup this plugin, if user is facing any difficulty to setup this plugin.
✅ Setting up Square Loyalty points itself can be a complicated job for shop owners. We provide premium and priority support for shop owners if shop owner is facing difficulty to setup Square loyalty program on the Square site.
<h3>External Services</h3>
This plugin connects to the following external services to enable Square loyalty 
integration with WooCommerce. These services are required for the plugin to function.
<h4>Wumento Middleware (middleware.wumento.com)</h4>
This service is used to connect your WooCommerce store to your Square account. It 
creates and validates authentication tokens to establish a secure connection between 
WooCommerce and Square.
It sends authentication tokens during the initial store connection setup and whenever 
the authentication token needs to be validated. No customer or store data is stored 
in any external location during this process — everything remains in your WordPress 
database.
This service is provided by Wumento: 
Terms of Service: https://wumento.com/terms-and-conditions/ 
Privacy Policy: https://wumento.com/privacy-policy/
<h4>Wumento API (api.wumento.com)</h4>
This service acts as an intermediary between your WooCommerce store and Square’s API. 
All requests are sent to api.wumento.com, which communicates with Square on your 
behalf, processes the response, and returns the result to your store.
During admin setup, it sends the selected store location and authentication token to 
retrieve loyalty program details from Square.
On the frontend, it sends the customer’s email address, phone number, and order total 
when checking loyalty point balances and when awarding points after a completed order.
Data is only transmitted for real-time processing and is not stored in any external 
location — everything remains in your WordPress database.
This service is provided by Wumento: 
Terms of Service: https://wumento.com/terms-and-conditions/ 
Privacy Policy: https://wumento.com/privacy-policy/
<h4>Square (squareup.com)</h4>
Because api.wumento.com communicates with Square on your behalf, customer and order 
data is also transmitted to Square’s servers for loyalty processing.
This service is provided by Square: 
Terms of Service: https://squareup.com/us/en/legal/general/ua 
Privacy Policy: https://squareup.com/us/en/legal/general/privacy

Loyalty Points and Rewards for Square

Add Square Loyalty Rewards to WooCommerce. Automatically sync Square loyalty points, rewards, and customer loyalty balances in WooCommerce and Square.

Payments Square Connect vs Loyalty Points and Rewards for Square