PUQ Mikrotik VPN provisioning module

PUQ Mikrotik VPN provisioning module

Developed By PUQ Software

Compatible with WHMCS v9.0

The Mikrotik VPN WHMCS module is a provisioning module that integrates WHMCS with Mikrotik routers, enabling Internet and VPN service providers to offer VPN accounts to their customers. The module automates the full lifecycle of VPN account management using the Mikrotik API only.

Main features

  • Automatic account provisioning — auto create and deploy client VPN accounts on the Mikrotik router upon order activation
  • Account lifecycle management — create, suspend, unsuspend, terminate, change package, change password, and reset VPN interface
  • Bandwidth control — configurable download / upload speed limits (M/s) enforced by the Mikrotik PPP profile
  • Metric billing — post-paid usage-based billing for incoming and outgoing traffic (GB) via standard WHMCS MetricProvider
  • Atomic traffic statistics — daily and monthly traffic charts with Google Charts, with atomic database increments preventing race condition losses
  • Multi-language support — 26 languages including Arabic, Azerbaijani, Catalan, Chinese, Croatian, Czech, Danish, Dutch, English, Estonian, Farsi, French, German, Hebrew, Hungarian, Italian, Macedonian, Norwegian, Polish, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian
  • Client area integration — customers can view the VPN server address, available protocols, credentials with copy-to-clipboard, connection status, bandwidth limit and traffic statistics
  • Admin area tools — administrators can view license status, Mikrotik API connection status (with 15s timeout protection), product information and manage VPN accounts via standard WHMCS module buttons
  • IP address pool — the module distributes IP addresses from the list specified in the WHMCS server settings; both private and public IPs are supported
  • Configurable protocol support — independent toggles for PPtP, L2TP (with IPSec PSK), OpenVPN, and SSTP protocols with custom instruction HTML per protocol
  • Instruction and client links — optional URLs to VPN setup manuals and client downloads displayed as action buttons in the client area
  • License verification — built-in license system with online / offline verification and admin alerts

System requirements

Requirement Minimum WHMCS 8.x+, 9.x+ PHP 7.4, 8.1, 8.2, 8.3, 8.4 Mikrotik RouterOS 7.x or higher ionCube Loader v15+

Important: The module registers opposite values for upload and download speeds in the Mikrotik router compared to WHMCS settings, because Mikrotik measures incoming traffic while VPN clients experience outgoing traffic. Proper Mikrotik router configuration is essential (NAT, firewall, routing, and all required VPN server settings).

Links

  • Product page: https://puqcloud.com/whmcs-module-mikrotik-vpn.php
  • Documentation: https://doc.puq.info/books/mikrotik-vpn-whmcs-module
  • Support: https://puqcloud.com/submitticket.php
  • Community: https://community.puqcloud.com/

 

Reviews

5 stars
0
0
4 stars
1
1
3 stars
0
0
2 stars
0
0
1 star
0
0
Osama Al-Shawaf avatar

Osama Al-Shawaf @osama5381

December 21, 2022 at 04:46:16 PM

Great Module for self hosted VPN and their support level is good.

Ruslan Polovyi avatar

Ruslan Polovyi @puq2756

January 4, 2023 at 12:36:28 PM

Thank you for your review and 4 stars motivate us to be even better and get 5 in the future ;-)

Owner@PUQ Software  
  • 3 years ago
  • Version Number 1.1

Version Compatibility


Compatible with WHMCS v9.0

Full Version Compatibility


  • All versions of WHMCS v9.0
  • All versions of WHMCS v8.13
  • All versions of WHMCS v8.12
  • All versions of WHMCS v8.11
  • Selected versions of WHMCS v8.10
        8.10.0
  • Selected versions of WHMCS v8.9
        8.9.0
  • Selected versions of WHMCS v8.8
        8.8.0
  • All versions of WHMCS v8.7
  • All versions of WHMCS v8.6
  • All versions of WHMCS v8.5
  • All versions of WHMCS v8.4
  • All versions of WHMCS v8.3
  • All versions of WHMCS v8.2
  • All versions of WHMCS v8.1
  • All versions of WHMCS v8.0

