Pay at Table

Create a hide-bill intent

Terminal signals intent to stop displaying the bill for a tab. Strict semantics: the lock must currently be held by the calling terminal — a hide racing the credit-completed path or the TTL sweeper is rejected with 409 TAB_NO_ACTIVE_SHOW_BILL. On success the server clears the show-bill state on the tab and notifies the ePOS via a TAB_BILL_HIDDEN SSE event.

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

Request

Base URL
https://api.teya.com
Auth
OAuth 2
Authorization codehttps://id.teya.com/oauth/v2/oauth-authorize
Token URLhttps://id.teya.com/oauth/v2/oauth-token
TypeScript
https://skmtc.dev/teya/apis/poslink-api/docs/poslink/v1/tabs/:tab_id/hide-bill-intents/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

tab_idstring uuid required

The tab identifier

Request body

terminal_idstring required

The terminal identifier

Example request

{
  "terminal_id": "term-001"
}

Response

Hide-bill intent accepted and forwarded to the ePOS

tab_idstring uuid

Tab identifier

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

Current tab status

Example response

{
  "tab_id": "3f2b6a2e-9d3e-4a1f-8f1e-6b2e5a8c9d01",
  "status": "OPEN"
}

Changes

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