How do I integrate PayFast with WPJobBoard?

In order to use PayFast with WPJobBoard Plugin, you will need to install the PayFast payment module for WP Job Board Plugin which is provided by PayFast.

Installation requirements

• A working WordPress site with the WP obBoard plugin installed
• Currency will need to be set to South African Rands (ZAR) on WP Job Board. See here for details.

Installation and Testing

To install the PayFast payment module, follow the instructions below:

1. Download the PayFast payment module (v3 or v4).

2. Unzip the module to a temporary location on your computer.

3. Copy the ‘wp-content’ folder for the v3 or v4 module to your base ‘WordPress’ installation.

   • 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 into the WP Job Board Plugin back office console and activate the plugin.

5. Navigate to ‘Settings (WPJB)’ and select ‘Configuration’.

6. Scroll down to ‘Payment Methods’ and click ‘Edit’ for PayFast.
7. Select ‘Enable this payment method’.

8. The payment options will then be shown, select ‘Sandbox’, ‘Debug On’ and the ‘Pay Now’ button you prefer.

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

wp-content/plugins/wpjobboard/application/libraries/Payment/PayFast.php
wp-content/plugins/wpjobboard/application/libraries/Payment/payfast_common.inc
wp-content/plugins/wpjobboard/application/public/paynow-dark.png
wp-content/plugins/wpjobboard/application/public/paynow-light.png

Testing that it works 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 ayment 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’, follow the instructions below:

1. Log into the WP Job Board plugin back office.

2. Navigate to ‘Settings’ below ‘Job Board’.

3. Click the ‘Edit Payment Options’ button.

4. In the PayFast Settings block, use the following settings:

   • PayFast Sandbox/Live = ‘Live’

   • PayFast Merchant ID = Integration Page>

   • PayFast Merchant Key = Integration Page>

   • PayFast ITN Debug = Off

5. Click 'Save Changes'.