License Setup

HmSingleOrderAddon requires a valid license key to operate. This page explains how to obtain your key, enter it in the addon settings, and troubleshoot license validation issues.

Obtaining Your License Key

Your license key is issued when you purchase HmSingleOrderAddon:

Go to hostmodules.com and complete your purchase
Your license key is emailed to you immediately after payment clears
You can also find it in your client portal under My Products → HmSingleOrderAddon → View Details

License keys follow this format:

HMSO-XXXX-XXXX-XXXX-XXXX

Entering Your License Key

Go to Addon Modules

In your WHMCS admin panel: System Settings → Addon Modules
Click Configure on HmSingleOrderAddon

Click the Configure button (gear icon) next to HmSingleOrderAddon.
Enter the license key

Paste your license key into the License Key field and click Save Changes.
Verify validation

After saving, the addon validates your license against HostModules’ license server. If valid, the addon becomes fully functional.

License Validation

The addon validates your license on each checkout page load (with server-side caching to prevent excessive requests). Validation checks:

The license key format
The key is active in the HostModules license database
The key is authorized for your WHMCS installation domain

License caching

Successful license validations are cached for 24 hours to prevent repeated remote calls. The cache is stored in the addon’s database table.

Staging & Development Domains

Your license is registered to your live domain. If you want to use the addon on a staging environment:

Log in to your HostModules client portal
Go to My Products → HmSingleOrderAddon → Manage
Add your staging domain as an allowed domain

Alternatively, contact support@hostmodules.com with your staging domain.

License Errors

Error	Cause	Solution
`License key not found`	The key doesn’t exist in the system	Verify you copied the key correctly
`Domain not authorized`	Your domain isn’t registered for this key	Contact support to update the authorization
`License expired`	Your subscription has lapsed	Renew your license in the client portal
`License inactive`	The license was manually deactivated	Contact support
`Unable to connect to license server`	Outbound HTTP from your server is blocked	Allow `api.hostmodules.com` in your firewall

Firewall requirements

The addon makes outbound HTTP requests to https://api.hostmodules.com for license validation. If your server’s outbound traffic is restricted, you must whitelist this domain.

Transferring to a New Domain

If you migrate your WHMCS installation to a new domain, update your license registration:

Log in to your client portal
Update the Allowed Domain for your license key to the new domain
Clear the license cache: go to WHMCS admin → Utilities → Clear Cache, or deactivate and reactivate the addon module

Allow a few minutes for the change to propagate before testing.