Hotspot5 min read

    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.

    No payment is required from you to run the portal — it's included in your Jasiyo subscription. No separate server or hosting needed.

    Customer payment flow

    1

    Customer connects to Wi-Fi

    The customer connects to your hotspot SSID. Their device gets an IP address from your MikroTik hotspot server.

    2

    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.

    3

    Select a plan

    The portal displays your available hotspot plans with prices and durations. The customer picks the one they want.

    4

    Enter phone number & pay

    They enter their Safaricom phone number and click Pay Now. An M-Pesa STK Push is sent to their phone.

    5

    Approve on phone

    The customer enters their M-Pesa PIN and approves the payment. The portal shows a countdown timer while waiting.

    6

    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
    Running the hotspot setup script will modify your MikroTik hotspot configuration. If you already have a hotspot server configured manually, review the changes before applying.

    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
    Changes are not live until you press Deploy Portal. Saving stores your edits; deploying pushes them to your routers. Load the portal on a phone afterwards to confirm what customers actually see.

    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.