Skip to content
Sitora Docs

payments_device_display

GET
/api/payments/v1/devices/display/
curl --request GET \
  --url https://example.com/api/payments/v1/devices/display/ \
  --header 'Authorization: Bearer <token>'

Current display state for the device’s station: idle | total | qr | paid. Supports ETag/If-None-Match polling (304 when unchanged). qr_payload renders only on devices declaring the qr_dynamic_present capability.

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json

What a customer-facing display should render right now.

state ∈ idle | total | qr | paid — a stable vocabulary the device renders verbatim; qr_payload is set only in the qr state and only for devices whose capabilities include qr_dynamic_present.

object
state
required
string
order_display_number
required
integer
nullable
amount
required
string format: decimal
nullable /^-?\d{0,10}(?:\.\d{0,2})?$/
currency
required
string
qr_payload
required
string
intent_status
required
string
server_time
required
string format: date-time
Examplegenerated
{
  "state": "example",
  "order_display_number": 1,
  "amount": "example",
  "currency": "example",
  "qr_payload": "example",
  "intent_status": "example",
  "server_time": "2026-04-15T12:00:00Z"
}

503

Section titled “503”

This deployment cannot store or read protected Handbook content because DJANGO_KNOWLEDGE_CONTENT_KEY is unset or unusable. Answered by the platform exception handler rather than by this endpoint, so any path can return it; retrying does not help until an operator fixes the deployment.

Media typeapplication/json

This deployment cannot store or read protected Handbook content because DJANGO_KNOWLEDGE_CONTENT_KEY is unset or unusable. Answered by the platform exception handler rather than by this endpoint, so any path can return it; retrying does not help until an operator fixes the deployment.

object
code
required
string
Allowed values: content_key_missing
detail
required
string
Example
{
  "code": "content_key_missing"
}