How do I integrate PayFast with WHMCS?

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, do the following:

  1. Download the WHMCS payment module from our site.
  2. Unzip the module to a temporary location on your computer.
  3. 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.
  4. Log in to 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:

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:

  1. Log in to 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.

    • Related Articles

    • How do I integrate PayFast with UberCart?

      To integrate PayFast with UberCart, do the following: Download the PayFast module and extract the uc_payfast folder from the zip folder. Move or copy the folder called ”uc_payfast” into your /modules/ubercart/payment directory. Log in to the admin ...
    • How do I integrate PayFast with Shopify?

      To integrate PayFast with Shopify, do the following: Log in to your Shopify Store. Navigate to Settings. Under Third-party payment providers select PayFast and enter your PayFast Merchant ID and Key. To run PayFast in test/sandbox mode, select Use ...
    • How do I integrate PayFast with Zen Cart?

      In order to use PayFast with Zen Cart, you will need to install the PayFast payment module for Zen Cart which is provided by PayFast. Installation requirements A working Zen Cart installation Installation and testing To install the PayFast payment ...
    • How do I integrate PayFast with PrestaShop (hosted PrestaShop website)?

      In order to use PayFast with PrestaShop, you will need to install the PayFast payment module for PrestaShop, which is provided by PayFast. To install the PayFast payment module, do the following: Download the correct version for your PrestaShop ...
    • Why am I getting a signature mismatch error on WHMCS?

      If you are using a WordPress installation along with a WHMCS bridge plugin, the cause is that the WordPress plugin modifies the output of the values sent through to PayFast. In order to fix this, you need to comment out the signature generation part ...