Key Features
-
Credit & Debit Card Payments
Accept major credit and debit cards directly through WiPay from your WHMCS checkout page.
-
Fully Integrated with WHMCS Invoicing
Payments are processed via WiPay and invoices are automatically marked as Paid inside WHMCS.
-
Secure Payment Handling
Card details are handled by WiPay’s secure payment page or API. WHMCS never stores card data directly.
-
Simple Admin Configuration
Add your WiPay API credentials, enable the gateway, and you’re ready to receive payments.
-
Support for Existing WHMCS Order Flow
Works with standard WHMCS invoices, order forms, and client area “Pay Now” buttons.
-
Test / Live Environment
Easily switch between test and live mode while configuring and validating the module (if supported by your WiPay account).
Why Use WiPay with WHMCS?
If your business already uses WHMCS for automation and billing, this module connects everything together:
-
No manual payment entries
-
No redirecting clients to random forms or custom pages
-
No confusion about which invoice is paid or pending
The module takes your WHMCS invoice, sends the amount to WiPay, and then updates the invoice after payment is completed. Smooth and fully automated.
How It Works (Client Flow)
- Client orders a product or service from your WHMCS site.
- WHMCS generates an invoice as usual.
- On the invoice, the client selects WiPay as the payment method.
- The module sends the payment request to WiPay using your API settings.
- The client pays via credit/debit card on the WiPay payment page (or embedded flow).
- WiPay processes the payment and returns the result back to WHMCS.
- WHMCS automatically marks the invoice as Paid and the service can be activated or renewed according to your automation settings.
Requirements
- A valid WiPay merchant account
- WHMCS (recommended: latest 8.x version)
- PHP version compatible with your WHMCS install
- Access to upload files via FTP or File Manager to your WHMCS installation
Installation
Upload the Gateway Files
Upload the module folder to: whmcs_root/modules/gateways/
The main gateway file (e.g. wipay.php) and optional callback file (e.g. wipaycallback.php) should be inside this directory.
Activate in WHMCS
- Login to WHMCS Admin
- Go to: Setup → Payments → Payment Gateways
- Under All Payment Gateways, find WiPay
- Click Activate
Configure Gateway Settings
After activation, click on WiPay in the Active Gateways list and enter:
- WiPay API key / secret
- Merchant ID / account details
- Test / Live mode
- Callback / return URL (if needed)
Assign WiPay to Products / Clients (Optional)
You can allow WiPay for all products or restrict it to specific products or client groups using WHMCS standard settings.
Recommended Callback Setup
If your module includes a callback file:
- Make sure the callback file (for example
wipaycallback.php) is uploaded tomodules/gateways/. - Set the callback URL in your WiPay dashboard to:
https://yourdomain.com/whmcs/modules/gateways/wipaycallback.php
Use Cases
- Hosting providers accepting card payments directly on WHMCS
- IPTV / VPN / SaaS subscriptions where instant invoice payment is required
- Any WHMCS-based business that wants to connect WiPay with automated billing
Summary
The WiPay WHMCS Payment Gateway Module turns your WHMCS into a fully connected payment system using WiPay’s card processing. You keep your existing automation, invoices and products in WHMCS, and simply plug in WiPay to handle secure card payments.
