Mehmonga qaragan ekranlar

Mehmonga qaragan ekran mehmonga kassada nima boʻlayotganini koʻrsatadi. U bitta endpointni oʻqiydi va olgan narsasini chizadi:

GET /api/payments/v1/devices/display/
If-None-Match: "<last etag>"

{
  "state": "qr",
  "order_display_number": 118,
  "amount": "100000.00",
  "currency": "UZS",
  "qr_payload": "https://checkout.example/…",
  "intent_status": "presented",
  "server_time": "2026-08-09T12:00:11Z"
}

Holatlar

state	Nimani koʻrsatish
idle	Brendingiz, vaqt, muassasa xohlagan har narsa
total	Buyurtma raqami va toʻlanadigan summa
qr	Summa va skanerlanadigan kod sifatida chizilgan qr_payload
paid	Hozirgina toʻlangan summaning qisqa tasdigʻi

paid toʻlovdan keyin qisqa vaqt koʻrsatiladi va oʻzi idle ga qaytadi. Uni ushlab qolmang.

qr_payload faqat uni chizishga haqli qurilmalar uchun

Yuk faqat qurilma qr_dynamic_present ni eʼlon qilganda qoʻshiladi. Bu imkoniyatsiz roʻyxatdan oʻtgan ekran har bir oʻqishda boʻsh satr oladi — imkoniyat sizdan yaxshi xulq soʻrash bilan emas, server tomonida tekshiriladi. Sizga berilgan narsani oʻzgartirmasdan, aynan shundayligicha chizing.

Yuk — provayderning oʻz toʻlov havolasi. Unda maxfiy hech nima yoʻq va uni qayta yozish, qisqartirish yoki qayta yoʻnaltirishga oʻrash sizning ishingiz emas.

Soʻrov

If-None-Match bilan soʻrang; oʻzgarmagan holat tanasiz 304 qaytaradi, bu zich surʼatni arzon qiladi.

Qanchalik zichligini siz emas, Sitora hal qiladi. Har bir javob X-Sitora-Poll-After va Retry-After ni olib yuradi, ikkalasi ham keyingi oʻqishgacha kutiladigan bir xil soniyalar soni bilan — bugun ikkita. Unga quloq soling va kodga qattiq yozmang: bu sonni sizning relizingizsiz butun park boʻylab koʻtarish mumkin. 200 yoki 304 dagi Retry-After — bu surʼat, xato emas. Endpoint ustiga hisob maʼlumoti boʻyicha ham cheklangan, ammo bu oxirgi chora — sarlavhaga quloq soladigan ekran unga yetib bormaydi.

Real vaqtdagi push ataylab taklif qilinmaydi. Shartnoma — bu soʻrov.

Platforma muzlatilganda

Ekranlar provayder orqali pul yigʻishni koʻrsatish uchun mavjud, shuning uchun ularning yuzasi u bilan birga muzlaydi: platforma muzlatilishi ostida ekran hisob maʼlumoti platform_frozen bilan rad etiladi. Betaraf tinch ekranni koʻrsating va soʻrashda davom eting — muzlatilish sizdan hech qanday harakatsiz olinadi.

Shu orada kassa ishlashda davom etadi. Naqd va tasdiqlangan terminal orqali yigʻish har qanday muzlatilishdan omon qoladi, shuning uchun oʻchgan ekran restoranga pul olishga hech qachon xalaqit bermaydi.