Start a conversation

How do I integrate PayFast with WHMCS?

In order to use PayFast with WHMCS, you will need to install the PayFast payment module for WHMCS which is provided by PayFast.

Installation requirements

  • A working WHMCS installation

Installation and testing 

To install the PayFast payment module, follow the instructions below:

  1. Download the WHMCS payment module from our site.
  2. Unzip the module to a temporary location on your computer.
  3. Copy the 'modules' folder from the archive to your base 'whmcs' folder (using FTP program or similar).
    • This should NOT overwrite any existing files or folders and merely supplement them with the PayFast files.
    • This is, however, dependent on the FTP program you use.
    • If you are concerned about this, rather copy the individual files across as per instructions below.
  4. Log into the WHMCS Administrator console.
  5. Using the main menu, navigate to Setup ? Payment Gateways.
  6. Select 'PayFast' from the 'Activate Gateway' drop-down list and click 'Activate'.
  7. Enter the following details under the “PayFast” heading:
    • Merchant ID
    • Merchant Key
    • Test Mode
  8. Click 'Save Changes'.

Copying the individual files across

If you are concerned that copying the entire folder from the downloaded module may overwrite files in your installation, rather copy the files from the extracted module individually into your installation.

Be sure to copy the files from the downloaded module to their corresponding locations within your installation:

The list of files needed in your online installation is as follows:


Going live

In order to make the module “LIVE”, follow the instructions below:

  1. Log into the WHMCS Administrator console.
  2. Using the main menu, navigate to Setup > Payment Gateways.
  3. Under the 'PayFast' heading, uncheck the 'Test Mode' item
  4. Click 'Save Changes'.

Recurring Billing
 To enable recurring billing on WHMCS, please follow the instructions found here.

Choose files or drag and drop files