Skip to content
FluxusDocs
Fluxus DocumentationFluxus Documentation

QR POS Terminal

POS terminalPOS terminal

Turn any device into a point-of-sale terminal. Enter an amount on the keypad, display a QR code for the customer, and detect incoming payments in real-time.

How to accept payments

1

Enter amount

Use the on-screen keypad to enter the payment amount. Select which stablecoin to accept (pathUSD by default).

2

Display QR code

A QR code is generated containing a payment link with your address, amount, and token pre-filled. Show this to the customer.

3

Customer scans and pays

The customer scans the QR code with their Fluxus wallet (or any compatible wallet). They confirm the payment with their passkey.

4

Payment detected

The terminal automatically detects the incoming payment and displays a success confirmation. No manual verification needed.

Tempo primitives used

  • Sub-second finality. Payment confirmed in under 0.5 seconds.
  • Fee sponsorship. The customer pays $0 in gas. The terminal runs as a zero-fee POS.
  • Multi-token. Accept any of the four registered TIP-20 stablecoins.
  • Payment request links. The QR code encodes a standard Fluxus payment URL.
  • Batch calls. Atomic split payments route proceeds to multiple recipients in one transaction.

NFC tap-to-pay

On Android Chrome, the terminal can write the same payment URL to an NFC tag alongside the QR code. Tap the Tap to Pay (NFC) button to activate write mode, then hold an NFC-enabled tag near the device. Customers tap their phone to the tag to open the payment link without scanning.

  • Supported: Android Chrome with Web NFC (NDEFReader) in a secure context
  • iOS Safari: Web NFC is unavailable on iOS. A disabled button explains the limitation instead of silently hiding the feature.

Atomic split payments

Merchants can configure automatic payment splitting from the POS settings. Set a tax percentage and wallet address, plus an optional tip percentage and wallet address. When a customer pays, Fluxus issues a single Tempo batch transaction that routes each portion atomically. The payment either reaches all recipients or fully reverts. There is no partial state.

  • Tax split: Configurable percentage routed to a designated tax wallet
  • Tip split: Optional percentage routed to a tip wallet (for example, staff)
  • Amounts: Computed using 6-decimal TIP-20 arithmetic; remainder stays with the merchant

Merchant mode: The POS terminal is receive-only. It cannot send payments. It only displays QR codes and detects incoming transfers to your address.