Skip to content
Shahid Malla
Payment gateways In Stock

SM Square: Square Payment Gateway for WHMCS

Cards, Apple Pay, Google Pay, Cash App Pay, ACH and Square gift cards in one WHMCS gateway, with an admin dashboard for every payment, refund, saved card and dispute.

SM Square: Square Payment Gateway for WHMCS
WHMCS 9.1 tested, 8.10+ supported PHP 8.1+

SM Square connects WHMCS to Square and covers every way Square lets your clients pay online: cards, Apple Pay, Google Pay, Cash App Pay, ACH bank payments and Square gift cards. It comes in two parts. The payment gateway is what your clients use at checkout. The Payments Manager addon lives in your WHMCS admin area and shows every Square payment, refund, saved card, webhook and dispute. I built it on Square's current API version (2026-09-16) and tested it end to end on WHMCS 9.1.

In November 2026 I checked every Square module listed on the WHMCS Marketplace. None of them lists Apple Pay, Google Pay, Cash App Pay, ACH or gift cards, and none comes with an admin dashboard. As far as I can find, SM Square is the only Square module for WHMCS that does all of this in one package. The comparison table further down shows exactly what I checked.

What can your clients pay with?

Clients pay on a secure Square form that opens inside the normal WHMCS "Pay Now" page, on desktop and on mobile. Card details go straight to Square and never touch your server.

  • Cards, with 3-D Secure (Strong Customer Authentication) when the card's bank asks for it.
  • Apple Pay and Google Pay. Apple Pay appears in Safari once your domain is registered with Square, and the addon walks you through that step.
  • Cash App Pay, for US sellers billing in USD.
  • ACH bank payments from US bank accounts. The invoice shows the WHMCS "Payment Pending" status until the money clears, then it is marked paid on its own. If the bank payment fails, the invoice goes back to Unpaid.
  • Square gift cards, for the full invoice amount.
  • Saved cards. Clients can save a card at checkout, and WHMCS charges it automatically when a renewal invoice is due. Clients add, replace or remove cards under Payment Methods.

Each payment method has its own on/off switch in the gateway settings.

SM Square checkout on desktop and mobile with Google Pay, Cash App Pay, the Square card form, a save card option, ACH bank payment and Square gift card
The checkout on desktop and mobile: Google Pay, Cash App Pay, the card form, a "save this card" option, ACH and Square gift cards. Apple Pay appears in Safari.
SM Square payment form shown inside the standard WHMCS invoice payment page
The same checkout inside the standard WHMCS invoice payment page.
WHMCS invoice marked Payment Pending after an ACH bank payment through Square
After an ACH payment the invoice shows Payment Pending until Square confirms the money has cleared.

What do you see in the WHMCS admin area?

The Payments Manager addon (Addons, then SM Square) puts your Square activity next to your WHMCS billing, so you rarely need to open the Square Dashboard.

SM Square dashboard in WHMCS with money collected, success rate, refunds, Square fees, a 14-day chart, setup health and alerts
Dashboard: money collected, success rate, refunds and Square fees, a 14-day chart, a setup health check, recent activity and alerts for declines and new disputes.

Transactions. Every payment and refund is listed with who paid, the invoice, the card or payment method, the Square fee and the status. You can filter by status, method, source or date, search by Square ID, invoice number, name or email, and export to CSV.

SM Square transactions list with who paid, invoice, card, amount, Square fee, status and Square payment ID
Payments, refunds, saved card renewals, gift cards, ACH and declines in one list.

Transaction details. Open any transaction to see the WHMCS client and the cardholder, the card brand and last four digits, the CVV and address checks, Square's risk level, the fee and what you keep, and every Square ID with a copy button. A timeline shows the webhooks and refunds, and a form lets you refund all or part of the payment.

SM Square transaction detail showing who paid, card, CVV and address checks, Square fee, Square IDs, timeline and refund form
One payment in detail, with a partial refund already made and the webhooks Square sent.

Customers and cards. Every client linked to a Square customer and every saved card is listed with its expiry date and the WHMCS pay method it belongs to. You can disable a card, or pull a client's cards back from Square after a restore.

SM Square customers and saved cards linked to WHMCS pay methods
Saved cards, the WHMCS pay method each one belongs to, and when it was last charged.

Webhooks. One click creates the webhook subscription at Square and saves the signature key. The page shows the endpoint, the subscription and every event Square sent, with its result. If a webhook never arrives, a cron job finds the payment anyway.

SM Square webhooks page with the signed Square subscription and the events received
Signed webhooks from Square, each one checked and processed.

Disputes. Chargebacks are listed with the reason, the amount and the response deadline, and you get an email when one opens.

SM Square disputes list with client, invoice, amount, reason, state and response deadline
Disputes with the client, invoice and the date you must respond by.

