Skip to main content

Integrate WHMCS


WHMCS integration is available only for 2Checkout accounts that handle their own tax and invoice management. Contact 2Checkout for additional information.

WHMCS Settings

Perform the below set of instructions in your WHMCS account to integrate it with 2Checkout.

  1. Sign in to your WHMCS admin.
  2. Navigate to the payment gateway configuration page and enable 2Checkout.
  3. Enter your 2Checkout Account Number (SID).
  4. Enter your Secret Word (Must be the same value entered in your 2Checkout Control Panel).  To obtain the Secret Word, contact 2Checkout or, if you already have a 2Checkout account, navigate to Control Panel: → Integrations → Webhooks & API → Secret Word → INS Secret word.
  5. Enter your API username and password (an additional user that you set up in your 2Checkout account). The API username will require both “API Access” and “API Updating” permissions. Check this article to learn how to create API roles.
  6. Disable the “Add Funds” option.
  7. Navigate to Setup → General Settings → Credit, and un-tick the “Enable” box.

Your Secret Word  and your  Buy-Link Secret Word must match (they must have the same value) in your 2Checkout Control Panel and your WHMCS admin. Since WHMCS does not support special characters, but only letters (a-z) and digits, you can use a code generator to obtain a Secret Word that needs to be saved both in the 2checkout Control Panel and the WHMCS admin. 

The Secret Word  and your Buy-Link Secret Word can be found in your Merchant Control Panel,  under Webhooks & API → Secret Word → INS Secret word.

2Checkout Settings

Follow the below instructions in your 2Checkout Control Panel to finalize the WHMCS integration process.

  1. Sign in to your 2Checkout account.
  2. Navigate to Dashboard → Integrations → Webhooks & API section
  3. Follow these steps to activate Redirect URL:
  4. In the Webhooks and API section, under the Instant Notification Service (INS) card, check the Enable Global URL box. 
  5. Enter as the global endpoint URL.
  6. Save your changes.

Make sure the plugin installation is made as per the path described by the directory names in the URL endpoint above. The installation of the plug-in in the root directory will result in a communication mismatch.

Test orders via WHMCS

You can place test orders when using the WHMCS connector by following these steps:

1. Log into your WHMCS account and select the checkbox shown in the image below.

2. Since this is an account set-up, the selection will apply to all your orders, so all your orders will be test orders. When you are ready to start transacting real orders, simply uncheck this box.


WHMCS is an all-in-one client management, billing & support solution for online businesses. Handling everything from signup to termination, WHMCS is a powerful business automation tool that puts you firmly in control.

For more information visit:

  • Was this article helpful?