Appearance
How to set up Paid WiFi with Stripe in CaptiFi
Follow every step below and guests will buy timed WiFi access on your splash page, with the money going straight into your own Stripe account.
Time needed: about 15 minutes.
What this does
With Paid WiFi on, guests see a paid splash page instead of your free sign-in form. They pick a pass, accept your WiFi terms, and pay by card, Apple Pay or Google Pay. The moment the payment succeeds they are online, and they are disconnected automatically when their time runs out.
Guests who buy a pass give no sign-up details: CaptiFi records their name and email from the Stripe payment, so your guest database keeps growing.
Works with CaptiFi Plug and Play devices, UniFi, TP-Link Omada, Cisco and Meraki. Paid WiFi is not available on Aruba Instant On, FortiGate, MikroTik or Ruckus networks.
One splash page at a time
Paid WiFi replaces your standard splash page at that venue. To offer free WiFi as well, add a free plan in Step 10: guests then pick between free WiFi and your passes on the paid page. Switch Paid WiFi off at any point and the standard splash page comes straight back.
Before you start
- A Stripe account that can accept payments in your country
- A CaptiFi plan from Essentials up (Paid WiFi is not on Lite)
- Your venue live in CaptiFi
Part 1: Get your Stripe API keys
Step 1: Open your Stripe API keys page
Log in to dashboard.stripe.com and go to Developers, then API keys.
Step 2: Copy the publishable key
Copy the key that starts with pk_. This one is safe to appear in a browser.
Step 3: Reveal and copy the secret key
Click Reveal on the secret key and copy it. It starts with sk_, or rk_ if you use a restricted key. Treat it like a password.
Try it with test keys first
Test keys (pk_test_ and sk_test_) work exactly the same way, so you can rehearse the whole flow before taking real money.
Part 2: Connect Stripe in CaptiFi
Step 4: Open the Paid WiFi page
Log in to my.captifi.io and click Paid WiFi under WiFi & venues in the sidebar. If you do not see it, open Integrations, find the Paid WiFi (Stripe) card and switch on Show in sidebar.

Step 5: Paste your Stripe keys
In Stripe connection, paste the publishable key from Step 2 and the secret key from Step 3. Both are write-only: once saved, CaptiFi shows only a masked preview.


Step 6: Choose your currency and payment methods
Pick the Currency guests are charged in. CaptiFi supports GBP, USD, EUR, CAD, AUD and NZD, so charge in your local currency.
Card is always on. Leave Apple Pay and Google Pay ticked: the buttons only appear on devices that support them, and they convert far better than typing card details on a phone.
Step 7: Optional, give guests free data before paying
Free data before payment lets every guest online for a small data allowance before the paywall appears, which is useful if you want people to sample the WiFi first. Leave it on None, pay immediately to charge from the start.
For free WiFi that carries on beside your passes, add a free plan in Step 10 instead. Where a guest's plans include a free plan, the free data allowance isn't offered.
Step 8: Click Save Stripe settings, then Test connection
A successful test confirms the secret key works. Test connection stays greyed out until a secret key has been saved.

Part 3: Create your access plans
Step 9: Add a plan
In Access plans & pricing click + Add plan. You get up to 40 plans; guests see every plan marked Active.

Step 10: Fill in the plan
| Column | What to set |
|---|---|
| Label (optional) | What the guest sees, for example 1 hour pass or All day |
| Duration | 30 minutes up to 7 days |
| Data | Leave Unlimited, or cap the pass (for example 1 GB) |
| Download / Upload | Site default, or give a premium pass faster speeds |
| Price | The amount in your chosen currency |
| Active | Tick to show the plan to guests |
Guests are disconnected when their time or their data runs out, whichever comes first.

