# Replace 'whmcs' with any identifier you like
pveum token add whmcs whmcs-token --privilege=Administrator

token: whmcs!whmcs-token
value: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

curl -k -H "Authorization: PVEAPIToken=whmcs!whmcs-token=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6" \
     https://YOUR_PROXMOX_HOST:8006/api2/json/nodes

mkdir -p /path/to/whmcs/modules/servers/proxmox

<?php
/**
 * WHMCS Proxmox Server Module
 *
 * @package    WHMCS
 * @subpackage Module/Server/Proxmox
 */

use WHMCS\Module\Server\Proxmox\ProxmoxAPI;

if (!defined("WHMCS")) {
    die("This file cannot be accessed directly");
}

/**
 * Module Configuration Array
 *
 * @return array
 */
function proxmox_config()
{
    return [
        'FriendlyName' => ['Type' => 'System', 'Value' => 'Proxmox VE'],
        'api_host' => [
            'FriendlyName' => 'Proxmox Host',
            'Type' => 'text',
            'Size' => '25',
            'Description' => 'Hostname or IP of your Proxmox VE server (e.g., proxmox.example.com)',
        ],
        'api_port' => [
            'FriendlyName' => 'API Port',
            'Type' => 'text',
            'Size' => '5',
            'Default' => '8006',
            'Description' => 'Port on which the Proxmox API listens (default 8006)',
        ],
        'api_token_id' => [
            'FriendlyName' => 'API Token ID',
            'Type' => 'text',
            'Size' => '30',
            'Description' => 'Token ID in the format user!token-name',
        ],
        'api_token_secret' => [
            'FriendlyName' => 'API Token Secret',
            'Type' => 'text',
            'Size' => '50',
            'Description' => 'Secret value generated when creating the token',
        ],
        'node' => [
            'FriendlyName' => 'Default Node',
            'Type' => 'text',
            'Size' => '20',
            'Description' => 'Proxmox node where VMs will be created (leave blank to let WHMCS choose)',
        ],
    ];
}

/**
 * Module Activation Hook
 *
 * @param array $params
 */
function proxmox_activate($params)
{
    // No special activation needed
}

/**
 * Module Deactivation Hook
 *
 * @param array $params
 */
function proxmox_deactivate($params)
{
    // No special deactivation needed
}

/**
 * Create a VM
 *
 * @param array $params
 * @return string
 */
function proxmox_create_account($params)
{
    $serverParams = $params['server'];
    $api = new ProxmoxAPI(
        $serverParams['api_host'],
        $serverParams['api_port'],
        $serverParams['api_token_id'],
        $serverParams['api_token_secret']
    );

    // Extract product configurable options
    $vmid = $params['configoption1']; // Assume configoption1 holds desired VMID (or 0 for auto)
    $hostname = $params['domain']; // WHMCS passes the domain as hostname
    $cores = $params['configoption2']; // Number of CPU cores
    $ram = $params['configoption3'] * 1024; // WHMCS stores RAM in MB, convert to MB for API
    $disk = $params['configoption4'] * 1024; // Disk in GB -> MB
    $template = $params['configoption5']; // Template ID (e.g., 'local:vztmpl/ubuntu-22.04-standard_22.04-1_amd64.tar.gz')

    // If VMID not set, let Proxmox assign next available
    if (empty($vmid) || $vmid == 0) {
        $vmid = $api->getNextVmid();
    }

    // Create the VM (using QEMU for simplicity)
    $api->createVm(
        $vmid,
        $hostname,
        $cores,
        $ram,
        $disk,
        $template,
        $serverParams['node'] ?? null
    );

    // Return success
    return "success";
}

/**
 * Suspend a VM
 *
 * @param array $params
 * @return string
 */
function proxmox_suspend_account($params)
{
    $serverParams = $params['server'];
    $api = new ProxmoxAPI(
        $serverParams['api_host'],
        $serverParams['api_port'],
        $serverParams['api_token_id'],
        $serverParams['api_token_secret']
    );

    $vmid = $params['serviceid']; // WHMCS passes the service ID as VMID
    $api->setVmStatus($vmid, 'stop');

    return "success";
}

/**
 * Unsuspend a VM
 *
 * @param array $params
 * @return string
 */
function proxmox_unsuspend_account($params)
{
    $serverParams = $params['server'];
    $api = new ProxmoxAPI(
        $serverParams['api_host'],
        $serverParams['api_port'],
        $serverParams['api_token_id'],
        $serverParams['api_token_secret']
    );

    $vmid = $params['serviceid'];
    $api->setVmStatus($vmid, 'start');

    return "success";
}

/**
 * Terminate a VM
 *
 * @param array $params
 * @return string
 */
function proxmox_terminate_account($params)
{
    $serverParams = $params['server'];
    $api = new ProxmoxAPI(
        $serverParams['api_host'],
        $serverParams['api_port'],
        $serverParams['api_token_id'],
        $serverParams['api_token_secret']
    );

    $vmid = $params['serviceid'];
    $api->deleteVm($vmid);

    return "success";
}

