How to Set Up Stripe Terminal
Quick guide to connecting your Stripe payment terminal or enabling Tap-to-Pay
How to Set Up Stripe Terminal
Accept card payments through a physical terminal or your mobile device with Tap-to-Pay.
Option 1: Physical Terminal (BBPOS, Verifone)
Enable in Partner Portal
Go to Settings → Payments and enable Stripe Terminal.
Register the Reader
Navigate to Devices → Terminal Readers, click Add Reader, and enter the registration code printed on the terminal.
Connect Reader to WiFi
On the terminal device itself, connect to your restaurant's WiFi network. The terminal must be on the same network as your POS.
Select in POS App
Open the POS app → Settings → Terminal Settings → Select your reader from the list.
Test with a Real Payment
Create a small test order, select Card payment, and verify the terminal activates and processes the payment.
Always test with a real card transaction (you can refund it immediately). A failed terminal during service causes customer frustration and lost revenue.
Option 2: Tap-to-Pay (Mobile)
Use your phone as a payment terminal — no extra hardware needed.
Requires Android 8.0+ or iOS 13.0+ with NFC capability.
Enable in Partner Portal
Go to Settings → Payments and enable Tap-to-Pay.
Open POS App on Your Phone
Launch the Fleksa POS or Waiter app.
Connect Tap-to-Pay
Go to Settings → Terminal Settings → Tap-to-Pay and tap Connect. Follow the on-screen setup.
Accept Payments
At checkout, select Card payment. The customer holds their card or phone near the top of your device.
Troubleshooting
| Issue | Solution |
|---|---|
| Reader not found in POS | Check both devices are on the same WiFi network. Restart the reader. |
| Tap-to-Pay not available | Update your phone's OS. Verify NFC is enabled in device settings. |
| Payment failed / declined | Ask customer to retry. If persistent, check internet connection. |
| Terminal disconnects during service | Move closer to the WiFi router. Consider a WiFi extender for the payment area. |
| "Reader busy" error | Wait 10 seconds and retry. Another device may be using the same reader. |
Full Guide
See Stripe Terminal & Tap-to-Pay for complete documentation including advanced configuration, multiple readers, and offline payments.