Connect a Payment Portal with Stripe

Summary Accept online payments on your captive portal (card, Apple Pay, Google Pay) using your own Stripe account. Guests pay you directly; MKController only orchestrates the checkout and releases internet access once Stripe confirms the payment. You need your Publishable key (pk_live_…) and Secret key (sk_live_…) — both from the Stripe Dashboard.

When you connect Stripe, MKController asks for two keys:

Field in MKController	What it is	Format
Publishable key	Public key that renders the card form	pk_live_…
Secret key	Private key that creates and confirms charges	sk_live_…

Use your live keys. Test keys (pk_test_ / sk_test_) will not take real payments.

1. Sign in at dashboard.stripe.com.
2. Make sure you are in live mode — the Test mode switch in the top‑right must be off. (If it is on, you will only see …_test_ keys.)
3. In the left menu, open Developers → API keys.
4. Copy both keys:
   • Publishable key — shown in full. Click Copy.
   • Secret key — hidden. Click Reveal live key, then Copy.

Account not activated yet? If Stripe only shows test keys, finish activating your account first: Settings → Business → Activate account (submit your business and bank details). Live keys appear once Stripe approves the account.

1. Open Integrations → Payments.
2. Select the Payment gateways tab.
3. Find Stripe and click Configure.
4. Paste your keys — Publishable key (pk_live_…) and Secret key (sk_live_…).
5. Click Validate and connect.

MKController validates the keys with Stripe and automatically discovers the payment methods on your account (shown as chips on the Stripe card). A webhook is registered on your Stripe account automatically, so MKController is notified the moment a payment settles — nothing to configure on the Stripe side.

1. Under Integrations → Payments, open the Payment methods tab.
2. Turn on the methods to accept — Credit card, Apple Pay, Google Pay.
3. If more than one gateway can process a method, use the Processed by dropdown on that row to choose Stripe.

Methods are enabled once for your company; each voucher opts in.

1. Open the voucher → Integrations tab.
2. Under Online payment, switch on the methods this voucher should offer (e.g. Credit card).
3. Save.

The captive portal for that voucher now shows the card checkout. Once Stripe confirms the payment, the guest’s access is upgraded to the plan they bought.

• Make a real, low‑value purchase from a device on the hotspot to confirm the full flow (checkout → payment → internet released).
• Track payments in the voucher’s Real time screen — the gateway and paid/pending status show per session.
• Review every transaction in your Stripe Dashboard → Payments.

MKController field	Where to get it in Stripe
Publishable key (pk_live_…)	Dashboard → Developers → API keys → Publishable key (live mode)
Secret key (sk_live_…)	Dashboard → Developers → API keys → Secret key → Reveal live key

• Only test keys are shown. You are in Test mode, or the account is not activated. Turn Test mode off and finish Settings → Business → Activate account.
• Validation fails. Re‑copy the keys (no leading/trailing spaces), confirm they are the live keys, and that the secret key was fully revealed before copying.
• A method won’t turn on. Make sure Stripe is connected and that the method is supported by your account (check the chips on the Stripe card after connecting).
• Rotate a key? Roll the key in Stripe (Developers → API keys → Roll key), then click Reconnect on the Stripe card and paste the new values.

---

Explore next: Configure Payment Gateways · Receive Pix Payments · How Guests Connect & Pay

Need a hand? Talk to our team on WhatsApp or start your free MKController account.