VPN Dashboard
← WooCommerce integration

Installation guide

Connect WooCommerce to VPN Dashboard.

Install the WordPress plugin and connect products, variations and Woo Subscriptions events.

Packagevpn-dashboard-woocommerce.zip
Install inwp-content/plugins/vpn-dashboard
Provider keywoocommerce
01

Install

Put the module in the right place.

  1. Download the WooCommerce ZIP from Integration downloads in your VPN Dashboard account.
  2. Upload the plugin in WordPress, or copy vpn-dashboard into wp-content/plugins.
  3. Activate VPN Dashboard for WooCommerce and open WooCommerce, VPN Dashboard.
Download it from your account.Module packages are private and the current ZIP is available under Integration downloads after sign-in.
02

Connect

Add the dashboard connection.

  1. Enter the HTTPS address of your hosted dashboard.
  2. Enter the billing API token, SSO signing secret and webhook signing secret from the matching billing connection in VPN Dashboard.
  3. Keep the provider key as woocommerce, add the WordPress server public IP to the billing API allow-list and use Test connection.
Use one matching provider key.The module, billing connection and customer sign-in settings must use woocommerce.
03

Product

Set up the VPN product.

  1. Edit a WooCommerce product and enable VPN Dashboard product.
  2. Set Profiles per unit and choose shared or dedicated server access. A variation can override both values.
  3. For recurring products, use Woo Subscriptions if you want subscription state changes to update VPN access automatically.
04

Customer access

Add the customer-area link.

When enabled, WooCommerce My Account shows a VPN service link that opens the customer VPN area through a signed URL.

Keep the SSO signing secret private. Change it in both systems if it is ever exposed.

Configuration reference

Settings used by WooCommerce.

Connection settings apply to the module. Product settings apply to each plan.

Connection settings6 fields
Dashboard URLRequired HTTPS address
The address of your hosted VPN Dashboard, without an API path.
Billing API tokenRequired secret
Copy the token from the matching billing connection in VPN Dashboard.
SSO signing secretRequired, at least 32 characters
Signs the short-lived link that takes a customer from their billing account to the VPN area.
Webhook signing secretBlank or at least 32 characters
Signs write requests from the module. Leave it blank only when the billing server IP is enforced through the API allow-list.
Provider keywoocommerce
Must match the provider key on the billing connection and customer sign-in settings.
Customer areaShown by default
Controls whether VPN Dashboard appears in WooCommerce My Account.
Product settings5 fields
VPN Dashboard productOn or off
Enable it only on products that should create VPN access.
Profiles per unit1 to 10,000
Multiplied by the WooCommerce order quantity to produce the profile allowance.
Server accessShared or dedicated; shared by default
Dedicated services wait for dedicated VPN server capacity.
Variation profiles per unitOptional override
A variation can replace the parent product profile quantity.
Variation server accessParent, shared or dedicated
A variation can inherit or replace the parent product server-access setting.

Service lifecycle

What WooCommerce sends.

Processing or completed orderCreates or updates active VPN access.
On-hold or failed orderSuspends VPN access.
Cancelled or refunded orderCancels VPN access.
Subscription active, on-hold, cancelled or expiredUpdates access when Woo Subscriptions supplies the event.

Before launch

Check the complete order path.

  1. The module connection check succeeds.
  2. The product creates the expected profile allowance and server access type.
  3. The customer link opens the correct branded VPN area.
  4. Suspension and restoration update the same service.
  5. Cancellation removes access from the same service.

Module notes

Details specific to WooCommerce.

  • Order quantity multiplies Profiles per unit.
  • Automatic recurring lifecycle changes require Woo Subscriptions.
  • Other WordPress subscription plugins are not handled automatically.

Ready to install?

Download the WooCommerce module from your account.

The package and its version details are kept under Integration downloads.

Sign in to download