Device Interaction/displayOnTerminal

Display on Terminal

Planned

Planned. This contract is published ahead of the build. It is not callable yet — treat it as the shape to design against, not a live endpoint.

Push branded text or status messages to the terminal screen.

POST/v1/terminal/display

Render text on the terminal screen — useful for idle-screen branding, order summaries while the cardholder pays, or status messages between transactions. The display clears automatically after duration milliseconds, or persists until the next display call or transaction begins.

Request body

application/json

linesarrayRequired

Lines of text to display (1–10).

durationinteger

Duration in milliseconds. 0 or omitted = persistent until replaced.

Example 10000

clearPreviousboolean

Clear the screen before displaying new content.

Example true

Response

application/json

successboolean

Whether the display was accepted.

Example true

displayOnTerminal