TL;DR
- Mijoz: CoffeeBox — Qozog’istondan vending kofeavtomatlari franshizasi, O’zbekiston bozoriga kirish
- Vazifa: Click, Payme va Uzum ni ikki turdagi xitoy kofemashinalariga ulash va egasiga admin panel orqali boshqaruvni ta’minlash
- Natija: pilot avtomatlar Toshkentda ishlaydi, QR skanerlashdan qo’ldagi qahvagacha — bir necha soniya. Tizim o’nlab nuqtalarga kengaytirishga tayyor
Kontekst
CoffeeBox — Qozog’istondan franshiza modeli asosida ishlaydigan vending kofeavtomatlari tarmog’i. Qozog’istonda biznes allaqachon yo’lga qo’yilgan, lekin O’zbekiston bozoriga kirishda kompaniya ishga tushirishni imkonsiz qiladigan muammoga duch keldi: mahalliy to’lov tizimlari orqali to’lovlarni qabul qilish va avtomatlarni masofadan boshqarish kerak.
Kofeavtomatlar — bu shunchaki «qo’yib, unutdim» emas. Har bir mashina real vaqtda to’lovni qabul qilishi, tranzaksiya holatini tekshirishi va ichimlikni berishi kerak. Egasiga esa shaffof manzara kerak: qaysi avtomatlar ishlayapti, nechta buyurtma o’tdi, mijozlar qaysi to’lov tizimlaridan foydalanyapti.
CoffeeBox o’zbek to’lov tizimlarini integratsiya qilish tajribasiga ega va xitoy uskunalar ishlab chiqaruvchilari API bilan ishlashga tayyor jamoani qidirdi. Birinchi uchrashuv-qo’ng’iroqdan so’ng arxitekturani kelishib oldik va uch kun ichida ishga kirishdik.
Muammo
O’zbekistonda vendingni ishga tushirish uchta blokerga (to’siqga) taqalib qoldi:
- Mahalliy to’lovlar. Click, Payme va Uzum — har bir tizimning o’z protokoli, o’z tasdiqlash mantiqi, o’z integratsiya talablari bor. Uchovi ham bo’lmasa — auditoriyani yo’qotasiz
- Ikki turdagi mashinalar — ikki xil API. CoffeeBox Jetinno va HappyWorker avtomatlaridan foydalanadi. Ikkala xitoy ishlab chiqaruvchisining protokollari, hujjatlari va muloqot yondashuvlari boshqa-boshqa
- Tarqoq nazorat. Har bir ishlab chiqaruvchining o’z boshqaruv paneli bor, ammo hech birida Click, Payme va Uzum orqali to’lovlar ko’rinmaydi. Qancha pul tushganini va qayerdan kelganini tushunish uchun egasi bir necha tizimdan ma’lumotlarni qo’lda yig’ishi kerak
Loyiha maqsadlari
- Istalgan to’lov tizimi orqali to’lash. Xaridor avtomat ekranida qahva tanlaydi, uchta QR-kod oladi — Click, Payme, Uzum — va o’ziga qulay usulda to’laydi
- Ikki turdagi mashinalar — bitta tizim. Jetinno va HappyWorker turli API orqali ishlaydi, lekin xaridor va ega uchun farq yo’q — barchasi yagona backend orqali ishlaydi
- Har bir bosqichda qo’llab-quvvatlash. CoffeeBox uchun bu O’zbekistondagi birinchi ishga tushirish — biz to’lov tizimlari bilan muloqotda yordam berdik, ruxsatnomalar olish jarayoni bo’yicha maslahat berdik va loyihaning barcha bosqichlarida buyurtmachining savollariga javob berdik
Yechim: vending uchun to’lov habi
Biz to’lov tizimlari, kofeavtomatlar va ega admin paneli o’rtasidagi bog’lovchi bo’g’in bo’lgan backend-xizmatni loyihalashtirdik va yig’dik.
To’lov tizimlari integratsiyasi
Har bir to’lov tizimi uchun to’liq sikl amalga oshirildi: QR-kod generatsiyasi, webhook Tashqi tizimdan keladigan HTTP-so'rov bo'lib, voqea haqida — masalan, muvaffaqiyatli to'lov haqida — xabar beradi bildirishnomalarni qayta ishlash, tranzaksiyalarni tasdiqlash va bekor qilish.
- Payme — JSON-RPC 2.0, to’liq sikl: CheckPerformTransaction → CreateTransaction → PerformTransaction
- Click — ikki bosqichli sxema: Prepare (mablag’larni zahiralash) → Confirm (tasdiqlash)
- Uzum — REST API: tekshirish, yaratish, tasdiqlash va qaytarish bilan
Ikki turdagi mashinalarni ulash
Jetinno va HappyWorker server bilan turlicha aloqa qiladi — biz har bir mashina turi uchun alohida modul yozdik. Ega uchun hech qanday farq yo’q: ikkovi ham yagona tizim va yagona admin panel orqali ishlaydi.
Ro’yxatdan o’tmagan qurilmalar tizimda avtomatik ravishda o’chirilgan holati bilan yaratiladi — administrator qo’lda faollashtirmaguncha. Bu ruxsatsiz ulanishlardan himoya qiladi.
Admin panel
Ega to’liq manzarani ko’radi:
- Mashinalar — holat, tur (Jetinno / HappyWorker), egaga bog’lanish
- Buyurtmalar — holat, summa, to’lov tizimi, mashinaga bog’lanish
- Tranzaksiyalar — har bir to’lov tizimidan tafsilotlar, tashqi ID lar, vaqt belgilari
- Audit-log — barcha kiruvchi va chiquvchi so’rovlar, ularning tarkibi va IP-manzillari
Xizmat haqida batafsil: To'lov tizimlari va tashqi xizmatlar integratsiyasi
Qanday ishlaydi: mijoz yo’li
- Inson avtomatga yaqinlashib, ekranda ichimlik tanlaydi
- Avtomat backendga so’rov yuboradi — buyurtma yaratiladi
- Backend uchta QR-kod generatsiya qiladi: Click, Payme, Uzum
- Mijoz QR-ni qulay usulda skanerlaydi va to’laydi
- To’lov tizimi webhook yuboradi — backend tranzaksiyani tasdiqlaydi
- Backend avtomatga muvaffaqiyatli to’lov haqida xabar beradi
- Mashina qahva beradi
QR skanerlashdan ichimlik berilguncha — taxminan 15 soniya. Na naqd pul, na terminal kerak.
Asosiy yechimlar
1. Xitoy ishlab chiqaruvchilari bilan ishlash
Biz ikkala ishlab chiqaruvchining hujjatlarini o’rganib chiqdik, ularning API xususiyatlarini tushunib, ma’lumotlar almashinuvini yo’lga qo’ydik. Hujjatlar to’liq bo’lmagan joylarda — Jetinno va HappyWorker texnik qo’llab-quvvatlash xizmatidan bevosita aniqladik, real so’rovlarda sinab ko’rdik va barqaror ishlashga erishdik. Buyurtmachiga xitoy API larining xususiyatlarini tushunishga hojat qolmadi — biz bu yo’nalishni to’liq o’z zimmamizga oldik va tayyor yechimlar bilan keldik.
2. Uchta to’lov tizimi uchun yagona buyurtma holati
Har bir to’lov tizimi o’zicha ishlaydi, lekin biz uchovini yagona mantiqqa keltirdik: buyurtma yaratildi → to’landi → qahva berildi. Ega to’lov qaysi tizim orqali kelganidan qat’i nazar, bir xil manzarani ko’radi.
3. Xavfsizlik va ishonchlilik
Gap pul haqida bo’lganda — na tranzaksiya yo’qolishi, na ikki marta yechib olishga yo’l qo’yish mumkin emas. Biz himoyani arxitektura darajasida ta’minladik:
- To’lov tizimlari kalitlari shifrlangan holda saqlanadi — bazaga kirish imkoni bo’lsa ham ularni o’qib bo’lmaydi
- Tizimlar o’rtasidagi har bir so’rov imzolanadi — uni soxtalashtirish yoki almashtirishning iloji yo’q
- Bitta buyurtma uchun takroriy to’lov tizim darajasida istisno qilingan
- Yangi qurilma administrator qo’lda faollashtirmaguncha ishlay boshlamaydi
- Avtomatga to’lov haqida bildirishnoma fonda yuboriladi — bu to’lov tizimiga javobni sekinlashtirmaydi va ishonchlilikni oshiradi
Keyingi qadamlar
To’lov infratuzilmasi ishga tushirildi va prodakshnda ishlaydi. Bu — CoffeeBox keyingi bosqichlarni qurayotgan poydevor:
- Mobil ilova — qahvani oldindan buyurtma qilish, ilova orqali to’lash, sodiqlik dasturi
- Biznes-analitika — nuqtalar bo’yicha sotuvlar, mashhur ichimliklar, eng gavjum soatlar, har bir avtomatning yunit-iqtisodiyoti
- Kengaytirish — backendni qayta ishlashsiz yangi nuqtalarni o’sha infratuzilma orqali ulash
Keyingi bosqich: Mobil ilovalar ishlab chiqish
Qanday ishladik
- Arxitekturani kelishdik — franshizaning biznes-modelini, O’zbekistonda ishga tushirish talablarini tahlil qilib, tizimni loyihalashtirdik
- To’lov tizimlariga so’rovlar yubordik — ruxsatnomalar olish uchun tashkiliy jarayonlar davom etar ekan, parallel ravishda mashinalar integratsiyasi bilan shug’ullandik
- Kofemashinalarni uladik — Jetinno va HappyWorker API larini o’rganib, ma’lumotlar almashinuvini sozladik va lokal muhitda sinab ko’rdik
- Tayyor bo’lgan sari to’lov tizimlarini uladik — Click, Payme va Uzum dan ruxsatnomalar kelishi bilan integratsiyalashtirib, real tranzaksiyalarda sinab ko’rdik
- Pilotni ishga tushirdik — production-deploy, Toshkentdagi birinchi avtomatlar to’lovlarni qabul qilmoqda
O'xshash keys: Contab keysi: arizalar, hujjatlar va moliya uchun yagona kontur
Bunday yechim kimga mos keladi
Agar kamida bitta bandda o’z vaziyatingizni tanigan bo’lsangiz — yordam bera olamiz:
- O’zbekistonda vending, terminallar yoki boshqa IoT-uskunalarni ishga tushiryapsiz va Click, Payme yoki Uzum orqali to’lovlarni qabul qilish kerak
- turli ishlab chiqaruvchilardan bir necha turdagi qurilmalaringiz bor va har biri uchun alohida integratsiya o’rniga yagona backend kerak
- Qozog’iston, Rossiya yoki boshqa mamlakatdan O’zbekiston bozoriga kiryapsiz va mahalliy to’lov infratuzilmasi kerak
- tranzaksiyalar xavfsizligi, audit va admin panel orqali to’liq nazorat muhim
FAQ
Bitta to'lov tizimini integratsiya qilish qancha vaqt oladi? ＋
Bizning tomonimizdan bitta to'lov tizimi integratsiyasi taxminan bir hafta oladi. Ammo umumiy muddat to'lov tizimi ruxsatnomalar va kalitlarni qanchalik tez berishiga bog'liq — bu jarayon ularning tomonida bo'lib, bir necha kundan bir necha haftagacha davom etishi mumkin. Shuning uchun biz kutish paytida parallel ravishda boshqa vazifalar ustida ishlaymiz.
Boshqa turdagi vending mashinalarini qo'shish mumkinmi? ＋
Ha. Tizim shunday loyihalashtirilganki, yangi turdagi mashina uchun alohida modul yoziladi, to'lovlar va boshqaruvning butun mantiqi esa umumiy bo'lib qoladi. Yangi ishlab chiqaruvchini ulash mavjud tizimni qayta ishlashni talab qilmaydi.
To'lovlar xavfsizligi qanday ta'minlanadi? ＋
To'lov tizimlari kalitlari shifrlangan holda saqlanadi, tizimlar o'rtasidagi barcha so'rovlar imzolanadi, bitta buyurtma uchun takroriy yechib olish tizim darajasida istisno qilingan. Yangi qurilma administrator qo'lda faollashtirmaguncha to'lovlarni qabul qila boshlamaydi.
Bu backendni faqat kofeavtomatlar uchun emas, boshqa maqsadlarda ham ishlatish mumkinmi? ＋
Ha. Arxitektura to'lovlarni qabul qilishi kerak bo'lgan har qanday vending va IoT-qurilmalar uchun mos: snek avtomatlari, zaryadlash stansiyalari, kir yuvish mashinalari va boshqa uskunalar.
