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:


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 Ecwid?

      To integrate Payfast with Ecwid, do the following: Log in to your Ecwid account. Navigate to Settings > Payment. Next to Credit or debit card click Choose payment processor. Select Credit card: Payfast. Enter your Payfast Merchant ID, Merchant Key ...
    • Does Payfast integrate with a Wix website?

      Unfortunately at this time Payfast doesn’t integrate directly with Wix, but there are ways around this. If you need a shopping cart system on your Wix website you can use Ecwid. Ecwid provides shopping cart functionality to platforms like WordPress, ...
    • How do I upgrade WHMCS?

      Please Note: For Recurring Billing, if you already have subscriptions setup on your WHMCS site those subscriptions will continue to generate invoices as before until cancelled. In order to migrate your clients to the new module, the next invoice they ...
    • How do I integrate PayFast with Events Manager Pro?

      You’ll need a working installation of WordPress with Events Manager Pro before you can integrate with PayFast. Kindly see their website for more information. To install the PayFast module, do the following: Download the PayFast plugin. Upload the ...