WP eCommerce

The WP eCommerce Plugin is everything you need to sell anywhere. Convert visitors into customers with a beautiful online store and a secure shopping cart.

WP eCommerce

Key Features

  • WordPress integration
  • Powerful and customisable
  • SEO friendly
  • Shipping calculation

Integration

Kindly see the WP eCommerce documentation for anything related to installation, configuration and account management.

See PayFast integration

How do I use PayFast with WordPress?

You can use PayFast with WordPress by installing WP e-Commerce, which is an e-Commerce plugin for WordPress.

This will give your WordPress site, e-Commerce capabilities and we then provide a payment module for WP e-Commerce which will enable you to accept payments from WP e-Commerce using PayFast.

How do I use PayFast with WP e-Commerce?

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

What are the installation requirements?

  • A working WordPress installation with the WP e-Commerce plugin installed

INSTALLATION AND TESTING

How do I install the PayFast module?

Manual Method

To install the PayFast payment module, 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 the “wp-content” folder in the archive to your base “wordpress” 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. Login to the WordPress Administrator console
  5. Using the main menu, navigate to Settings ? Store
  6. Using the WP e-Commerce menu, navigate to “Payments”
  7. Under “General Settings”, check the PayFast item and click “Update”
  8. Click the Edit Option for PayFast, the PayFast options will then be shown in the right hand tab.
  9. Ensure that the following details are set correctly:
    • Status for Pending Payments: Incomplete Sale
    • Status for Successful Payments: Accepted Payment
  10. Leave everything else as per default and click “Update”
  11. The module is now and 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

HOW DO I COPY 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:

template/ext/wp-e-commerce/wpsc-merchants/payfast.log
template/ext/wp-e-commerce/wpsc-merchants/payfast.php
template/ext/wp-e-commerce/wpsc-merchants/payfast_common.inc
Using WordPress Plugin System (plugin version 1.31 only)

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

  1. Download the payment module from our site
  2. Unzip the module to a temporary location on your computer
  3. Go to WordPress”s plugin page
  4. Select to install a new plugin using a file
  5. When prompted for a file, select the “payfast-wp-e-commerce.zip” file from your temporary location
  6. Login to the WordPress Administrator console
  7. Using the main menu, navigate to Settings ? Store
  8. Using the WP e-Commerce menu, navigate to “Payments”
  9. Under “General Settings”, check the PayFast item and click “Update”
  10. Click the Edit Option for PayFast, the PayFast options will then be shown in the right hand tab.
  11. Ensure that the following details are set correctly:
    • Status for Pending Payments: Incomplete Sale
    • Status for Successful Payments: Accepted Payment
  12. Leave everything else as per default and click “Update”
  13. The module is now and 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

HOW CAN I TEST 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 login 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, Instant EFT or Ukash 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.

I”M READY TO GO LIVE! WHAT DO I DO?

In order to make the module “LIVE”, follow the instructions below:

  1. Login to the WordPress Administrator console
  2. Using the main menu, navigate to Settings ? Store
  3. Using the WP e-Commerce menu, navigate to “Payments”
  4. Under “General Settings”, highlight the PayFast item and click the “edit” link
  5. In the right hand tab, change the configuration values as below:
    • Transaction Server = “LIVE”
    • Merchant ID = Integration Page>
    • Merchant Key = Integration Page>
    • Debugging = Off
  6. Change the other fields as per your preferences
  7. Click Save

See Upgrading and FAQs

UPGRADING

Standard Upgrade Procedure
  1. Download the payment module from our site
  2. Unzip the module to a temporary location on your computer
  3. Copy the “wp-content” folder in the archive to your base “wordpress” folder
1.00 >> 1.10
  1. Follow the Standard Upgrade Procedure above
  2. Login to the WordPress Administrator console
  3. Using the main menu, navigate to Products ? Settings
  4. Using the WP e-Commerce menu, navigate to Payment Options
  5. On the right hand side, ensure that:
    • “Status for Pending Payments” is set to “Order Received”, and
    • “Status for Successful Payments” is set to “Accepted Payment”
  6. Click “Update” to save
1.10 >> 1.20

Follow the Standard Upgrade Procedure above.

1.20 >> 1.21

Follow the Standard Upgrade Procedure above.

1.21 >> 1.22

Follow the Standard Upgrade Procedure above.

1.22 >> 1.30

Follow the Standard Upgrade Procedure above and additionally

  1. Using the WP Settings ? Store page, navigate to Payments
  2. On the right hand side, ensure that the following PayFast settings have been set as follows:
    • “Status for Pending Payments” is set to “Order Received”, and
    • “Status for Successful Payments” is set to “Accepted Payment”
  3. Click “Update” to save
1.30 >> 1.31

Follow the Standard Upgrade Procedure above.

FREQUENTLY ASKED QUESTIONS (FAQS)

What is the payment flow?

PayFast works on browser redirection and will redirect the user to PayFast for payment after they click the “Make Payment” button on the Checkout page.

At this stage, the order has already been created in WP e-Commerce with the status “Incomplete Sale”.

If the payment is CANCELLED during processing on PayFast:

  • The user will be returned to the “Transaction Results” page
  • The order status will be left as “Incomplete Sale”

If the payment is SUCCESSFUL through PayFast:

  • The user will be returned to the “Transaction Results” page
  • The order status will be updated to the status as specified in the configuration (default = “Payment Accepted”)

Do I need to set the ITN url on my account?

No. 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.

WordPress gives the error “invalid plugin” when I try an install your module!

Our plugin is not a plugin for WordPress itself, but for WP e-Commerce, which is itself an eCommerce plugin for WordPress.

To integrate with PayFast, you will need to install WP e-Commerce first. Once you have installed WP e-Commerce, you can then install the PayFast payment module for WP e-Commerce provided by PayFast as detailed above.

Where is my “base WordPress folder”?

This is the root of your WordPress 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 WordPress directory structure.

The base (or root) WordPress 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 WordPress folder”.

Directory structure of base WordPress folder

I upgraded WordPress/WP e-Commerce and now “PayFast” no longer appears as a payment option!

When upgrading either WordPress or WP e-Commerce, the PayFast payment module files may be deleted.

You simply need to reinstall the module following the installation procedures above and the “PayFast” option will reappear with your previous setting intact.

I”ve installed the module, but PayFast still doesn”t appear as an option!

Are you using the “Gold Cart for WP e-Commerce” paid-for extension to WP e-Commerce?

If so, you will need to move the PayFast files to a different location to have PayFast appear as a payment method.

Move the individual PayFast module files from:

template/ext/wp-e-commerce/merchants

to:

template/ext/gold_cart_files_plugin/merchants

in your installation. This will resolve your issue and PayFast will then appear as a payment method within Gold Cart for WP e-Commerce.

How do I get prices to show with the symbol “R” as opposed to “ZAR”?

You need to update the symbol for the currency. This needs to be done directly on your database (eg. through phpMyAdmin) by running the following query:

UPDATE `wpsc_currency_list` SET `symbol` = ''R'', `code` = ''ZAR'' WHERE `country` = ''South Africa'';

USEFUL LINKS