Start a conversation

How do I upgrade WHMCS?

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 receive will give them the option to Subscribe tokenized billing. Depending on your desired setup following invoices can be automatically charged as they are generated by WHMCS.

  1. Deactivate the PayFast plugin.

    • Under Setup > Payments > Payment Gateways next to PayFast click 'Deactivate'.
    • Note: You may need to select a temporary payment option such as offline credit card.
  2. Remove all plugin files on your hosting server as follows:
    modules/gateways/payfast.log
    modules/gateways/payfast.php
    modules/gateways/payfast/adhoc.php
    modules/gateways/payfast/payfast_common.inc
    modules/gateways/payfast/v5_include.php
    modules/gateways/payfast/v6_include.php
    modules/gateways/callback/payfast.php
    includes/hooks/payfastchargesubscription.php
    includes/hooks/payfastviewinvoice.php
  3. See 'Standard Upgrade Procedure' below.
Standard Upgrade Procedure
  1. Download the WHMCS payment module from our site.
  2. Unzip the module to a temporary location on your computer.
  3. Copy the 'modules' folder from the archive to your base “whmcs” folder (using FTP program or similar). 
    • This should should ONLY overwrite existing 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 WHMCS Administrator console.
  5. Using the main menu, navigate to Setup > Payment Gateways.
  6. Enter the following details under the 'PayFast' heading: 
    • Merchant ID
    • Merchant Key
    • (Required for Recurring Billing) PassPhrase
  7. Click 'Save Changes'.
Choose files or drag and drop files
Helpful?
Yes
No