Building a WHMCS Billing System for Nigerian Naira — Complete Setup Guide

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