Designing a paid captive portal


Paid portals are portal/landing pages that provide the user an option to enter username and password along with a paid registration option. The paid registration displays various billing plans defined in WiFiLAN.

The registration page are of two types:

  • Full registration with credit card fields
  • Partial registration with external payment methods

 In case of full registration, the credit card information like card number, expiry date, card type and security/cvv code is displayed along with other registration fields. The user enters all the registration information on the single page and the credit card validation happens transparently behind-the-scene. Once the card is approved, the user is presented a success page and user is allowed to go online

In case of partial registration, the card information has to be entered on external payment page e.g. PayPal. On filing the registration information, the user is redirected to an external payment page for completing the payment process. Once the payment is done, the user is redirected back to splash page for completing the registration process.

In case of partial registration, it is important to whitelist the payment gateway URLs on your respective hotspot gateway/controller so users can complete the payment process. Please refer to respective payment gateway section for getting the full whitelist URLs.

Setting up the paid plans

Before setting up the captive portal, you need to add a portal plans for the paid portal. Unlike free plans, admin need to setup multiple paid plans e.g. hourly, daily, weekly, etc so end users will have a choice of selecting appropriate plan based on their needs. 

Each billing plan will decide the restrictions on the user's session and will also specify the amount users will have to pay to enroll in the plan. Admin can configure multiple restrictions like time, data quota, speed, device/client restrictions for each plan. Once the user select the particular plan, all the plan restrictions will be applicable to the user during the duration of the plan.


For example, if you want the user's session to last for 1 hour with speed of 2 Mbps and you want to charge $3 for the plan, you need to create a 1 hour paid plan with the speed restrictions.

Note: Since admin need to display multiple plans for paid portal, the paid plans are group into plan groups. All paid plans associated with a particular hotspot location will have to clubbed under one plan group. Admin will get an option to select the plan group while defining the paid portal. The paid portal will display all the billing plans under the plan group to the end user.

On the next page, enter the details of your plan.



Save the above plan.


Configuring Payment Gateway

You will also need to configure your payment gateway setting in WiFiLAN. The payment gateway is an external credit card or payment processor which is responsible for validating and processing credit card or any other payment option. 

WiFiLAN supports wide range of payment gateways. Please refer to our supported payment gateway section. 

Note: You will need to setup your payment gateway separately. Many payment gateways need paperwork about your company and bank details to setup your account. Each country have their specific payment gateways. 

To configure your payment gateway, go to Billing -> Admin section. Click on the "Gateway" tab to configure your payment gateway. Please keep the API credential from your payment gateway processor handy before configuring this section.


Creating Portal

Once the paid plan is added, you need to click on the Portal -> Add Portal option. This page will guide you to create a paid portal using the plan created above.

Step 1:

Select the location/hotspot for the captive portal.



Select the type of hotspot controller/gateway for the captive portal. This option will decide the login script for the portal. Please select the correct option.

If you dont have the model listed, select the one closest to that model. Most vendors have similar login script for their gateways.

Next select your portal language. English is set by default.

Next select the type of portal. In this case, select the paid option.You will also need to select the plan group associated with the portal. Please remember that all the active paid plans belonging to this plan group will be displayed on the paid portal. It is important that you define the paid plans for the hotspot in a single plan group.



Next, upload your logo and partner logo. If you want to apply a background image, please select the background image option and upload your background image.


Lastly, select the Terms & Conditions option if you want the user to accept T&C before getting access. Upload your T&C in the text area. Enter the footer text.

If you want to display the support number, select the option and enter your support number.

Finally, enter the welcome URL (URL displayed on successful login). This is a mandatory field.


Save the portal. Once the portal is saved, a URL will be generated on the List portal page. You need to use this URL when configuring your respective controller/gateway.

Have more questions? Submit a request


Please sign in to leave a comment.