Captive Portal Overview
Jasiyo's hotspot captive portal lets walk-in customers pay via M-Pesa and get instant Wi-Fi access — fully automated, zero manual intervention.
What is the captive portal?
The captive portal is the payment page that customers see when they connect to your Wi-Fi hotspot. Before they can access the internet, they are redirected to this page to select a plan and pay via M-Pesa.
The captive portal is the page your walk-in customers land on when they join your Wi-Fi. Jasiyo hosts it and your MikroTik sends them there automatically, so there is nothing to keep running yourself. You choose its look and branding.
Customer payment flow
Customer connects to Wi-Fi
The customer connects to your hotspot SSID. Their device gets an IP address from your MikroTik hotspot server.
Redirected to captive portal
When they open any website (or their device's captive portal detection fires), MikroTik redirects them to the Jasiyo portal URL.
Select a plan
The portal displays your available hotspot plans with prices and durations. The customer picks the one they want.
Enter phone number & pay
They enter their Safaricom phone number and click Pay Now. An M-Pesa STK Push is sent to their phone.
Approve on phone
The customer enters their M-Pesa PIN and approves the payment. The portal shows a countdown timer while waiting.
Access granted
The payment clears, their access is created, and their browser goes through to the internet. The whole thing usually takes under 30 seconds.
Setting up the captive portal
Go to Routers → [Your Router] → Hotspot Setup in your dashboard. The setup script will:
- → Configure a MikroTik hotspot server on your selected interface
- → Set the login redirect URL to Jasiyo's captive portal
- → Add Jasiyo's domains to the walled garden (accessible before payment)
- → Create the hotspot user profiles your plans map onto, on the router itself
Branding & customisation
The portal has its own editor. Click Captive Portal under Hotspot in the sidebar, and you can change:
- Brand identityBusiness name, tagline, and logo shown in the portal header
- TemplateSix layouts — Classic, Modern, Bold, Glassy, Fresh, and Nova
- ThemeLight, dark, or branded, where branded takes your own colour
- FeaturesWhich options appear to the customer on the login screen
- Portal addressUse your own domain instead of Jasiyo's
- Ad bannerA promotional banner with its own detail page and a call-to-action phone number
Every template is mobile-first and works in the cut-down browser that phones open captive portals in. Customers never need to install anything.
Voucher redemption
The captive portal also supports voucher redemption. Customers who have a voucher code can enter it on the portal to get instant access without going through the M-Pesa payment flow.
See the Voucher management guide for how to generate and manage vouchers.
