Skip to main content

Integrate WHMCS


WHMCS integration is available only for 2Checkout accounts that handle their own tax and invoice management (2Sell and 2Subscribe accounts). 

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 the INS Secret Word from the 2Checkout Merchant Control Panel. After logging in to your 2Checkout account, navigate to Control Panel: → Integrations → Webhooks & API → Secret Word → INS Secret word
  5. Your INS secret word should be the same as your buy-link secret word (found under Dashboard → Integrations → Webhooks & API, scroll down to the Secret Word area, as shown in the image below). Edit your INS secret word and buy-link secret word to match each other, then copy and paste them into the WHMCS admin.
  6. INS secret word.png

  7. 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.
  8. Disable the “Add Funds” option.
  9. Navigate to Setup → General Settings → Credit, and un-tick the “Enable” box.

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. 

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?