Stripe payment issues on guest WiFi captive portals typically fall into three categories: checkout forms not loading due to blocked domains, successful payments that don't grant internet access due to router misconfiguration, or missing package options caused by disabled payment login settings. These problems prevent revenue generation and create frustrating guest experiences.
This troubleshooting guide walks you through diagnosing and fixing the most common Stripe payment issues on captive portals. Most problems are resolved within 5-10 minutes by adjusting walled garden settings or verifying splash page configuration.
What you'll accomplish:
Fix Stripe checkout forms not loading or displaying correctly
Resolve payment success but no internet access issues
Enable package selection when payment options don't appear
Verify proper Stripe domain whitelisting in your router
What you'll need:
Admin access to your router/controller configuration
Admin access to Spotipo dashboard
Test device to verify fixes
Payment packages already created in Spotipo
Common symptom: Guests see the splash page but can't enter credit card details, or payments process is successfully but WiFi remains blocked.
Common payment-gated WiFi issues:
Stripe checkout not loading:
If your captive portal loads, but the fields to enter the card details are empty and you are unable to enter details into the boxes, like in the picture below.
It probably means that you haven't allowed the correct Stripe domains through your router/controller. Make sure that the following addresses are allowed in your walled garden/pre-authorization list (name depends on the router/controller brand)
q.stripe.com
js.stripe.com
api.stripe.com
Example for UniFi controllers. Same addresses need to be allowed on other router types as well.
Once these addresses are allowed, make sure to forget the network on your test device, and try to access the portal again. You should now be able to enter card details without issues.
Payment succeeds but WiFi doesn't activate: Check router authentication is properly configured
If your payment is successful, but your users still cannot get access to the internet, that means that the issue isn't with Stripe, rather it is with your routers/controllers configuration with Spotipo. Please double check our configuration guide for the specific brand of your router/controller here:
Guests can't see packages: Ensure Payment Login is enabled on splash page
If the splash page loads correctly, but your guests cannot see the option to select any of the paid packages, double check that the payment login is enabled in your spotipo dashboard.
Go to your Splash page configuration screen and check whether the "Payment login" is enabled by clicking the Settings icon.
Make sure that the Payment login box has Green highlights around it, meaning that the option is active.
If the option was off, make sure to use the Save Splashpage button so that this issue doesn't arise again. After that, make sure to forget the network on your test device and try again.
Stripe Payment Issues Resolved
After whitelisting Stripe domains in your walled garden, verifying router authentication configuration, and enabling payment login on your splash page, Stripe payments should process correctly and grant internet access. Test thoroughly before going live with guests.
What to do next:
Test complete payment flow with a small transaction
Verify internet access activates immediately after payment
Ensure all package tiers display correctly on splash page
Refund test transactions if needed
Quick troubleshooting checklist:
Checkout not loading: Verify q.stripe.com, js.stripe.com, api.stripe.com in walled garden
Payment works, no internet: Check router configuration guide for your specific device
No packages visible: Enable Payment Login in Splash Page settings with green highlight
Prevention tip: After any router firmware update, re-verify Stripe domains remain in your walled garden, updates sometimes reset these settings.
Still experiencing Stripe payment issues?
Contact Spotipo support via live chat or email us at [email protected] with details about which step fails (checkout loading, payment processing, or internet activation).