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, do the following:
- Download the WHMCS payment module from our site.
- Unzip the module to a temporary location on your computer.
- Copy the modules and includes folders 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.
- Log in to the WHMCS Administrator console.
- Using the main menu, navigate to Setup > Payment Gateways.
- Select PayFast from the Activate Gateway drop-down list and click Activate.
- Enter the following details under the PayFast heading:
- Merchant ID
- Merchant Key
- Test Mode
- 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:
modules/gateways/callback/payfast.php modules/gateways/payfast.php modules/gateways/payfast.log modules/gateways/payfast/payfast_common.inc modules/gateways/payfast/images/light-small-paynow.png modules/gateways/payfast/images/light-small-subscribe.png
Going live
In order to make the module “live”, do the following:
- Log in to the WHMCS Administrator console.
- Using the main menu, navigate to Setup > Payment Gateways.
- Under the PayFast heading, uncheck the Test Mode item
- Click Save Changes.