Description
Square Payment Integration for WHMCS
Square Payment Integration for WHMCS connects your WHMCS billing system with your Square merchant account, allowing customers to make secure card payments without being redirected to an external checkout page.
The module supports one-time invoice payments, securely stored payment methods, automated recurring charges, refunds, and sandbox testing. It provides a convenient payment experience for customers while helping administrators automate invoice collection and payment management.
Integrated Square Card Checkout
The Square payment form is displayed directly within the WHMCS payment flow using Square’s Web Payments SDK. Card details are securely tokenized by Square and are not stored as raw card information inside WHMCS.
Core Features
- On-Site Card Payments: Let customers enter their payment details without leaving your WHMCS website.
- Secure Card Tokenization: Process card information through Square’s official payment technology.
- One-Time Payments: Accept immediate card payments against unpaid WHMCS invoices.
- Saved Payment Methods: Allow customers to securely save a Square card token for future payments.
- Automated Recurring Billing: Charge saved payment methods through the standard WHMCS automated billing process.
- Payment Method Management: Let clients add saved cards and update their payment method descriptions from the WHMCS client area.
- Square Refund Support: Process eligible full or partial payment refunds from WHMCS.
- Automatic Invoice Updates: Apply successful transactions to the correct WHMCS invoices.
- Transaction Logging: Record successful and failed Square API activity for administrative review.
- Sandbox Environment: Test card payments and configuration before enabling live processing.
Saved Cards and Recurring Payments
Customers can choose to save their card during payment or add a new payment method from their WHMCS account. The module stores Square customer and card references as remote tokens, allowing WHMCS to process future invoice payments without storing complete card details locally.
This makes the integration suitable for hosting plans, SaaS subscriptions, maintenance services, and other businesses that depend on automated recurring invoice collection.
Refund Management
Administrators can submit eligible refunds through WHMCS using the original Square transaction reference. Refund results and Square refund IDs are returned to WHMCS for easier payment administration and record keeping.
Automatic Location Selection
After entering a valid Square Application ID and Access Token, the module retrieves available Square locations that have credit-card processing enabled. Administrators can then select the appropriate merchant location directly from the gateway configuration.
Supported Currencies and Regions
Currency availability depends on the selected Square merchant location and the countries supported by your Square account. Your WHMCS processing currency should match the currency enabled for that Square location. WHMCS currency conversion settings may be used when your store offers additional currencies.
Customer Experience
- Choose Square when paying a WHMCS invoice.
- Enter card details through the integrated Square payment form.
- Optionally save the card for future invoice payments.
- Receive an immediate result after the payment is processed.
- Manage supported saved payment methods from the client account.
Admin Configuration
- Connect Square using an Application ID and Access Token.
- Select a credit-card-enabled Square merchant location.
- Switch between sandbox and production environments.
- Review successful and failed activity through WHMCS gateway logs.
- Process recurring charges and eligible refunds through WHMCS.
Why Choose This Integration?
- Smoother Checkout: Customers can pay without being redirected away from your website.
- Recurring Revenue Support: Use saved Square payment methods for automated WHMCS billing.
- Reduced Manual Work: Automate payment capture and invoice updates.
- Flexible Testing: Validate your setup using Square’s sandbox environment.
- Convenient Administration: Manage payments, transaction records, and refunds through WHMCS.
Ideal For
- Web hosting and domain businesses
- SaaS and subscription providers
- Digital agencies and service companies
- Businesses already using Square for payment processing
- WHMCS stores requiring one-time and recurring card payments
Requirements
- An active WHMCS installation
- An active Square developer and merchant account
- Square Application ID and Access Token
- A Square location enabled for credit-card processing
- A valid SSL certificate and HTTPS-enabled WHMCS website
- An active module license
Conclusion
Square Payment Integration for WHMCS provides a complete card-payment workflow for businesses using Square. With integrated checkout, tokenized saved cards, recurring billing, refunds, sandbox testing, and automatic invoice handling, it offers customers a convenient way to pay while reducing day-to-day billing work for administrators.
