TEteya
Pay at Table

Create a show-bill intent

Terminal signals intent to display the bill for a tab. The server accepts the intent and notifies the ePOS via a SHOW_BILL_REQUEST SSE event, which in turn posts bill content back to the server. At most one terminal can hold an active show-bill intent per tab at a time.

post/poslink/v1/tabs/{tab_id}/show-bill-intents

Request

Path parameters

tab_idstring uuid required

The tab identifier

Request body

terminal_idstring required

The terminal identifier

Example request

{
  "terminal_id": "term-001"
}

Response

Show-bill intent accepted and forwarded to the ePOS

tab_idstring uuid

Tab identifier

status'OPEN' | 'PAYING' | 'PAUSED' | 'COMPLETED' | 'CLOSED'

Current tab status

showing_bill_terminal_idstring

Terminal that requested the bill display

show_bill_expires_atstring date-time

ISO 8601 expiry timestamp for the show-bill intent (in UTC)

Example response

{
  "tab_id": "3f2b6a2e-9d3e-4a1f-8f1e-6b2e5a8c9d01",
  "status": "OPEN",
  "showing_bill_terminal_id": "term-001",
  "show_bill_expires_at": "2026-04-14T10:05:00Z"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.