You’ll need a working installation of CS-Cart before you can integrate with PayFast. Kindly see their website for more information.

Installation and testing V4

To install the PayFast payment module, do the following:

1. Download the payment module.
2. Unzip the module to a temporary location on your computer.
3. Copy the app and design folders in the archive to your base CSCart folder.
   • 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 your Database Management System of choice and run the install.sql file.
5. Log in to the admin section of your CSCart installation.
6. Navigate to Administration > Payment Methods.
7. Click Add Payment.
8. Input a Name > PayFast, select Template > ‘cc_outside.tpl’, select Processor > PayFast, select Icon > Url and input https://www.payfast.co.za/images/logo.png, complete the form accordingly and click Create.
9. Once the payment method is created, click Edit.
10. Click Configure, select the sandbox mode and click Save.
11. The module is now ready to be tested with the Sandbox. To test with the sandbox, use the following login credentials when redirected to the PayFast site:
    • Username: sbtu01@payfast.co.za
    • Password: clientpass

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 are as follows:

CS-Cart V4

Testing that it is working correctly

If you followed the installation instructions above, the module is in ‘test’ mode and you can test it by purchasing from your site as a buyer normally would. You will be redirected to PayFast for payment and can log in with the user account detailed above and make payment using the balance in their wallet.

You will not be able to directly ‘test’ a credit card or Instant EFT payment in the sandbox, but you don’t really need to. The inputs to and outputs from PayFast are exactly the same, no matter which payment method is used, so using the wallet of the test user will give you exactly the same results as if you had used another payment method.

Going live

In order to make the module ‘live’, do the following:

1. Log in to the admin section of your CSCart system.
2. Navigate to Administration > Payment Methods.
3. Under PayFast, click Edit.
4. In the Configure section, use the following settings:  
   • Set Sandbox/Live = ‘Live’
   • Merchant ID = ‘merchant_id available on Integration Page‘
   • Merchant Key = ‘merchant_key available on Integration Page‘
5. Click Save.