System Requirements


  • WHMCS: 8.x+, 9.x+
  • PHP: 7.4, 8.1, 8.2, 8.3, 8.4
  • ionCube Loader: v15+
  • Mikrotik RouterOS: 7.x

* Requirements listed are in addition to the WHMCS default system requirements.

Support for this product

The best place to start if you need help with a specific product is to contact the developer. All WHMCS Marketplace developers have both a website and support URL listed.

Developed By PUQ Software

Changelog

v4.1.0 Released September 30th, 2026

Latest Version


  • Resilient Daily Cron & Usage Synchronization. Usage updates and traffic metric collection during WHMCS automation runs are now completely isolated per account with comprehensive diagnostic logging. A temporary connection hiccup or offline router will never interrupt the billing run for your other customers.
  • Strict PHP 8.2+ Compatibility & Type Hardening. Resolved typed property assignment issues across package speed and bandwidth configurations, ensuring seamless and crash-free execution on modern PHP 8.1, 8.2, and 8.3 environments.
  • Zero-Touch Configuration Auto-Migration. Existing products configured on previous versions automatically upgrade their parameters into the modern unified settings format directly in the database upon editing, eliminating manual reconfiguration.
  • Enhanced WHMCS 9 Admin Experience. Refined dynamic module settings detection for Select2 interfaces, providing instant and responsive controls in the WHMCS 9 administrator panel.
  • Clean Module Logging. Excluded local database license verification checks (License_Verification (db)) from the WHMCS Module Log, recording exclusively online verification calls to keep diagnostic logs clean.

 

Previous Versions


v4.0.0 Released September 22nd, 2026

View/hide detailed changelog

  • Atomic traffic statistics collection. Replaced read-modify-write logic with atomic SQL increments (Capsule::raw) in StatisticsSaveTraffic(), eliminating race conditions and traffic data loss during concurrent WHMCS cron jobs and metric queries.
  • WHMCS Usage Billing MetricProvider fix. Resolved zero-traffic reporting so that Usage(0.0) is reliably returned when usage is 0 GB, preventing "No usage data" statuses in WHMCS.
  • Unified interface reset action. Removed redundant resetConnection action and button, standardizing on a single, clean Reset VPN Interface button across admin and client interfaces.
  • Admin API connection timeout. Enforced a strict 15-second timeout on router status checks with offline circuit breaker, eliminating admin panel hangs on unreachable Mikrotik routers.
  • Guzzle HTTP Client integration. Migrated all external API and license verification requests from legacy cURL to \GuzzleHttp\Client with exponential backoff and retry mechanism.
  • ionCube 15 & PHP 8.2+ architectural upgrade. Transitioned hooks.php to an unencoded lightweight bootstrap delegating logic to lib/puqMikrotikVPNHooks.php for seamless ionCube 15 compatibility.
  • Automated usage cleanup on termination. Local usage statistics in puqMikrotikVPN_statistics are now automatically purged when a service is terminated.
  • Enhanced Client Area UI. Integrated standard PUQ client area UI toolkit with header.tpl, dynamic copy-to-clipboard buttons, toast notifications, CSRF protection, and streamlined responsive layout.
  • Legacy configuration fallback. Added transparent backward compatibility for products migrating from older configuration slots (configoption2..11).
  • Comprehensive localization. Standardized translation strings across all 26 supported languages with safe typographic apostrophes and full Ukrainian language support.

 

v3.1.1 Released June 2nd, 2026

View/hide detailed changelog

  1. Full support for the latest RouterOS 7.21.4. The module has been verified end-to-end against the newest Mikrotik firmware, so you can confidently run your VPN services on up-to-date, secure routers.

  2. Rock-solid router communication. Connections to your Mikrotik devices are now even more reliable — requests that could previously stall on certain firmware versions complete instantly, keeping provisioning and management fast and dependable.

  3. Stay current with peace of mind. Whether you are deploying brand-new routers or upgrading existing ones to the latest RouterOS, your VPN automation keeps working smoothly out of the box.

  4. PHP 7.4 support is back. The module runs flawlessly on PHP 7.4 once again, so customers on established hosting stacks can keep their proven setup without rushing a server upgrade. We will continue to support PHP 7.4 for as long as it remains technically possible.

 

