A customer display

A customer display faces the person paying. It shows what the till rings up as it happens and asks for a tip when the register does. It is paired to one register. Its token can read that register’s display and answer the tip prompt, but can never sell, refund or see another order.

Scroll sideways to see all of it →

The till does	The display shows
Nothing yet	Your logo and a welcome
Rings something up	The line within a second, and the total in the largest text on screen
Takes a card by QR	The QR code to pay on the customer’s own phone
Asks for a tip (the register’s Tipping settings)	Your presets with the amount each comes to, Another amount if you allow it, and No tip. The choice goes straight onto the payment
Finishes the sale	Thank you! and a QR code for the receipt

It uses your branding (Settings → Branding): logo, display name and accent colour. The colour is darkened or lightened where needed to stay readable on a light or dark screen.

1. Set one up

1. In the dashboard, open Registers → Devices → Pair a device, choose the till’s register and show a code.

2. On the screen facing the customer, use either:

   A browser (a tablet, or a tab on a second monitor)	Open the browser till’s address with /display added (pos.tuppence.ai/display, or /pos/display on the dashboard’s address), type the code and name the display
   The Tuppence app	Open the Till tab, choose A customer display under This device is and type the code

3. The display shows your welcome screen, and the till’s header (browser) or menu (app) shows Display: and its name.

A laptop can be both: the till in one tab and the display in another, on a second screen.

When the till asks for a tip

If a display is paired and was seen in the last two minutes, the till sends the tip question to it and waits. The cashier sees The customer is choosing a tip on …. Ask on this screen instead brings the question back to the till, for a customer who would rather tell the cashier.

Leaving and removing a display

To	Do
Leave (app)	The app opens straight into the display, as a dedicated till does. Press and hold the top right corner, then confirm with Face ID
Retire it	Revoke it on the Devices page. It forgets its token at once and says so

Through the API

Call	Who
POST /public/pos/pair	the display	Pairs with role: display (till is the default)
POST /v1/pos/display	the till	Publishes the frame: cart, totals, QR to pay, tip prompt or thanks with the receipt’s QR. The same frame twice changes nothing
GET /v1/pos/display	till or display	The latest frame, branding and tip answer. after (a version) and wait (seconds, up to 25) hold the request until the next change
POST /v1/pos/display/tip	the display	The customer’s tip for the prompt shown, once. The till reads it back onto the tender

Next

• A dedicated till: lock the till tablet to selling.