Frequently Asked Questions
Find answers to common questions about Powerlynx licensing, supported hardware, payment gateways, and system configuration.
🚀 General & Pricing
Cloud or on-premises?#
Powerlynx is fully cloud-based software. We do not offer the option to install it on your own server separately.
Do you provide a trial to test your software?#
Yes, we offer a 21-day trial so you can evaluate the Powerlynx software and determine if it suits your needs. During your license period, you can connect a maximum of 10 online customers.
How does pricing work?#
Our entry-level license is $100 for 400 online customers. This means you can keep a maximum of 410 online customers in Powerlynx with this license.
You can upgrade your license if needed. For example, if you plan to host 800 online customers, the cost will be $200, and your system can accommodate up to 810 online customers. Any additional customers beyond that limit will not be able to connect.
Can I change the URL of my Powerlynx account?#
Yes. To change the URL of your Powerlynx account, please contact our support team, and we will guide you through the process.
Please note that this option is only available to customers with an active subscription. It is not available during the trial period.
You can reach us at support@powerlynx.app
What do “hotspot”, “location” and “splash page” mean in Powerlynx?#
These are the terms you will meet most often in the admin panel:
| Term | What it means |
|---|---|
| Hotspot | The router or access-point controller that broadcasts the WiFi and decides who is allowed online. It talks to Powerlynx over RADIUS. |
| Location | A venue or site, for example “Airport lounge” or “Café”. A location groups its hotspots, splash pages, data plans, login options and payment gateways. |
| Splash page | The branded set of screens your guests see when they connect: the optional Welcome page, login, plan selection, extra customer information, and the status page, plus your logo, colors and background. |
| Data plan | What a guest can get: speed, duration, number of devices, price (or free) and how often it can be bought. |
| Voucher | A customer’s access on a data plan. Free plans, paid plans, access codes and Splynx logins all create a voucher, and the voucher is what lets the device online. |
Many settings can be made system-wide and overridden for a single location, so when something does not behave as expected, first check which location the guest connected through.
How do I set up a new venue from scratch?#
Work through these six steps in this order:
- Create the location under
Locations → Add: name, timezone and language. - Add the hotspot on the location's Hotspots tab: choose the connection type and enter the SSIDs it serves. See How to connect your MikroTik with Powerlynx or the guide for your router.
- Design the splash page under
Config → Splash pages, then link it to the location on the location's Splash pages tab. - Create data plans under
Plans, then enable them on the location's Plans tab. - Choose the login options on the location's Login options tab: phone number with OTP, guest login (optionally with a PIN), and so on.
- Enable payments: set up your gateways under
Config → Finance, then enable them on the location's Payment gateways tab. Skip this step if all plans are free.
A plan that is not enabled on the location, or a gateway that is not enabled on the location, will not appear to your guests. This is the most common reason a new venue looks “empty”.
📡 Network & Hardware Compatibility
What network devices do you support?#
Powerlynx supports network equipment that can handle external captive portals, RADIUS authentication, and can reach Powerlynx over WireGuard, OpenVPN, IPsec, or a public IP address.
The majority of our clients use MikroTik devices for their flexibility and compatibility. We also publish step-by-step setup guides for Cambium, Teltonika, Cudy, Ruckus, and TP-Link (Omada).
We generally support most OpenWrt-based routers and enterprise-grade hardware that allows external captive portal redirection and RADIUS integration.
❌ Some devices - like the Ubiquiti UniFi Dream Machine Pro and UniFi Cloud Gateway Ultra - are not supported, as they restrict external captive portals and third-party RADIUS authentication.
What devices do you recommend?#
We don't mandate specific hardware — the best fit depends on your coverage area, the number of simultaneous users you expect, and your client mix. For guidance by network size — controller (NAS) requirements, MikroTik model tiers (including virtual CHR), and examples for other supported vendors — see our forum guide: Network hardware — recommendations.
Can I connect my access point to Powerlynx?#
Yes, you can connect your access point (AP) to Powerlynx. However, you need to have a hotspot controller, such as a MikroTik router or Cambium router.
The general requirement for a hotspot controller is support for RADIUS and hotspot functionalities.
MikroTik routers are relatively inexpensive and make excellent hotspot controllers. Here’s how you can set it up:
- Connect the Hotspot Controller to Powerlynx: Follow the detailed guide available at How to connect your MikroTik with Powerlynx.
- Connect APs to the Controller: After connecting your MikroTik to Powerlynx, you can connect your APs (e.g., TP-Link, Ubiquiti) to the MikroTik router using VLANs (for example).
- Set Up Hotspot Server on Each VLAN Interface: Configure a hotspot server on each VLAN interface to efficiently manage and monetize your WiFi network through Powerlynx. If a single router or tunnel needs to serve several locations at once, use a Global hotspot instead of a per-location hotspot.
If your access points are also MikroTik, you can manage them all centrally from the controller with CAPsMAN — one wireless configuration pushed to every AP, so you add APs as you grow. See Powerlynx Hotspot with CAPsMAN (Simple Setup).
Useful links:
Can I run Powerlynx and Splynx on the same router at the same time?#
Yes, this type of setup is possible. You can find more information in our forum topic here.
How do I handle randomized MAC addresses on Android and iPhones?#
Mobile devices like Android and iPhone often use randomized MAC addresses for privacy reasons, which can make device identification challenging. Powerlynx can soften this with device fingerprinting - an identifier that helps recognise a returning device of a customer it already knows, even when the device presents a new MAC address.
Here's the same phone, signed in with the customer's phone number, connecting three times in one day. The MAC address is different every time, but the device ID (a hash generated from the device's characteristics) stays identical:
| Time | MAC presented | Device ID (first 8 of 40) |
|---|---|---|
| 09:12 | A2:1B:4F:C8 | 3f9c1ad7… |
| 13:40 | 7E:C0:91:22 | 3f9c1ad7… |
| 18:05 | D6:33:7A:1E | 3f9c1ad7… |
Because the device ID stays put, Powerlynx counts this as one device on the customer's account - it keeps its name, its history, and its allowance, no matter which MAC it shows up with.
How matches are decided:
| Situation | Result | What happens |
|---|---|---|
| MAC already known | Same device | Matched on MAC alone - the device ID isn't consulted, only refreshed on the record. |
| New MAC, device ID matches | Same device, new MAC | The existing device record is reused and its MAC is updated. No plan allowance is spent. |
| New MAC, no ID match | A genuinely new device | Added to the customer's list and counted against the plan's device limit. |
You can configure this under Config → Captive Portal, where two settings control the behavior (both off by default):
- Store fingerprints - collects device fingerprints so you can track what types of devices are connecting. Must be enabled before validation can be used.
- Validate fingerprints - actively matches incoming connections against stored fingerprints, using the logic above (so a known device with a new MAC doesn't use up another slot of the plan's device limit). Requires
Store fingerprintsto be enabled.
Note that fingerprint matching is scoped to a single customer account at a single location - the same physical device connecting at a second location is treated as a new, separate device record.
What fingerprinting does not do:
- It only works for a customer who has already identified themselves, for example by phone number. With Guest login, a device with a new MAC address is treated as a new customer.
- It does not survive the Logout button on the status page - logging out removes the device from the account, so its next connection starts fresh.
- It affects only the device limit. Time and data limits are not enforced by fingerprint.
- It does not make a randomized MAC permanent. When the phone changes its MAC, it may still be asked to sign in again; fingerprinting keeps that re-entry from counting as an extra device.
💳 Finance, Gateways & Vouchers
What payment gateways do you support?#
We are continually adding new integrations with payment gateways worldwide. Currently, we support Stripe, PayPal, Payfast, Netcash, 1Voucher, Safaricom MPESA, Vodacom M-PESA, DPO Pay, MTN MoMo, Paystack, Xendit, Selcom and M-PAiSA, and more.
More about supported payment gateways can be found here.
What happens when the customer reaches the data package limit?#
When a customer connects to WiFi, selects a 1GB plan, and reaches that 1GB limit, they will need to reconnect to the WiFi in order to select a new plan. The customer will not be automatically redirected to the plan selection page.
To address this, we have developed a feature that notifies your customer via SMS when they reach their traffic limit. You can configure it so that when 90% of the data is used, Powerlynx will send a notification to the customer, informing them that they will be disconnected soon and need to reconnect to purchase a new data package.
Can I assign a voucher to a customer manually?#
In certain situations, you may need to give a customer a voucher that isn’t offered on the splash page — a special-offer or employee voucher, or a replacement after a payment that didn’t complete.
The quickest way is straight from the customer:
- Open the customer under
Customers. - Go to the Vouchers tab and click Generate voucher. The customer is already filled in.
- Choose the data plan, the location and the expiration, then save.
The same form is available under Vouchers → List → Generate voucher, where you pick the customer yourself.
Because the voucher is assigned to that customer’s account, they don’t have to type a code: they reconnect, enter their phone number as usual, and Powerlynx activates the voucher for them. If you would rather hand them a code to type in, enable Login using access code for that location.
You can also generate a whole series of vouchers instead — see Vouchers — which is the better fit when you need printed cards rather than one voucher for one person.
For the case where a customer paid but never got online, see Payments and payment records.
Why can't a customer buy the same data plan again?#
Every data plan has a Usage limit that controls how often one customer may buy it. A plan the customer is not allowed to buy yet is hidden from the plan selection page, and an order for it is refused.
| Usage limit | The customer can buy the plan again |
|---|---|
| Unlimited | Any time |
| One time | Never, while the plan stays “One time” |
| Once per day | From the next midnight, in the timezone of your localization settings |
| Once per 24 hours | 24 hours after the purchase |
| Once per week / month / year | One week / calendar month / calendar year after the purchase |
| Custom | While fewer than the allowed number of purchases fall within the chosen period (for example 4 per 1 day) |
For a Custom limit that is used up, the plan is shown greyed out with the message “Usage limit reached. Available again at …”.
You set the limit in the Usage limit field of the data plan under Plans. The plan's current limit always applies, so switching a plan away from “One time” makes it available again to customers who bought it earlier.
⚙️ User Experience & Admin Options
What is the user experience like when the customer connects to the WiFi?#
In this screenshot, you can see six steps from entering your phone number to reaching the ads page. Steps 2, 4, and 5 are optional - if you’re offering free access, the system won’t redirect users to the payment page. Displaying ads and collecting additional personal information are also optional.

How can guests log in to my WiFi?#
You choose the login methods for each location under Locations → (your location) → Login options:
- Phone number - the guest receives an SMS code (OTP). You can also ask for a name and email. This requires a connected SMS gateway.
- Guest login - no phone number needed. For events you can put one shared PIN code in front of it, per location, and hand the PIN out on cards or signs. The PIN can contain letters and digits (1 to 32 characters) and is case-sensitive.
- Splynx account - customers of an ISP that uses Splynx sign in with their Splynx credentials.
- Access code - the guest enters a voucher code from a card, an SMS or a reseller.
Do I need to connect SMS gateways to Powerlynx in order to send SMS?#
Powerlynx does not come with an in-built SMS gateway. You'll need to connect third-party SMS gateways to Powerlynx.
For more information on supported SMS gateways, please refer to the forum and documentation.
How can I show ads to my guests?#
Ads are managed under Adverts → Campaigns. A campaign is shown to guests during the connection flow, before they pay or enter an access code.
- Creatives - a campaign can hold several images or videos. Each one can be shown only in its own daily time window (for example a breakfast offer in the morning and a dinner promotion in the evening).
- Fallback - exactly one creative is the fallback. It is shown whenever the current time is outside all the scheduled windows, so the campaign always has something to display.
- Targeting - target groups choose who sees a campaign. The same groups can be used for mass SMS and email.
- Cost tracking - campaigns record views and the cost per view, so you can see what each advertiser gets.
How does the referral system work in Powerlynx?#
Earn Rewards by Inviting Others to Powerlynx
Powerlynx offers a referral program that allows you to invite other companies to join and earn a bonus! By referring new clients, you can receive a credit towards your Powerlynx account, making it even easier to manage your subscription.

How It Works:
- Invite a New Client: Log in to your Powerlynx billing portal, click "Copy Invite Link" on your dashboard, and share it.
- The Referred Client Must Stay Active: Your referral must sign up and remain active for 60 days (paying for two consecutive monthly licenses).
- Receive Your Bonus: Once qualified, both you and your referral receive a $100 account credit.
Note: The bonus credit can be used for Powerlynx licenses and services or withdrawn by contacting our support team.
How do simultaneous devices work?#

This setting defines how many devices can connect to the network simultaneously using the same voucher or user account.
For example, if it is set to 2, a user can connect two devices (e.g., phone and laptop) with their phone number. These devices will share the voucher’s limits concurrently (e.g., data and time).
If a third device tries to connect, Powerlynx will automatically disconnect one of the existing devices:
- If one device is offline, it will be removed.
- If both are offline, the device with the oldest session will be disconnected.
This functions as a form of smart device replacement within Powerlynx.
Can I create a read-only administrator in Powerlynx?#
Yes, you can assign a read-only role to an administrator either when adding a new one or by updating an existing administrator and changing their role.

To give an administrator a tailored set of permissions instead, create a custom role — see Administrators and roles.
Keep in mind that the Read-only role can open and download every finance report and payment list. To hide revenue from an administrator, use a custom role with Finance / Payments and Analytics set to None.
🛠️ Troubleshooting
A guest cannot get online. Where do I start?#
First find out which step the guest reached:
- The guest joins the WiFi.
- The browser is redirected to the splash page.
- The guest logs in.
- The guest chooses a data plan.
- The guest pays (if the plan is paid).
- The guest is online.
Then look at the matching problem:
| The guest got stuck at | Most likely reason |
|---|---|
| Step 2: the splash page does not open | The router cannot reach Powerlynx, see the router is connected but no guests or sessions appear |
| Step 2: a “Nothing to do…” screen | The SSID does not match a hotspot, see “Nothing to do…” |
| Step 3: no SMS code arrives | See the OTP SMS does not arrive |
| Step 3: told to wait or refused | See waiting for approval or refused |
| Step 4: no plans, or not the plan they expect | See no data plans are shown |
| Step 5: no payment options | See “No payment options available” |
| Step 6: paid but no access | See a customer paid but did not get online |
If you contact support, please include: the location and hotspot (or SSID), the customer's phone number or ID, the device's MAC address, the exact time with timezone, and a screenshot or the error text the guest saw.
Guests see a “Nothing to do…” screen on the splash page. What does it mean?#
Powerlynx recognises a hotspot by the identifier (SSID) that your controller sends with every request, and uses it to find the right customer and location. If that value does not match any hotspot, the guest sees the “Nothing to do…” screen.
To fix it, open Locations → (your location) → Hotspots, edit the hotspot, and check the SSIDs field. Enter each identifier on its own line, exactly as your controller sends it.
Guests do not see any data plans, or a plan has disappeared#
Check these in order:
- The plan is not enabled for the location. Open
Locations → (your location) → Plansand make sure the plan is switched on there. - The plan's usage limit. A plan with the limit “One time”, or a used-up “Custom” limit, is hidden from customers who already used it. See Why can't a customer buy the same data plan again?
- Payments are not set up. For paid plans, see “No payment options available”.
Guests see “No payment options available”#
A payment gateway has to be configured and also enabled for the location:
- Configure the gateway and its credentials under
Config → Finance. See supported payment gateways. - Open
Locations → (your location) → Payment gatewaysand enable it there.
Some gateways ask the guest for extra information before paying, for example an email address for Paystack and Revio, or a phone number for mobile-money gateways.
A customer paid but did not get online#
After a successful payment the gateway confirms it to Powerlynx, which records the payment, creates the voucher and lets the customer online. This normally takes a few seconds. If the confirmation never arrives, the payment record stays in New or Pending: the customer has paid, but has no payment on record, no voucher and no access.
To fix it:
- Open
Finance → Payment recordsand find the record that is stuck in New or Pending. - Check in your payment provider's dashboard that the money really arrived.
- Click Finalize and confirm. Powerlynx records the payment and creates the voucher from the record's data plan, so the customer gets access when they reconnect.
Finalize is shown only for plan purchases in New or Pending. If the gateway's confirmation arrives later, it is ignored, so the customer does not get a second voucher.
We recommend using Finalize rather than generating a voucher by hand, because a hand-made voucher is not linked to the payment and the money would be missing from your financial reports.
See also Payments and payment records.
A customer is told to wait for approval, or is refused. Why?#
Your venue may have turned on one of two access controls. Both are found under Customers → Access control.
- Customer approval - new customers register, then wait until an administrator approves them, or are refused outright. Each customer is pending, approved or rejected. It can be set system-wide or per location, and approvals can expire automatically after a number of days.
- Access rules - an ordered list of rules above the default rule. A rule can match a phone number, a device fingerprint or a MAC address, and either accept, verify or reject the customer. The first rule that matches decides.
Open the customer to see their approval state, and review the rules list for a matching rule. A rejection rule can show the customer its own message.
The OTP SMS does not arrive#
There are three common reasons:
- No SMS gateway is connected. Powerlynx has no built-in SMS gateway, see Do I need to connect SMS gateways?
- An access rule refused the phone number. Phone number rules are checked before the SMS is sent, so a refused number never receives a message. Check
Customers → Access control. - The gateway failed to send the message. Check
Logs → SMS logsfor the attempt and the gateway's response.
A Splynx customer is refused at login#
When a customer logs in with a Splynx account, Powerlynx checks their Splynx status for the location they connect at. Customers with a blocked or inactive status are refused. A customer with the status New is let in, unless the location allows only Active customers.
The status is checked again each time the customer reconnects, so a customer who becomes blocked in Splynx loses access on their next connection. Check the customer's status in Splynx, and the Splynx-related settings of the location.
How do I remove a device from a customer?#
Open the customer (or the voucher) and go to its devices list. There you can rename a device, add one, or remove it from the voucher. Removing a device from a voucher releases it: the device stays on the customer's account with its name and details, but the voucher no longer covers it. If the device is online at that moment, it is disconnected right away.
Customers can also manage their own devices in the portal under My account.
If a customer keeps reaching the device limit, see How do simultaneous devices work? and How do I handle randomized MAC addresses?, since a phone that changes its MAC address can look like a new device.
My ad campaign is not showing#
Check the following under Adverts → Campaigns:
- Time windows. Each scheduled creative is shown only between its start and end time, and the start must be earlier than the end.
- Fallback. Exactly one creative must be marked as the fallback. It covers the hours outside every scheduled window.
- Target group. If the campaign targets a group, the guest must belong to it.
Ads are shown during the connection flow, after the guest picks a plan and before payment, or before entering an access code.
The router is connected, but no guests or sessions appear#
If the splash page never opens and no sessions show up, the router is most likely not reaching Powerlynx. Check, in this order:
- The connection to Powerlynx is up - your WireGuard, OpenVPN or IPsec tunnel, or the public IP, depending on the connection type of the hotspot.
- The RADIUS settings on the router - the Powerlynx server address, the shared secret of the hotspot, and ports UDP 1812 (authentication) and UDP 1813 (accounting).
- For IPsec connections, open
Config → VPN Connections → (your connection). There you can see the live tunnel status and diagnostic logs, and restart the tunnel.
Then follow the setup guide for your router, for example MikroTik. If it still does not work, contact support@powerlynx.app with the hotspot name and the time of the problem.