WHMCS is a simple-to-use web hosting automation system. If you manage a web hosting site with WHMCS, FedaPay offers an integration plugin to collect payments easily. Here’s how to install and configure it.

1

Install the Plugin

Before starting, follow these simple steps to install the plugin:

  1. Create a FedaPay account by signing up here.

  2. Download the FedaPay WHMCS plugin available on GitHub here.

  3. Once downloaded, you will need to copy the files into the appropriate folders in your WHMCS system.

File Structure to Copy :

modules/fedapay/
  callback/fedapay.php
  fedapay-php/
  fedapay.php
  • Copy the fedapay-php/ folder and fedapay.php file into the modules/gateways/ folder of your WHMCS installation.

  • Copy the contents of the callback/ folder into modules/gateways/callback/.

2

Configure the Plugin in WHMCS

Once the plugin files are installed, follow these steps to configure FedaPay in WHMCS :

Step 1: Access Payment Settings

  • In your WHMCS dashboard, go to Setup > Payments > Payment Gateways.

  • Click on the All Payment Gateways tab to view the full list of available payment gateways.

  • In the list, select FedaPay to activate it.

Step 2: Activate and Configure FedaPay

  • Check the box Show on Order Form to allow your customers to see FedaPay on the order form.

  • If you are in test mode, check the Sandbox Mode box. Otherwise, leave it unchecked for live transactions.

Step 3: Retrieve and Enter Your API Keys

  • Log in to your FedaPay Sandbox (test) and FedaPay Live (real) accounts.

  • Copy the secret API keys for each mode:

    • sk_sandbox for the test mode.

    • sk_live for the real mode.

  • Paste these keys into the corresponding fields in WHMCS.

Step 4: Save Changes

Click Save to save your changes.

3

Add XOF (FCFA) Currency

To allow your customers to pay in FCFA (XOF), you need to add this currency in WHMCS.

  • In the Payments menu, click on Currencies.

  • Modify the default currency or add XOF as a new currency.

4

Finalize Configuration

You have now completed the FedaPay configuration for WHMCS. Your payment gateway is ready to accept payments via Mobile Money and credit cards.