This article assumes that you are already logged in as an admin, if you are not, please login to WHMCS dashboard.

1. First, you need to establish whether the payment gateway module you want to include comes with WHMCS by default or you need to add it manually.

2. To view the payment gateway modules that are included in WHMCS by default, navigate to “Setup” at the top menu bar and hover on it for a drop-down submenu to appear. Locate “Payments” and hover on it for a second submenu to appear and select “Payment Gateways“.

3. If you are accessing “Setup” for the first time since you logged in, you might have to input your admin password for security purposes.

4. Click on “All Payment Gateways, and you will see a list of all payment gateways available for you. You are not going to configure all of them but a few (mostly one or two), that are available for your country and the ones that you like and have registered with.

If a gateway that you want to register with is not among the list, you need to inquire from your payment service provider whether they have a WHMCS module and if yes, how to upload it. Nevertheless, there is a common way to install that many payment service providers adhere to as per how WHMCS is designed. The module is installed in the “gateways” directory which is inside the “modules” directory that is found at the root of your WHMCS installation. In simple terms, this is the path: “[whmcs root directory]/modules/gateways/[your gateway files]“.

Apart from that you need a callback file to receive notifications when a payment is made. This file(s) is located at the “callback” folder inside the “gateways” directory. So you will have your callback path as: “[whmcs root directory]/modules/gateways/callback/[your gateway callback files]”

5. Once you have all your files uploaded, navigate back to “all the payment gateways” page as in step 2 to 4. You should see your payment gateway listed. Click on it and it will activate the gateway and take you to the “Manage Existing Gateways” page.

6. Fill in the gateway settings details as provided by your payment service provider, and save the changes.

To manage the gateway, let’s say you want to deactivate or change the settings, just navigate back to the payment gateways page as outlined in step 2 through 4 but on step 4 click on “Manage Existing Gateways“.