Billing adapter

WHMCS Module

The VMNexor WHMCS module connects WHMCS products and services to VMNexor provisioning, lifecycle actions, and customer service automation.

VMNexor documentation is actively evolving. Some features, wording, and screenshots may change during beta.

Role of the module

The WHMCS module is the first billing adapter for VMNexor. WHMCS handles ordering, invoices, and billing status, while VMNexor handles the actual infrastructure automation.

Architecture

WHMCS Product → WHMCS Module → VMNexor API → Proxmox Cluster

Supported lifecycle actions

  • Create service
  • Suspend service
  • Unsuspend service
  • Terminate service
  • Trigger reinstall where enabled
  • Synchronise service state with VMNexor

Product configuration checklist

  • Create or choose a WHMCS product
  • Assign the VMNexor server/module settings
  • Map the product to the correct VMNexor plan
  • Confirm allowed templates and reinstall policy
  • Test create, suspend, unsuspend, terminate, and reinstall before selling publicly

Required connection details

  • VMNexor panel URL
  • VMNexor API key or module credential
  • Product-to-plan mapping
  • Service custom fields required by the module
  • Network and template options expected by the selected plan

Recommended testing flow

  • Place a test order
  • Confirm the VM appears in VMNexor
  • Confirm the VM exists in Proxmox
  • Test customer power controls
  • Test suspend and unsuspend from WHMCS
  • Test termination on a disposable service
  • Test reinstall only after confirming template restrictions are correct

Important note

VMNexor is not designed to be locked to WHMCS long-term. WHMCS is one billing provider, with native billing and additional adapters planned for later revisions.