Skip to main contentSkip to search
Skip to main content

Stripe Integration

Enable paid WiFi access by accepting credit card payments directly on your captive portal using Stripe's secure payment platform.

Overview​

The Stripe integration allows you to:

  • Accept one-time payments for WiFi access
  • Create subscription plans for recurring access
  • Process payments securely via Stripe's PCI-compliant platform
  • Offer multiple access tiers (time-based or data-based)

Prerequisites​

  • IronWiFi account with captive portal configured
  • Stripe account (free to create at stripe.com)
  • Stripe API keys (publishable and secret keys)

Stripe Account Setup​

Create Stripe Account​

  1. Go to stripe.com and sign up
  2. Complete account verification
  3. Enable live mode when ready for production

Get API Keys​

  1. Log in to Stripe Dashboard
  2. Go to Developers > API keys
  3. Copy:
    • Publishable key: 
      pk_live_...
      or 
      pk_test_...
    • Secret key: 
      sk_live_...
      or 
      sk_test_...

Use test keys during development, live keys for production.

IronWiFi Configuration​

Step 1: Add Stripe Provider​

  1. Log in to IronWiFi Console
  2. Navigate to Networks > Captive Portals
  3. Select your captive portal
  4. Go to Authentication Providers
  5. Click Add Provider > Stripe

Step 2: Configure API Keys​

Enter your Stripe credentials:

  • Publishable Key: Your Stripe publishable key
  • Secret Key: Your Stripe secret key
  • Webhook Secret: Generated after webhook setup

Step 3: Create Access Plans​

Create plans that users can purchase:

  1. In the Stripe provider settings, click Add Plan
  2. Configure:
    • Name: Display name (e.g., "1 Hour Access")
    • Price: Amount in cents (e.g., 500 for $5.00)
    • Currency: USD, EUR, etc.
    • Duration: Access time (minutes)
    • Data Limit: Optional data cap (MB)

Example plans:

PlanPriceDurationData
1 Hour$2.0060 minUnlimited
Day Pass$5.001440 minUnlimited
Week Pass$15.0010080 min10 GB

Step 4: Configure Webhook​

Set up webhook for payment confirmations:

  1. In Stripe Dashboard, go to Developers > Webhooks
  2. Click Add endpoint
  3. Enter webhook URL from IronWiFi console
  4. Select events: 
    • checkout.session.completed
    • payment_intent.succeeded
    • payment_intent.payment_failed
  5. Copy the Signing secret to IronWiFi

Payment Flow​

  1. User connects to WiFi and sees captive portal
  2. User selects a plan and clicks "Buy"
  3. Stripe Checkout opens (secure, hosted by Stripe)
  4. User enters payment details
  5. On success, IronWiFi authorizes the user
  6. User receives confirmation and WiFi access

Customization​

Splash Page Integration​

Add Stripe payment buttons to your splash page:

Was this page helpful?