Fleksa

Stripe Terminal & Tap-to-Pay

Complete guide to accepting card payments with Stripe Terminal devices and mobile Tap-to-Pay

Stripe Terminal & Tap-to-Pay

Accept card payments directly through Fleksa POS using physical Stripe Terminal readers or mobile Tap-to-Pay on supported devices.

Two Ways to Accept Card Payments

MethodDeviceBest For
Stripe Terminal (Hardware)Physical card reader (BBPOS, Verifone)Counter service, high-volume restaurants
Tap-to-PayAndroid/iOS smartphone or tabletMobile ordering, tableside payments

Stripe Terminal (Hardware Reader)

Supported Readers

ReaderFeatures
BBPOS WisePOS ECountertop, WiFi, built-in display
Verifone P400Countertop, Ethernet/WiFi
BBPOS WisePad 3Mobile, Bluetooth
Stripe Reader M2Mobile, Bluetooth

Setting Up a Terminal Reader

Enable Terminal in Partner Portal

Go to Partner Portal > Settings > Payments and enable Stripe Terminal.

Register Your Reader

In Partner Portal, go to Devices > Terminal Readers and click Add Reader.

Enter the reader's registration code (found on the device or packaging).

Connect Reader to WiFi

On the reader device:

  1. Access the settings menu
  2. Connect to your restaurant's WiFi network
  3. The reader will appear as "Online" in Partner Portal

Select Reader in POS

Open Fleksa POS, go to Settings > Terminal, and select your registered reader from the list.

Test a Payment

Create a test order and select Card payment to verify the connection.

Processing a Terminal Payment

Complete the Order

Add items to the cart and tap Checkout.

Select Card Payment

On the payment screen, tap EC Cash or Card.

Payment Sent to Terminal

The POS displays "Sending to terminal..." and the reader activates.

Customer Completes Payment

Customer taps, inserts, or swipes their card on the reader.

Confirmation

Both POS and reader show payment success. Receipt can be printed.

Terminal Status Indicators

StatusMeaning
OnlineReader is connected and ready
OfflineReader is disconnected - check WiFi
In ProgressPayment is being processed
BusyReader is processing another payment

Tap-to-Pay (Mobile)

Tap-to-Pay turns your Android or iOS device into a contactless payment terminal. No additional hardware required!

Requirements

Android

RequirementDetails
Android VersionAndroid 8.0 (API 30) or higher
NFCDevice must have NFC capability
Google Play ServicesMust be installed and updated
CountryUS, Germany, or Mexico

iOS

RequirementDetails
iOS VersioniOS 13.0 or higher
DeviceiPhone only (iPad not supported)
CountryUS, Germany, or Mexico

Setting Up Tap-to-Pay

Enable in Partner Portal

Go to Partner Portal > Settings > Payments and enable Tap-to-Pay.

This creates a Tap-to-Pay location in your Stripe account.

Open POS App

Launch the Fleksa POS app on your mobile device.

Go to Settings > Terminal Settings > Tap-to-Pay.

Check Eligibility

The app automatically checks if your device supports Tap-to-Pay:

  • Platform (Android/iOS)
  • OS version
  • NFC capability
  • Google Play Services (Android only)
  • Country support

Connect Reader

Tap Connect to initialize Tap-to-Pay on your device.

The status will change to Connected when ready.

Processing a Tap-to-Pay Payment

Complete the Order

Add items to the cart and tap Checkout.

Select Card Payment

Tap Card or Tap-to-Pay on the payment screen.

Present Device to Customer

Hold your device near the customer's card or phone.

The screen shows "Tap card or phone".

Payment Processed

The NFC reads the card/wallet and processes the payment through Stripe.

Confirmation

Payment success displays on screen. Print or email receipt as needed.

Tap-to-Pay Status

StatusMeaning
ConnectedReady to accept payments
Not ConnectedTap Connect to initialize
ConnectingInitializing NFC reader
Not EligibleDevice doesn't meet requirements