/**
 * Change Package (upgrade/downgrade)
 *
 * @param array $params
 * @return string
 */
function proxmox_change_package($params)
{
    // For simplicity, we treat change as a suspend + create with new specs
    // In a production module you would resize the existing VM.
    proxmox_terminate_account($params);
    return proxmox_create_account($params);
}

/**
 * Admin Dashboard Output (optional)
 *
 * @param array $params
 * @return string
 */
function proxmox_admin_panel($params)
{
    return '<div class="panel panel-default"><div class="panel-heading">Proxmox VE Server</div><div class="panel-body">Module is active.</div></div>';
}

<?php
if (!defined("WHMCS")) {
    die("This file cannot be accessed directly");
}

class ProxmoxAPI
{
    protected $host;
    protected $port;
    protected $tokenId;
    protected $tokenSecret;
    protected $baseUrl;

    public function __construct($host, $port = 8006, $tokenId, $tokenSecret)
    {
        $this->host = rtrim($host, '/');
        $this->port = $port;
        $this->tokenId = $tokenId;
        $this->tokenSecret = $tokenSecret;
        $this->baseUrl = sprintf("https://%s:%d/api2/json", $this->host, $this->port);
    }

    /**
     * Make a GET request
     */
    private function get($endpoint)
    {
        $url = $this->baseUrl . $endpoint;
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // For self‑signed certs; adjust in production
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            "Authorization: PVEAPIToken={$this->tokenId}={$this->tokenSecret}",
            "Content-Type: application/json"
        ]);
        $result = curl_exec($ch);
        curl_close($ch);
        return json_decode($result, true);
    }

    /**
     * Make a POST request
     */
    private function post($endpoint, $data = [])
    {
        $url = $this->baseUrl . $endpoint;
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            "Authorization: PVEAPIToken={$this->tokenId}={$this->tokenSecret}",
            "Content-Type: application/json"
        ]);
        $result = curl_exec($ch);
        curl_close($ch);
        return json_decode($result, true);
    }

    /**
     * Get next available VMID
     */
    public function getNextVmid()
    {
        $res = $this->get('/cluster/nextid');
        return $res['data'] ?? null;
    }

    /**
     * Create a VM (QEMU)
     */
    public function createVm($vmid, $hostname, $cores, $ramMb, $diskMb, $template, $node = null)
    {
        $node = $node ?? $this->getFirstNode();
        $payload = [
            'vmid' => $vmid,
            'name' => $hostname,
            'cores' => $cores,
            'memory' => $ramMb,
            'net0' => 'virtio,bridge=vmbr0',
            'scsi0' => sprintf("%s:%d", $template, $diskMb),
            'ostype' => 'l26',
            'boot' => 'order=scsi0;net0',
        ];
        $this->post("/nodes/{$node}/qemu", $payload);
    }

    /**
     * Set VM status (start/stop/shutdown)
     */
    public function setVmStatus($vmid, $action)
    {
        $node = $this->getNodeForVm($vmid);
        $this->post("/nodes/{$node}/qemu/{$vmid}/status/{$action}", []);
    }

    /**
     * Delete a VM
     */
    public function deleteVm($vmid)
    {
        $node = $this->getNodeForVm($vmid);
        $this->post("/nodes/{$node}/qemu/{$vmid}", ['delete' => 1]);
    }

    /**
     * Retrieve the first node (used when none is specified)
     */
    private function getFirstNode()
    {
        $res = $this->get('/nodes');
        if (!empty($res['data'])) {
            return $res['data'][0]['node'];
        }
        throw new Exception('No nodes found in Proxmox cluster');
    }

    /**
     * Find which node a VM resides on
     */
    private function getNodeForVm($vmid)
    {
        $res = $this->get('/cluster/resources?type=vm');
        foreach ($res['data'] as $vm) {
            if ((int)$vm['vmid'] === (int)$vmid) {
                return $vm['node'];
            }
        }
        throw new Exception("VMID {$vmid} not found on any node");
    }
}

*/5 * * * * php /path/to/whmcs/admin/cron.php

<?php
if (!defined("WHMCS")) {
    die("This file cannot be accessed directly");
}

add_hook('AfterPaymentConfirmation', 1, function($vars) {
    $invoiceId = $vars['invoiceid'];
    // Load invoice details to see if it's a hosting product
    $invoice = Capsule::table('tblinvoices')
        ->join('tblinvoiceitems', 'tblinvoiceitems.invoiceid', '=', 'tblinvoices.id')
        ->where('tblinvoices.id', $invoiceId)
        ->first();

    if ($invoice && $invoice->type == 'Hosting Account') {
        $serviceId = $invoice->serviceid;
        // Trigger provisioning via WHMCS API
        $result = localAPI('AcceptOrder', ['serviceid' => $serviceId]);
        // Optionally log
        if ($result['result'] == 'success') {
            logActivity("Proxmox VM provisioned immediately after payment for service ID {$serviceId}");
        }
    }
});