How do I upgrade WHMCS?

How do I upgrade WHMCS?

Please 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.
  2. Navigate to Setup > Payments > Payment Gateways next to PayFast click Deactivate. Please note: You may need to select a temporary payment option such as offline credit card.
  3. 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
  4. 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 in to 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.

    • Related Articles

    • Why is WHMCS not processing transactions as complete?

      After updating your WHMCS application to the latest version, your transactions are no longer processed to completed status. This is due to the update process of WHMCS removing the callback file of PayFast. This file is payfast.php.   When you ...

    • Where is my 'base WHMCS folder'?

      This is the root of your WHMCS 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 WHMCS directory structure. The base (or root) WHMCS folder will ...

    • How do I set up crons on WHMCS?

      For instructions on crons and automation in WHMCS please see: https://docs.whmcs.com/Crons http://help.whmcs.com/m/64751

    • How do I integrate PayFast with WHMCS?

      In order to use PayFast with WHMCS, you will need to install the PayFast payment module for WHMCS which is provided by PayFast. Installation requirements A working WHMCS installation Installation and testing  To install the PayFast payment module, do ...

    • How do I set up Tax/VAT on WHMCS?

      For instructions on Tax/VAT Rules in WHMCS, please see:  https://docs.whmcs.com/Tax/VAT Please note: This resultant amount on the product, whether you select Tax Type Inclusive or Exclusive, will be used as the total amount that will be charged when ...