Troubleshooting Tap-to-Pay

"Device Not Eligible"

CauseSolution
OS too oldUpdate to Android 8.0+ or iOS 13.0+
Missing NFCUse a device with NFC capability
iPad deviceUse iPhone instead (iPad not supported)
Unsupported countryTap-to-Pay only available in US, DE, MX
Missing Google PlayInstall/update Google Play Services

"Connection Failed"

CauseSolution
No internetCheck WiFi or mobile data
Tap-to-Pay not enabledEnable in Partner Portal first
App outdatedUpdate Fleksa POS app

"Payment Failed"

CauseSolution
Card too farHold card closer to device
Card read errorTry again, slower tap
Card declinedCustomer should try another card

Payment Flow Diagram

┌─────────────────────────────────────────────────────────────┐
│                        POS CHECKOUT                          │
└──────────────────────────┬──────────────────────────────────┘
                           │
                    Select "Card"
                           │
           ┌───────────────┴───────────────┐
           │                               │
           ▼                               ▼
┌─────────────────────┐       ┌─────────────────────┐
│   Physical Terminal │       │     Tap-to-Pay      │
│   (BBPOS/Verifone)  │       │   (Mobile Device)   │
└──────────┬──────────┘       └──────────┬──────────┘
           │                             │
           │                             │
           ▼                             ▼
┌─────────────────────┐       ┌─────────────────────┐
│  Customer taps/     │       │  Customer taps      │
│  inserts card       │       │  card on phone      │
└──────────┬──────────┘       └──────────┬──────────┘
           │                             │
           └───────────┬─────────────────┘
                       │
                       ▼
              ┌─────────────────┐
              │  Stripe Process │
              │    Payment      │
              └────────┬────────┘
                       │
                       ▼
              ┌─────────────────┐
              │    POS Shows    │
              │  Payment Success│
              └─────────────────┘

Split Payments with Terminal

Both Terminal and Tap-to-Pay support split payments:

  1. Select Split Evenly or Itemized Pay on checkout
  2. Each person's portion is sent separately to the terminal
  3. Complete each payment one at a time
  4. Track paid/unpaid portions on screen

Tips on Terminal

Tips can be collected via:

MethodHow
Pre-set amountsCustomer selects 10%, 15%, 20% on POS
Custom amountStaff enters tip amount manually
Terminal promptSome readers support on-device tip selection

Security Features

FeatureDescription
End-to-end encryptionCard data encrypted from reader to Stripe
PCI-DSS compliantMeets payment industry security standards
No card storageCard numbers never stored on device
3D SecureAdditional verification for online-initiated payments

Offline Mode

Card payments require internet connection. If offline, offer cash payment or wait for connection to restore.

Physical terminals may queue payments briefly if connection drops mid-transaction, but Tap-to-Pay requires constant connectivity.

Need Help?

On this page

Stripe Terminal & Tap-to-PayTwo Ways to Accept Card PaymentsStripe Terminal (Hardware Reader)Supported ReadersSetting Up a Terminal ReaderEnable Terminal in Partner PortalRegister Your ReaderConnect Reader to WiFiSelect Reader in POSTest a PaymentProcessing a Terminal PaymentComplete the OrderSelect Card PaymentPayment Sent to TerminalCustomer Completes PaymentConfirmationTerminal Status IndicatorsTap-to-Pay (Mobile)RequirementsAndroidiOSSetting Up Tap-to-PayEnable in Partner PortalOpen POS AppNavigate to Terminal SettingsCheck EligibilityConnect ReaderProcessing a Tap-to-Pay PaymentComplete the OrderSelect Card PaymentPresent Device to CustomerPayment ProcessedConfirmationTap-to-Pay StatusTroubleshooting Tap-to-Pay"Device Not Eligible""Connection Failed""Payment Failed"Payment Flow DiagramSplit Payments with TerminalTips on TerminalSecurity FeaturesOffline ModeRelated DocumentationNeed Help?