⚡
QuickPOS
Configuration

Payments

Configure which payment methods are available at the till, set up Stripe Terminal for automatic card reader integration, and enable customer self-ordering.

Opening Payment Settings

Tap the burger menu → Settings (admin PIN required) → Payments tab. All payment configuration lives here.

Accepted Payment Methods

Enable or disable each payment method using the toggles. Only enabled methods appear as buttons in the checkout. This lets you hide methods your business doesn't use — for example a cashless business can turn off Cash entirely.

Cash

Enables the Cash button in checkout. When selected, the cashier enters the amount received and QuickPOS calculates change automatically with quick tender buttons for common amounts.

Card Manual

Enables the Card Manual button in checkout. This is a manual confirmation — the cashier confirms payment was taken in QuickPOS, but processes the actual card on a separate device. Works with any card acceptance device: standalone terminals, Stripe's Tap to Pay app, SumUp, iZettle, or any other reader.

💡
Card Manual is the recommended method if you don't have a Stripe Terminal reader. Use your preferred card device to take payment, then confirm in QuickPOS.

Split Payment

Enables the Split button in checkout, allowing part cash and part card payments in a single transaction.

Stripe Terminal

Stripe Terminal integrates a physical card reader directly with QuickPOS. When enabled, the cashier selects Stripe Terminal at checkout and the payment amount is sent automatically to the reader — no manual entry required. The customer taps, inserts or swipes their card, and QuickPOS completes the order when payment is confirmed.

Setting up Stripe Terminal

  1. Create a free Stripe account at stripe.com if you don't have one
  2. In your Stripe dashboard, go to Terminal → Locations and create a location for your venue
  3. Go to Terminal → Readers and register your reader using the pairing code shown on the device
  4. Copy the Reader ID (starts with tmr_) and Location ID (starts with tml_)
  5. In QuickPOS, go to Settings → Payments → Stripe Terminal and toggle Enable Stripe Terminal on
  6. Paste your Reader ID, Location ID, Publishable Key and Secret Key into the fields shown
  7. Save Settings
💡
Your Stripe API keys are found in the Stripe dashboard under Developers → API keys. Use test keys (starting pk_test_ and sk_test_) while setting up, then switch to live keys when ready to take real payments.

Stripe Terminal fields

FieldWhere to find itFormat
Terminal Reader IDStripe dashboard → Terminal → Readerstmr_…
Terminal Location IDStripe dashboard → Terminal → Locationstml_…
Publishable KeyStripe dashboard → Developers → API keyspk_live_… or pk_test_…
Secret KeyStripe dashboard → Developers → API keyssk_live_… or sk_test_…
🔒
Never share your Secret Key. It is stored locally on your machine and used server-side only. It is never sent to any third party other than Stripe.

How Terminal payment works

  1. Cashier taps Charge in the cart and selects Stripe Terminal
  2. Tap Confirm Payment — QuickPOS sends the amount to the reader
  3. The reader prompts the customer to present their card
  4. Customer taps, inserts or swipes — the reader handles the transaction
  5. QuickPOS detects payment success and completes the order automatically
  6. Success screen shows with order number and receipt
💡
If the customer changes their mind, tap Cancel on the waiting screen. QuickPOS cancels the reader action and returns to the payment methods so you can start again.

Compatible readers

See Supported Hardware for a full list of compatible Stripe Terminal readers.

Customer Self-Ordering

Toggle Enable Customer Self-Ordering to allow customers to browse your menu and place orders from their own devices over your local Wi-Fi network at http://[your-server-ip]:3000/menu.

When enabled, customer orders appear in the Pending Orders panel on the POS. The cashier loads the order, takes payment at the counter as normal, and the order is sent to the kitchen.

When disabled, visiting /menu shows a friendly "Ordering is not available right now" message.