Payment Device API

Payment Device API smart kassa terminaliga yoki mehmonga qaragan ekranga kassada pul yigʻishda ishtirok etish imkonini beradi. Bu boʻlim — yetkazib beruvchi uchun shartnoma; uning mashina oʻqiy oladigan qismi — GET /api/payments/v1/openapi.json manzilida jonli beriladigan (autentifikatsiyasiz) OpenAPI hujjati va shu saytning API reference sahifalari.

Model: Sitora pul yigʻishni tasvirlaydi, bajarmaydi

Sitora pulni harakatlantirmaydi va karta maʼlumotlariga hech qachon tegmaydi. Toʻlovlarni banklar, toʻlov provayderlari va sertifikatlangan toʻlov ilovalari bajaradi. Sitora — jarayon boʻyicha vakolatli tomon: buyurtma, summa, toʻlov niyati, natijaviy tranzaksiya va audit izi unga tegishli.

Toʻlov niyati — bitta buyurtmaning toʻliq summasini bitta kassada yigʻish uchun server tuzgan soʻrov. Bu qurilma umuman ish koʻradigan yagona obyekt va undagi har bir pul maydoni buyurtma haqiqatidan olinadi:

Har bir summani server belgilaydi. Uni na qurilma, na mijoz, na provayder yuki oʻrnata yoki oʻzgartira oladi. Summa yuboradigan qurilma integratsiya qilmayapti — u shunchaki eʼtiborga olinmayapti.

Bitta qoida

Bu boʻlimdagi qolgan hamma narsa bitta cheklovdan kelib chiqadi:

Qurilma toʻlov ilovasi nima qaytarganini xabar qilishi mumkin. U pul qabul qilinganini hech qachon eʼlon qila olmaydi.

Xabar qilingan muvaffaqiyat niyatni processing ga oʻtkazadi va kassirga ilovangiz nima deganini koʻrsatadi. Soʻng kassir uni tasdiqlaydi va faqat shu tasdiq buyurtmani toʻlangan deb belgilaydigan tasdiqlangan tranzaksiyani yaratadi. Xabar qilingan rad etish ham niyatni oʻldirmaydi — notoʻgʻri rad etish buyurtmani ikkinchi marta yigʻish uchun boʻshatib yuborardi, shuning uchun qoida simmetrik.

Bu Sitora robotlar uchun (ular ovqat beradi, ammo buyurtma holatini hech qachon yozmaydi) va oʻz sunʼiy intellekt yordamchisi uchun (u qoralama tayyorlaydi, ammo hech qachon bajarmaydi) chizadigan chegaraning oʻzi. Pulga qoʻllanganda bu shuni bildiradi: buzilgan yoki xatoli qurilma toʻlovni oʻylab chiqara olmaydi.

Qurilma turlari

Tur	Dasturiy taʼminot ishlaydimi	Odatdagi roli
smart_pos	ha	Hamroh ish joyi; pul yigʻishni yonidagi sertifikatlangan toʻlov ilovasiga topshiradi
customer_display	ha	Mehmonga summani, dinamik QR va toʻlov lahzasini koʻrsatadi
external_terminal	yoʻq	Sitora yonida ishlatiladigan bank terminali; natijani kassir tasdiqlaydi
fiscal_register	yoʻq	Fiskal operatorga bogʻlangan kassa

Mashina hisob maʼlumoti faqat smart_pos va customer_display da boʻladi. Qolgan ikkitasi — reyestr yozuvlari: Sitora biladigan, ammo u bilan gaplashmaydigan haqiqiy uskuna.

Brendlar emas, imkoniyatlar

Qurilmaga nima ruxsat etilgani imkoniyatlar toʻplami bilan belgilanadi: u qurilma roʻyxatdan oʻtkazilganda eʼlon qilinadi va Sitoraning platforma reyestriga solishtirib tekshiriladi. Siyosat, marshrutlash va mijozdagi har bir taklif imkoniyatlar tilida fikr yuritadi; brend nomi Sitora mantigʻida hech qayerda uchramaydi.

Imkoniyat	Maʼnosi
payment_app_handoff	Niyatni yonidagi toʻlov ilovasiga topshirib, natija korrelyatsiyasini qaytara oladi
companion_workspace	Roʻyxatdan oʻtgan qurilmada Sitora Pro sifatida ishlaydi
qr_dynamic_present	Provayder toʻlovini bitta niyat uchun dinamik QR koʻrinishida chizadi
customer_total_display	Mehmonga buyurtma summasi va toʻlov jarayonini koʻrsatadi
card_present_attested	Toʻlov kontur tashqarisida olinadi; natijani xodim tasdiqlaydi
receipt_print	Mehmon uchun fiskal boʻlmagan cheklarni chop etadi

Hisob maʼlumotingiz scopeʼlari shu imkoniyatlardan keltirib chiqariladi, shuning uchun ekran topshirish feʼllarini hech qachon olmaydi va payment_app_handoff siz hamroh ham ularni olmaydi.

Platforma reyestrida yana ikkita imkoniyat bor, ammo bugun ular ortida qurilma yuzasi yoʻq: fiscalize fiskal kassalarga tegishli, ularni Sitora bu API orqali emas, fiskal operator orqali boshqaradi, card_present_push esa yarim-integratsiyalangan terminallar uchun ajratilgan — Sitora integratsiya qilgan hech bir toʻlov provayderi terminalga summa yuborish uchun bulutli API chop etmaydi, shuning uchun uni hozircha hech nima qabul qilmaydi. Ikkalasidan birini eʼlon qilish bu yuzada hech qanday xatti-harakatni oʻzgartirmaydi.

Sitora qurilmadan hech qachon qabul qilmaydigan narsalar

• Karta egasining har qanday maʼlumoti. PAN ham, trek ham, EMV ham, CVV ham, OTP ham, hamyon hisob maʼlumoti ham. Ularni joylash uchun maydon yoʻq va uni qoʻshish reja emas.
• Oʻzingiz tanlagan summa, valyuta yoki buyurtma havolasi. Nima yigʻishni sizga aytishadi.
• Pul olinganligi haqidagi daʼvo. Yuqoridagi «bitta qoida» ga qarang.
• Xodimlar oʻqishi uchun erkin matn. Xabarlar tuzilgan havolani va sizning oʻz kodlangan natijangizni olib yuradi; kodlarni oʻz lugʻatiga Sitora oʻzi oʻgiradi.