Payments Square Connect

ཞིབ་བརྗོད།

Pay on Square’s page. Stay connected. Keep stock in sync.

Payments Square Connect is your WooCommerce Square integration — built for store owners who want Square payments that just work — without checkout breaking, without surprise disconnects, and without inventory falling out of step.

Customers pay on Square Hosted Checkout (Square’s secure page, not yours). You get WooCommerce Square orders with refunds from wp-admin, plus Contact Form 7, WPForms, Fluent Forms payments, payment link buttons, and subscriptions — all through one Square connection.

Why merchants choose this plugin:

• No extra plugin fee — this plugin does not add a per-payment charge on top of Square’s processing rates
• 24/7 support available anytime — email, WhatsApp, and the WordPress.org forum whenever you need help
• Checkout that doesn’t break — no card form buried inside your theme; buyers pay on Square and return automatically
• Always-on Square connection — access tokens renew in the background so API calls and checkouts keep working
• WooCommerce Square refunds — issue full or partial refunds from the order screen; the plugin sends the refund to Square using the stored payment ID
• WooCommerce Square inventory sync — match products by SKU and Square catalog stock updates when a WooCommerce order is paid
• One connect, every channel — WooCommerce Square checkout plus Contact Form 7, WPForms, Fluent Forms, payment link buttons, and subscriptions from the same account
• Digital wallets everywhere — Apple Pay, Google Pay, Cash App Pay, and Afterpay/Clearpay on WooCommerce Square checkout, Contact Form 7, WPForms, Fluent Forms, and payment link buttons (when enabled in Square)
• Security built in — card data never touches your WordPress server

WooCommerce Square stock sync

Sell on WooCommerce, run your business on Square — keep both sides honest with WooCommerce Square inventory sync.

When a product SKU in WooCommerce matches your Square catalog, checkout sends that line item to Square with the right catalog link. After payment, Square inventory updates automatically so your Square Dashboard reflects what actually sold.

No manual mapping screens — use the same SKU on both sides and you’re done. No matching SKU? The product still goes to checkout by name and price so nothing blocks the sale.

Tip: Use matching SKUs on WooCommerce products and Square catalog variations for the smoothest inventory sync.

A connection that keeps working

Square Connect should not die quietly after a few weeks.

This plugin renews your Square access token automatically (daily checks and before API calls) so payment links, checkout settings, and catalog lookups are less likely to fail with a stale connection. The Connect screen shows when your token was last renewed — reconnect once after updating to pick up the latest permissions.

Quick start

1. Install and activate Payments Square Connect.
2. Open Payments Square Connect in the WordPress admin sidebar.
3. Choose Sandbox for testing or Live for real payments.
4. Click Payments Square Connect, sign in with Square, and pick your Square Location.
5. Click Save connection settings.
6. Turn on WooCommerce Square checkout, Contact Form 7, WPForms, Fluent Forms, and/or payment link buttons (see below).

Payment link button (no form plugin required)

Add a Pay Now button on any page or post — no WooCommerce or form builder required.

Shortcode

[square_payment_link amount="25.00" label="Pay Now" description="Consultation fee"]

Alias: [square_pay_link]

Gutenberg block

1. Edit any page or post in the block editor.
2. Click + and search for Square Payment Link.
3. In the block sidebar, set Amount, Button label, and optional Description / Currency.
4. Publish the page. Visitors click the button, complete payment on Square, and return to the same page with a thank-you message.

Shortcode block: add a Shortcode block and paste the shortcode above if you prefer.

Where to find settings

Everything is under Payments Square Connect in the admin sidebar:

• Payments Square Connect — connect Square, choose Sandbox or Live, pick a location
• Checkout Settings (Beta) — wallets, tipping, branding, and policies on Square checkout (Live mode only)
• Subscription Plans — view your Square plans and copy plan IDs
• Support — 24/7 support available anytime via email, WhatsApp, or the WordPress.org forum

Connect Square

Every payment uses this screen first.

1. Go to Payments Square Connect → Payments Square Connect.
2. Pick Sandbox while testing, or Live when you are ready to take real payments.
3. Click Payments Square Connect and sign in with your Square account.
4. Choose your Square Location from the list.
5. Click Save connection settings.

Tips

• Start in Sandbox so you can test without charging real cards.
• If you move your site to a new address, connect Square again from this page.
• Use Disconnect Square if you need to switch accounts.

WooCommerce Square

WooCommerce Square hosted checkout connects your store to Square without embedding card fields in your theme. WooCommerce itself is optional — install it only if you sell through a WooCommerce store.

1. Complete Connect Square above.
2. Go to WooCommerce → Settings → Payments → Payments Square Connect.
3. Turn the gateway on.
4. Set Title and Description (what shoppers see at checkout). Example: “Pay with Square”.
5. Save and place a test order.

At checkout: the customer chooses your Square gateway, is sent to Square to pay, then returns to your Order received page.

Subscriptions (optional): create plans in Square, refresh Subscription Plans in this plugin, then pick a plan on each WooCommerce subscription product.

WooCommerce Square refunds

Refund one-time WooCommerce Square orders from wp-admin. The plugin sends the refund to Square using the original payment ID; funds return on Square’s normal refund timeline.

How to refund an order

1. Go to WooCommerce → Orders and open a paid order that used Payments Square Connect.
2. In the order items panel, click Refund.
3. Enter a full or partial amount and an optional reason.
4. Confirm the refund. WooCommerce records the refund and the plugin calls Square.
5. Check the order notes — they show the Square refund ID and status (for example COMPLETED or PENDING).

Full vs partial refunds

