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

• A working osCommerce installation
• PHP cURL extension
  • Ask your host if you are not sure if this is available

To install the PayFast Website Payments payment module, please follow the instructions below:

1. Download the payment module from our site
2. Unzip the module to a temporary location on your computer
3. Copy and paste the files into your osCommerce installation as they were extracted
   • 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. Login to the osCommerce admin console
5. Navigate to Modules → Payment
6. Click on “PayFast Website Payments”
7. Click “Install” button
8. Click “Edit” button
9. Enable PayFast and enter necessary details
   • Merchant ID
   • Merchant Key
   • PDT Key
10. Click “Update”

After completing these instructions, the module is installed and ready to be used.

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 indiviudally 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:

catalog/includes/languages/english/modules/payment/payfast.php
catalog/includes/modules/payment/payfast.php

The osCommerce module currently uses PDT and not ITN.

Notwithstanding this though, when using the one of our payment modules, the ITN url is set automatically and you do not need to set it on your account manually.

This is the root of your osCommerce installation. Where this is, depends on what system you are using and where you are hosting.

The easiest way to find this though would be to look for the osCommerce directory structure.

The base (or root) osCommerce folder will look similar to the image shown below.

Simply find the folder in your installation which looks similar to this structure and that will be your “base osCommerce folder”.

The problem is that the PHP installation on your server does not have OpenSSL support enabled. This is required in order for your server to communicate securely with PayFast to receive payment information.

You can check this by creating a file called “phpinfo.php” in the root of your website with the following content:

phpinfo.php

<?php
echo phpinfo();
?>

Once you have done this, browse to the file in your browser. This will output information about your server's PHP installation to the screen. There should be a section entitled “OpenSSL” with a value showing “OpenSSL support = enabled” (Similar to the image below). If you are experiencing this problem, this section will either not be there, or will be set to disabled.

To correct this problem, your hosting provider will need to enable OpenSSL support within PHP.

To enable OpenSSL for PHP, please ask your hosting provider to consult PHP resources on how to achieve this or direct them to the following websites:

• Windows
  • http://huang.yunsong.net/2009/windows-php-openssl.html
• Linux
  • http://www.google.co.za/search?q=enable+openssl+php+linux