On a UniFi venue connected with a controller login or a local API key, each plan also has a Free tick box, and on a venue with WiFi areas an Area choice, so the plans are laid out as cards:
| Field | What to set |
|---|---|
| Free | Tick to make the plan a free plan. Guests pick it on the paid page with their first name and email, and can upgrade to a pass later without reconnecting |
| Area | Whole venue, or the WiFi area the plan is for. Guests in an area with plans of its own see only those |

The whole venue can have one active free plan, and so can each area. How free plans and area plans work for guests is covered in A free plan beside your passes.
Step 11: Click Save plans

A sensible starting line-up is a cheap short pass and a better-value long one, for example 1 hour at 1.00 and 24 hours at 9.99 in your currency.
Part 4: Turn Paid WiFi on
Step 12: Switch the venue from Standard Splash to Paid WiFi
In WiFi access mode, flip the toggle. While it reads Standard Splash, guests get online free. Once switched, the paid splash page is live immediately. Paid WiFi needs at least one active plan for the whole venue, for guests who are not in a WiFi area.

Step 13: Preview your paid splash page
Use the Preview your paid splash page link at the bottom of the panel to see exactly what guests see.
Step 14: Allowlist Stripe on your controller if needed
Guests must reach Stripe before they are online. CaptiFi does this for you on UniFi controllers and on CaptiFi devices over their management tunnel. On Omada, Meraki or Cisco, add these to your pre-authentication allowlist or walled garden:
js.stripe.com
api.stripe.com
m.stripe.network
q.stripe.com
pay.google.com
apple-pay-gateway.apple.comPart 5: Test it end to end
Step 15: Buy a pass yourself
Forget the WiFi on a phone, reconnect, and complete the purchase. Accept the terms, pay, and confirm you get online straight away.
Step 16: Check the payment landed
The Payments received table on the Paid WiFi page shows the guest, plan, amount, status and time remaining. Stripe emails the guest a receipt automatically.
Tracking payments
The Paid WiFi page shows, per venue:
- Total revenue, last 30 days, passes sold, and how many paid guests are online now
- A Payments received table with each guest's name, email, plan, amount, status and time left. Free plan sign-ins are listed too, marked Free, and are not counted as payments
Paid guests also appear in your normal Guest Visits list, so email campaigns and integrations keep working.
Troubleshooting
Test connection is greyed out - save a secret key first, then test.
Guests see the payment form but it fails to load - Stripe is being blocked before the guest is online. Add the domains in Step 14 to your controller's walled garden.
No Apple Pay or Google Pay buttons - the wallets only render on supported devices: Apple Pay in Safari on iPhone, iPad and Mac with a card in Wallet; Google Pay in Chrome or on Android with a saved card. Both must also be enabled in Stripe under Settings, Payment methods. CaptiFi registers the Apple Pay domain with your Stripe account when you save your keys.
Payments succeed but guests are not online - check the venue's WiFi hardware is online in WiFi Access Points, then contact support with the payment time.
I want free WiFi back - flip WiFi access mode back to Standard Splash. Nothing else needs changing. To keep your passes and offer free WiFi beside them, add a free plan in Step 10 instead.
FAQ
Do guests still accept my WiFi terms? Yes. The accept and reject terms step appears before payment, exactly as on the free splash page.
Where does the money go? Straight into your own Stripe account. CaptiFi never touches the funds and takes no commission. Stripe's normal processing fees apply.
Do guests get a receipt? Yes, Stripe emails one to the address used at payment.
What happens when the time runs out? The guest is disconnected, and buys another pass to get back online. At a venue with a free plan they go back on the free plan instead, normally without reconnecting.
Can guests get free WiFi too? Yes. Add a free plan and guests pick it on the paid page, giving their first name and email. They can upgrade to a pass later without reconnecting. Free plans need a UniFi controller connected with a controller login or a local API key.
Can I refund a guest? Yes, refund in your Stripe dashboard as usual. A refund does not end an active session automatically.
Related guides
- Paid WiFi Access, including free plans and plans for each WiFi area
- WiFi Vouchers and POS codes
- Square POS integration
- Splash Page Builder