v3.1 Released April 20th, 2026

View/hide detailed changelog

  • Improved stability across the WHMCS admin area. Rare page-loading errors that could appear on some admin screens (for example when opening a support ticket on installations with non-standard file layouts, symlinks or custom hosting paths) have been eliminated. The admin panel now loads smoothly in every environment.
  • Greater compatibility with complex hosting setups. The module is now fully resilient to WHMCS installations using symlinked directories, multi-domain hosting and custom include paths.
  • Smoother day-to-day operation for administrators. Fewer interruptions, no unexpected "Oops!" pages, and a more predictable experience when working with tickets, clients and services — so your team can focus on customers, not on troubleshooting.

 

v3.0 Released February 1st, 2026

View/hide detailed changelog

  1. Support for WHMCS 9+
  2. Product module settings have been redesigned ⚠️ Product reconfiguration is required after update
  3. Updated client area interface design
  4. Remote ability to have traffic-based packages has been removed; instead, a post-paid traffic billing model has been implemented using standard WHMCS metrics.

Product reconfiguration is required after update

 

v2.2 Released January 24th, 2025

View/hide detailed changelog

  1. The product configuration method has been redesigned.
  2. Added a configuration option in the product settings to display custom HTML in the client panel based on the VPN protocol.

IMPORTANT: After the update, all products using this module must be completely reconfigured.

 

v2.0 Released September 23rd, 2024

View/hide detailed changelog

Module is coded ionCube v13

Supported php version:

  • php 7.4 WHMCS 8.11.0 -
  • php 8.1 WHMCS 8.11.0 +
  • php 8.2 WHMCS 8.11.0 +

Changelog:

  1. Client area more adapted for mobile version
  2. Buttons for copying login and password have been added to the client area

 

v1.3.5 Released October 11th, 2023

View/hide detailed changelog

  1. Support WHMCS v8.8.0
  2. Translations added/updated (Arabic, Azerbaijani, Catalan, Chinese, Croatian, Czech, Danish, Dutch, English, Estonian, Farsi, French, German, Hebrew, Hungarian, Italian, Macedonian, Norwegian, Polish, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian)

 

v1.3 Released February 4th, 2023

View/hide detailed changelog

  1. Changed client side. Added intuitive icons.
  2. Better code adaptation for PHP 8.1
  3. Bug fixed (Attempt to assign property "bytes_upload" on string in...puqMikrotikVPN.php:632)

 

v1.2 Released January 4th, 2023

View/hide detailed changelog

  1. Support WHMCS V8.6
  2. Support IonCube PHP Loader v12 
  3. Support for PHP 8.1
  4. Changes made to templates
  5. Added the ability to select the frequency of collecting traffic statistics. Daily cron and per cron
  6. The method of collecting statistics has been changed. After each collection of statistics, the counters on Mikrotik are reset to zero.
  7. In the service settings, the choice of email template was changed to a drop-down menu.

 

v1.1 Released October 27th, 2022

View/hide detailed changelog

  1. Changes in design in the client area.
  2. Added translations, Ukrainian, Persian
  3. Changed the selection of the ppp secrets profile from text to a drop-down menu with a choice of spend, in the product configuration

 

v1.0 Released August 1st, 2022

View/hide detailed changelog

First version

 

See also

Hetzner Servers Manager

Integrate manager for Hetzner Dedicated

Commercial
Liquid Web VPS & Cloud Dedicated Reseller Program

Resell VPS & Cloud Dedicated Products from Liquid Web

Free
SolusVM WHMCS module

Automate the sale of VPS servers & give your clients the ability to completely manage their VPS server inside of WHMCS, using the industry leading SolusVM control panel.

Free
Acronis Cyber Protect Cloud

AI-Powered Integration of Data Protection and Cybersecurity.

Free
VPN reseller module

Resell VPN accounts with whitelabel Windows, Mac, IOS and Android software

Free