Logs and settings. The log keeps a searchable record of what happened. With Debug Mode on, every Square API call is logged with tokens and card data removed. In Settings you choose how the module behaves: record refunds made in the Square Dashboard, sync Square fees, mark ACH invoices Payment Pending, show the Square panels on invoices and client profiles, and pick which email alerts you get.

SM Square debug log with Square API calls, refunds, webhooks and alerts
The log: Square API calls, refunds, webhooks and alerts, with secrets removed.
SM Square settings for fee sync, Square Dashboard refunds, Payment Pending, admin panels and email alerts
Settings for fees, refunds, pending payments, admin panels and alerts.

How does SM Square compare with other Square modules for WHMCS?

On 7 November 2026 I read the four Square gateway listings on the WHMCS Marketplace. "Not listed" means the listing does not mention the feature. A module may still have it, so ask its developer if it matters to you.

FeatureSM SquareOther Square modules (4 listings)
Card paymentsYesYes
3-D Secure (Strong Customer Authentication)Yes1 of 4, not for renewals
Apple Pay and Google PayYesNot listed
Cash App PayYesNot listed
ACH bank payments with "Payment Pending"YesNot listed
Square gift cardsYesNot listed
Saved cards for automatic renewalsYes2 of 4
Full and partial refunds from WHMCSYes1 of 4
Refunds made in the Square Dashboard recorded in WHMCSYesNot listed
Signed webhooks with one-click setupYesNot listed
Disputes (chargebacks) shown in WHMCSYesNot listed
Admin dashboard with who paid, fees and a timelineYesNot listed
Sandbox modeYes3 of 4
Built-in live test suiteYes, 20 stepsNot listed
Newest WHMCS version listed9.1 (tested)9.0

How can you test it before you take real money?

The addon includes a live test suite that runs 20 real payment steps against the Square sandbox and cleans up afterward. It covers a charge, a repeated request that must not charge twice, saving a card, a renewal charge on the saved card, partial and full refunds, a refund that is too large and must be refused, four kinds of decline, an ACH payment, a gift card payment and a webhook signature check. You can also run a single test charge and see the exact message a client would get.

SM Square sandbox live test suite with 20 steps passed
The 20-step sandbox test suite, all passing on WHMCS 9.1.

Before release I also tested it in a real browser on WHMCS 9.1. That covered new card payments, saved card payments through the normal WHMCS "Pay Now" page, automatic renewal charges, refunds from WHMCS and from the addon, ACH, gift cards, sandbox disputes, and webhooks delivered by Square to a public HTTPS address.

How does it prevent double charges and lost payments?

  • Every attempt is written to the module's own record before Square is called, so nothing is lost if the connection drops halfway.
  • Each charge and refund carries a Square idempotency key. A repeated request returns the original result instead of charging or refunding twice.
  • A lock on each invoice stops two payments from running for the same invoice at once, and a new charge is refused while an earlier one is still pending.
  • When Square's answer is unclear, for example after a timeout, the payment is checked again later. It is never treated as failed and charged a second time.
  • A payment can reach WHMCS from the checkout, a renewal, a webhook or the cron job. Whichever arrives first records it, and the others see that it is already there.

Does it work with the standard WHMCS screens?

Yes. It uses the normal WHMCS gateway settings with help text on every field, fills the WHMCS Transaction Information window with Square's details, and adds a Square panel to each invoice and client profile. A refund started from an invoice's Refund tab goes to Square like any other WHMCS refund.

SM Square gateway settings in WHMCS with production and sandbox credentials and a switch for each payment method
Gateway settings: separate production and sandbox credentials, a switch for each payment method, saved card behavior, checkout color and debug mode.
WHMCS Transaction Information window filled with Square payment details next to the Square panel on a WHMCS invoice
The WHMCS Transaction Information window filled from Square, next to the Square panel on the invoice.

What do you need before you switch it on?

