Square Payment Gateway
Square payment integration for WHMCS
The Square Payment Gateway is a WHMCS payment gateway module that lets you accept credit card payments through Square. It handles one-time invoice payments and recurring renewal charges, stores cards as Square tokens instead of raw card numbers, retries failed charges automatically and lets you issue refunds from the WHMCS admin area.
What the Square Payment Gateway does
It connects WHMCS invoices to your Square account so card payments, renewals and refunds all run through one processor.
- One-time and recurring payment support: customers can pay a single invoice, and saved cards are charged when renewal invoices come due.
- Secure tokenization: Square stores the card and returns a token, so WHMCS keeps a reference rather than the card number.
- Automatic payment retry for failed transactions: if a renewal charge fails, the module tries again instead of leaving the invoice to go overdue.
- Refund support from WHMCS admin: refund a Square payment from the invoice without logging in to Square.
- Customer card management: customers can manage the cards saved for their account.
- PCI compliant payment processing: card data is processed by Square, which reduces how much sensitive card data your own server handles.
Who it is for
The Square gateway suits businesses that already use Square, or want to, and bill customers through WHMCS. Hosting companies, web agencies and IT service providers that take in-person payments with Square can keep their online invoices in the same Square account.
It is especially useful for recurring services. Because cards are tokenized and charged on renewal, monthly hosting or support plans get paid on time without customers logging in each cycle.
How it works in WHMCS
Square becomes a card payment option in WHMCS, and the WHMCS cron takes care of renewals.
- Create or open your Square seller account and get the API credentials for your application.
- Upload the module, activate Square under Payment Gateways in WHMCS and enter your credentials.
- A customer pays an invoice by card. Square processes the payment and returns a token that WHMCS saves to the client's account.
- When the daily cron generates a renewal invoice, WHMCS charges the saved card through Square.
- If a charge is declined, the module retries it automatically, and WHMCS sends its usual payment failure emails.
- To refund, open the invoice in WHMCS admin and issue the refund; it is sent back through Square.
You do not have to move every client at once. WHMCS stores a default payment method per client, so you can make Square the default for new orders and switch existing clients when they next update their card.
Requirements and compatibility
You need WHMCS 8.13 on PHP 8.1 or newer and a Square seller account.
Square is only available to businesses in certain countries, so confirm you can open a Square account before you buy, and make sure your WHMCS invoice currency is one your Square account can accept. PCI responsibilities depend on your whole setup; tokenization reduces card data on your server but does not replace your own security practices.
Licensing, updates and support
The Square Payment Gateway costs $79 once for a lifetime license.
One year of updates and support is included. You receive an instant download and a license key, with a 7-day refund window.
Related modules and services
If you run Clover hardware instead, see the Clover payment gateway for WHMCS. Customers who prefer Cash App can be served with the Cash App gateway. Read the comparison of WHMCS payment gateways, see all payment gateway modules, or let us handle the setup with our WHMCS payment gateway integration service.
Key features
- One-time and recurring payment support
- Secure tokenization
- Automatic payment retry for failed transactions
- Refund support from WHMCS admin
- Customer card management
- PCI compliant payment processing
Frequently asked questions
Does the Square gateway support recurring payments in WHMCS?
Yes. Cards are saved as Square tokens and charged automatically when WHMCS generates renewal invoices.
Are card numbers stored in WHMCS?
No. Square tokenizes the card, and WHMCS stores only the token used to charge it later.
Can I refund a Square payment from WHMCS?
Yes. Refunds are issued from the WHMCS admin area and processed back through Square.
What happens if a renewal charge fails?
The module retries failed transactions automatically, so a temporary decline does not have to become an overdue invoice.
Can customers manage their saved cards?
Yes. Customer card management lets clients update the cards saved on their account.
Do I need a Square account?
Yes. You need a Square seller account, and Square is only available in certain countries.
How much does the Square Payment Gateway cost?
$79 once for a lifetime license, including one year of updates and support, instant download and a 7-day refund window.
Technical specifications
- Module type
- Payment gateway module
- Requirements
- WHMCS 8.13, PHP 8.1+
- Delivery
- Instant download + license key
- Updates & support
- 1 year included