• Full refund — refund the entire captured payment (WooCommerce usually pre-fills the remaining refundable total).
• Partial refund — enter a smaller amount. You can issue several partial refunds until the payment is fully refunded.

When refunds work

• Payment method is Payments Square Connect.
• The order is paid (Processing or Completed).
• A Square payment ID is stored on the order. It is saved when:
  • the customer returns from Square Hosted Checkout, or
  • Square sends a payment completed webhook to your site (recommended for reliability).

Configure webhooks (recommended)

Add your plugin webhook URL in the Square Developer Dashboard so payment IDs are saved even if the buyer closes the browser before returning. Find the URL under Payments Square Connect → Connect (Webhook URL field).

Sandbox testing

1. Connect in Sandbox mode and place a test order.
2. Complete payment on Square Sandbox checkout.
3. Refund the order from wp-admin and confirm the note shows a Square refund ID.
4. Verify the refund in your Square Sandbox transactions.

Not available through WooCommerce Square refunds

• Contact Form 7, WPForms, Fluent Forms, and payment link payments — refund in the Square Dashboard.
• Subscription renewal charges billed by Square — refund in the Square Dashboard.
• Orders still Pending or without a Square payment ID — wait for payment confirmation, then retry.

Troubleshooting

• “Square payment ID was not found” — payment not fully confirmed yet; wait for webhook or ask the customer to return from Square, then try again.
• Refund failed — enable Debug Log on the Connect screen and check WooCommerce → Status → Logs (source shc4wc).
• Partial refund rejected — amount may exceed what Square still allows on that payment; try a lower amount.

Contact Form 7

Contact Form 7 is optional. Use it for donations, fees, registrations, and similar forms.

Payment methods: One-time CF7 payments use Square Hosted Checkout — the same page as WooCommerce Square checkout. Buyers can pay with Apple Pay, Google Pay, Cash App Pay, Afterpay/Clearpay, or card when those methods are enabled under Checkout Settings (and Afterpay in the Square Dashboard). No extra setup per form.

One-time payment

1. Connect Square first.
2. Enable wallets under Checkout Settings → Merchant settings (Live mode).
3. Add a tag to your form:
   • Fixed amount: [square_pay amount:25.00]
   • Amount from a form field: [square_pay amount-field:your-amount]
4. Publish the form. After submit, the visitor pays on Square (with your enabled wallets) and returns with a success message.

Subscription signup

1. Create plans in Square and copy a plan ID from Subscription Plans.
2. Add a tag like: [square_subscribe variation:YOUR_PLAN_ID name:"Silver Membership" amount:15.00]

Note: Cash App Pay and Afterpay are for one-time CF7 payments only — not subscription signup.

WPForms

WPForms is optional. Use it for donations, fees, registrations, and similar forms with the familiar WPForms builder.

Payment methods: One-time WPForms payments also use Square Hosted Checkout. Visitors can pay with Apple Pay, Google Pay, Cash App Pay, Afterpay/Clearpay, or card — the same wallets as WooCommerce and Contact Form 7 when enabled in Checkout Settings.

One-time payment

1. Connect Square first.
2. Enable wallets under Checkout Settings → Merchant settings (Live mode).
3. Edit your form in WPForms → All Forms.
4. Add a Single Item payment field for the amount.
5. Add the Square Hosted Checkout field (under Payment fields).
6. Open Payments in the form builder and enable Payments Square Connect → One-time payments.
7. Publish the form. After submit, the visitor pays on Square (with your enabled wallets) and returns with a success message.

Subscription signup

1. Create plans in Square and copy a variation ID from Subscription Plans.
2. In the form Payments panel, enable Subscription signup and paste the Square plan variation ID.

Note: Cash App Pay and Afterpay are for one-time WPForms payments only — not subscription signup.

Fluent Forms

Fluent Forms Pro is required (payment module). Use the same Square connection as WooCommerce Square — you do not enter separate Square API keys in Fluent Forms.

Payment methods: One-time Fluent Forms payments use Square Hosted Checkout with Apple Pay, Google Pay, Cash App Pay, Afterpay/Clearpay, or card when enabled under Checkout Settings.

One-time payment

1. Connect Square first.
2. In Fluent Forms → Global Settings → Payment, enable the payment module.
3. Open Payment Methods and enable Payments Square Connect.
4. Create a form with payment item fields, a Payment Summary, and a Payment Method field.
5. In the Payment Method field, select Payments Square Connect / Square Hosted Checkout.
6. Publish the form. After submit, the visitor pays on Square and returns with a success message.

Note: Subscription items are not supported through this Square hosted checkout integration yet.

Subscription Plans

Open Payments Square Connect → Subscription Plans to:

• See plans from your Square account
• Click Refresh from Square after you add or change plans
• Copy plan IDs for Contact Form 7 tags, WPForms forms, or WooCommerce products

Good to know: some payment methods (such as Cash App Pay and Afterpay) are not available for subscription sign-up.

Checkout Settings (Beta)

Customize Square checkout for all payments created by this plugin — WooCommerce Square, Contact Form 7, WPForms, and Fluent Forms.

Live mode only — switch to Live on the Connect screen first.

• Merchant settings — turn on Apple Pay, Google Pay, and Cash App Pay for every hosted checkout from this plugin. Afterpay/Clearpay is enabled or disabled in the Square Dashboard (shown as read-only in the plugin).
• Location settings — customer notes, tipping, button style, store policy text

Requirements

• WordPress 6.0+
• PHP 7.4+
• A Square seller account
• WooCommerce — optional (for WooCommerce Square store checkout)
• Contact Form 7 — optional (for form payments)
• WPForms — optional (for form payments)
• Fluent Forms Pro — optional (for form payments)
• WooCommerce Subscriptions — optional (for recurring products)