WHMCS is the industry-standard billing and client management platform for web hosting
companies. If you're building a hosting business in Nigeria, here's exactly how to
configure WHMCS for Nigerian Naira billing with Paystack.
This is the exact setup we use at XclusiveCloud (xclusivecloud.com).
## Prerequisites
- WHMCS license (start with a Starter license at ~$15.95/month)
- cPanel/WHM hosting environment
- Paystack business account (verified with CAC documents)
- Your domain (e.g., xclusivecloud.com)
## Step 1: Install WHMCS
Upload WHMCS to your server root and run the installer:
bash
cd /home/username/public_html
unzip whmcs.zip
php install/install.php
During setup, configure:
- MySQL database credentials
- Admin username and password
- License key from whmcs.com
## Step 2: Configure Nigerian Naira Currency
In WHMCS Admin → Setup → Currencies:
1. Delete or deactivate USD as the default
2. Add Nigerian Naira:
- Currency: Nigerian Naira
- Code: NGN
- Prefix: ₦
- Suffix: (leave blank)
- Rate: 1.00 (set NGN as the base currency)
3. Set NGN as the **default currency**
## Step 3: Install Paystack Payment Module
Download the WHMCS Paystack module from:
https://github.com/PaystackHQ/paystack-whmcs
Upload to `/modules/gateways/` and activate in:
WHMCS Admin → Setup → Payment Gateways → Paystack
Enter your Paystack Live Secret Key and Public Key from your Paystack dashboard.
## Step 4: Configure Paystack Webhook
In your Paystack dashboard → Settings → API Keys & Webhooks:
Set webhook URL to:https://yourdomain.com/modules/gateways/callback/paystack.php
plaintext
This allows automatic invoice payment confirmation.
## Step 5: Create Nigerian Hosting Products
In WHMCS → Setup → Products/Services → Create Product:
Example: Shared Hosting - Basic
- Price: ₦3,000/month, ₦30,000/year
- Module: cPanel
- Welcome email: include cPanel login details
## Step 6: Configure Nigerian Tax (VAT)
Nigeria has 7.5% VAT. In WHMCS → Setup → Tax Rules:
- Tax name: VAT
- Rate: 7.5%
- Apply to: All taxable products
## Useful Customisations for Nigerian Market
php
// In /includes/hooks.php — add Naira formatting
add_hook('ClientAreaProductDetails', 1, function($vars) {
// Custom naira price display
});
Full guide and WHMCS config files at: xclusivecloud.com/blog/whmcs-nigeria-naira-setup