Requirements: WHMCS 8.10 or newer (tested on 9.1), PHP 8.1 or newer, HTTPS on your WHMCS site (Square's payment form does not load without it) and a Square seller account. Your WHMCS invoice currency must match the currency of your Square location.

Limits: Square only works for businesses in the countries it supports. Cash App Pay and ACH are for US sellers billing in USD, and Apple Pay needs your domain registered with Square. Fees, payouts and disputes stay with Square under its terms. The module connects WHMCS to Square and does not change any of that.

Moving from another Square module: if your current module saved Square card IDs in WHMCS, the addon can move those saved cards over, so clients do not have to enter their cards again. A dry run shows what will change before anything does.

Licenses: both licenses are paid once for lifetime use. The Regular license ships encrypted. The Open Source license ships 100% unencrypted PHP, so you or your developer can read and change every line. Both include one year of updates and support, and seven days to ask for a refund.

The screenshots on this page come from a demo WHMCS 9.1 store connected to the Square sandbox. The clients in them are fictional.

Key features

  • Cards through Square's secure form, with 3-D Secure
  • Apple Pay, Google Pay and Cash App Pay
  • ACH bank payments with WHMCS "Payment Pending"
  • Square gift cards
  • Saved cards charged automatically for renewals
  • Full and partial refunds from WHMCS or the addon
  • Square Dashboard refunds recorded in WHMCS
  • Signed webhooks with one-click setup
  • Cron safety net for missed webhooks
  • Disputes with deadlines and email alerts
  • Payments Manager dashboard in WHMCS admin
  • Who paid, card, Square fee and every Square ID
  • Square panels on invoices and client profiles
  • 20-step sandbox live test suite
  • Debug log with tokens and card data removed
  • Saved card migration from another Square module

Why customers buy this module

  • →Every payment method Square offers online, in one WHMCS gateway
  • →See who paid, with which card, and what Square charged, without opening Square
  • →Renewals charge saved cards on their own, and pending bank payments are tracked until they clear
  • →Timeouts and retries never charge a client twice or credit an invoice twice
  • →Test the whole payment flow in the sandbox before you take real money

Frequently asked questions

Is SM Square the only Square module for WHMCS with wallets, ACH and an admin dashboard?

As far as I can find, yes. In November 2026 I checked the four Square gateway listings on the WHMCS Marketplace. None of them lists Apple Pay, Google Pay, Cash App Pay, ACH or Square gift cards, and none includes an admin dashboard for Square payments, webhooks or disputes. SM Square has all of these in one gateway and addon. The comparison table on this page shows each feature I checked.

Can SM Square charge recurring invoices automatically?

Yes. When a client saves a card at checkout, Square stores it and WHMCS keeps only a reference to it. When a renewal invoice is due, WHMCS charges that saved card through SM Square without the client doing anything. If a renewal charge fails, WHMCS retries it on the schedule in your WHMCS automation settings, and the addon shows the decline and the reason Square gave.

How do ACH bank payments work in WHMCS?

The client links a US bank account in Square's secure window and pays. Bank payments take a few business days to clear, so the invoice shows the WHMCS "Payment Pending" status in the meantime. When Square confirms the payment, the invoice is marked paid on its own. If the payment fails, the invoice goes back to Unpaid and you can be emailed about it.

Can I refund a Square payment from WHMCS?

Yes, in full or in part, either from the invoice's Refund tab or from the transaction page in the addon. The refund runs through Square and is recorded on the WHMCS invoice. Refunds you make in the Square Dashboard can be recorded in WHMCS automatically too, so both systems stay in step.

Does WHMCS store my clients' card numbers?

No. Clients type their card details into Square's own secure form, so card numbers go straight to Square and never reach your WHMCS server. WHMCS keeps only Square's card reference, the brand, the last four digits and the expiry date, which is what it needs to show the card and charge renewals.

Can I test SM Square before I take real payments?

Yes. Put the gateway in Sandbox mode with your Square sandbox credentials and run the 20-step live test suite from the addon. It charges, saves a card, renews, refunds, declines and checks webhook signatures against the Square sandbox, then cleans up. When everything passes, switch the gateway to Production.

Can I get the full source code?

Yes. The Open Source license gives you lifetime use of the 100% unencrypted PHP code for both the gateway and the addon, so your developer can read it, change it or connect it to your own tools. The Regular license ships encrypted. Both include one year of updates and support.

Technical specifications

WHMCS
9.1 tested, 8.10+ supported
PHP
8.1+
Square API
2026-09-16
Payment methods
Cards, Apple Pay, Google Pay, Cash App Pay, ACH, Square gift cards
Included
Payment gateway and Payments Manager admin addon
Needs
HTTPS on your WHMCS site and a Square seller account
License
Lifetime, 1 year of updates and support included
Open source license
Lifetime, 100% unencrypted PHP
Delivery
License key at purchase
Refunds
None, all sales are final

Related modules

$39 lifetime

Cash App Payment Gateway for WHMCS

I built this gateway so customers in the United States can settle WHMCS invoices with Cash App. Payments are checked and applied to the right invoice, payment requests go out by email, and anything that does not match waits for an admin to reconcile.

View details
$49 lifetime

Clover Card Payment Gateway for WHMCS

I built this gateway for businesses that run Clover in their shop and bill online in WHMCS. Cards are charged through the Clover API, saved as tokens for renewals, and payments can be refunded or voided without opening the Clover dashboard.

View details
$149 lifetime · $449 open source

Helium (HNT) Crypto Payment Gateway for WHMCS

I built this gateway so WHMCS can take Helium (HNT) payments wallet to wallet, with no payment processor in between. It quotes the HNT amount at a live rate, looks for the matching transaction on chain, and marks the invoice paid once your confirmation count is reached.

View details