← Documentation

Billing connection guide

Connect your billing system to VPN Dashboard.

Keep products, payments and customer accounts where they are. The module updates VPN access when an order or service changes.

Ready-madeSeven billing modules
Download fromYour client area
Before launchComplete the connection checks

Custom systems

Connect through the billing API.

If there is no module for your billing system, a developer can connect its account and service changes to the API. Direct customer sign-in is available through a separate signing secret.

The API reference covers authentication, request signing, safe retries and the identifiers each request needs.

Open the API reference →

Module updates

Plan updates around your order processing.

Read the release notes and back up the existing module files and settings before an update. Install the new files during a maintenance window, then check the connection before reopening orders.

If the update fails, restore the previous version and settings. Keep API tokens and signing secrets out of backups that leave the billing server.

01

Download

Choose the module for your billing system.

Sign in to your VPN Dashboard account and download the current package for Blesta, WHMCS, WooCommerce, Paymenter, Clientexec, WISECP or FOSSBilling.

Sign in to download
02

Connect

Install it on your billing server.

Follow the installation instructions included with the download. In VPN Dashboard, create a billing connection and copy the dashboard URL and billing API token into the matching module fields. Add a signing secret when the module provides signed requests or direct customer login.

Protect account changes.Configure request signing where provided, or add the billing server’s public IP address to the connection allow-list. Keep every token and secret private.
03

Create a product

Choose what the product includes.

Match a product or package to VPN Dashboard and set its profile allowance. Depending on the module, you can also set protocols, traffic, profile rotation and shared or dedicated server access.

Shared access

Use your normal server pool. This suits most VPN plans.

Dedicated access

Reserve one or more assigned servers for the service. Access remains pending until suitable capacity is assigned.

04

Launch checks

Confirm the connection is ready.

Open the module and dashboard status pages before publishing the product.

  1. The module reports a successful connection to the correct dashboard.
  2. The product mapping shows the intended profile allowance and access type.
  3. Request signing or the billing-server IP restriction is configured.
  4. The customer area is available securely over HTTPS.
  5. The dashboard shows a connected VPN server with available capacity.

Using another billing system?

Use the billing API reference to build a custom connection. If you use one of the seven supported billing systems, install the module provided for it.