WHMCS Plugin
How to install and configure iPaymu Direct Payment for WHMCS.
Introduction
What is WHMCS?
WHMCS (Web Host Manager Complete Solution) is a hosting business automation platform widely used by:
- Hosting Providers
- Domain Registrars
- Web Agencies
- IT Professionals
- Developers
Key Features of WHMCS
- Billing Management
- Payment Management
- Order Management
- Customer Support
- Reporting
- Domain Registration
- Hosting Provisioning
- Fraud Protection
- Customer Account Management
Beyond hosting, WHMCS can also be used for other products such as VPS, VPN, Email Hosting, Game Server, Domain Service, and other digital products.
Requirements
Pre-Installation Requirements
Before getting started, make sure:
- WHMCS is installed
- You have an iPaymu account
- You have your API Key and VA Number
- You have FTP or SSH access to your server
Step 1: Download the Plugin
Download the WHMCS plugin from the iPaymu Plugin page.

Step 2: Manual Installation
File Structure
After extracting the plugin, you will find the following files and folders:
callback/
ipaymu/
ipaymu.phpInstallation Steps
- Copy the entire contents of the
callback/folder to:
/modules/gateways/callback/- Copy the following files and folders:
ipaymu/
ipaymu.phpto:
/modules/gateways/Step 3: Activate the Module in WHMCS
- Go to Settings → Apps & Integrations.

- Select Browse → Payments.

- Find iPaymu Direct Payment, then click Activate.

- Once activated, the Active status will appear. Click Manage.

Step 4: Configure iPaymu
- Enter the following configuration:
| Field | Value |
|---|---|
| Environment | Sandbox or Production |
| VA Number | Your iPaymu account VA Number |
| API Key | Your iPaymu account API Key |
- Click Save Changes.

Sandbox Mode
Use Sandbox mode for testing before switching to Production mode.
Step 5: Configure Products
- Set up the Product Name, Description, and Product Display.

- Create a Product Group, then add a Product.

- Configure Product Pricing as needed, for example:
- Monthly
- Quarterly
- Semi Annually
- Annually

Step 6: Purchase Simulation
- The customer selects a product, then clicks Order Now.

- The customer proceeds to Checkout.

- Under Payment Details, select iPaymu Direct Payment, then click Complete Order.

Step 7: Invoice Payment
- The invoice is created and the Pay button appears.

- The customer is redirected to the iPaymu payment page.

Step 8: Payment Status
- After successful payment, the invoice shows a success status.

- The invoice status changes to PAID.

Error Handling
If the invoice amount does not meet the requirements or there is a configuration error, the system will display an error message.

Troubleshooting Tips
- Make sure your API Key and VA Number are correct.
- Ensure the Environment is set correctly (Sandbox for testing, Production for live).
- Verify that the callback URL is accessible from the iPaymu server.