PayX.uz
Raqamli mahsulotlar uchun toʻlov infratuzilmasi.
Oddiy tilda
- Bu nima
- Sayt yoki ilova bor-yoʻgʻi bitta tizimni ulab, Payme, Click, Xazna va Oson orqali toʻlov qabul qilishi mumkin boʻlgan xizmat.
- Kim uchun
- Internet-doʻkonlar va onlayn xizmatlar egalari hamda ularning dasturchilari uchun.
- Nima beradi
- Har bir toʻlov tizimini alohida ulash shart emas. Sotuvchi hisob chiqaradi, xaridor oʻziga qulay usulda toʻlaydi, sotuvchi esa avtomatik tasdiq oladi va barcha toʻlovlarni bitta kabinetda koʻradi.
PayX — raqamli bizneslarga bitta dasturchi API orqali toʻlov qabul qilish imkonini beruvchi toʻlov integratsiyasi platformasi. Merchantlar hisob-fakturalar yaratadi, ishonchli callbacklar oladi va har bir tranzaksiya hamda komissiyani yagona paneldan kuzatadi.
Biznes konteksti
Kichik onlayn bizneslar Telegram va Instagram orqali sotadi va har bir toʻlov provayderini oʻzi integratsiya qilmasdan toʻlov qabul qilishi kerak.
Muammo
Kichik jamoalar uchun toʻlovlarni bevosita integratsiya qilish sekin va xavfli: har bir provayderning oʻz protokoli bor, callbacklar ishlamay qoladi yoki ikki marta keladi, komissiya va tranzaksiyalarni solishtirish esa qoʻl mehnatiga aylanadi.
Yechim
Merchantlar va toʻlovlarni qayta ishlash oʻrtasida turadigan Laravel platformasi — toza REST dasturchi API, hisob-fakturalarni boshqarish, merchantlarga tasdiqlangan callbacklar, komissiyani hisoblash va toʻliq tranzaksiyalar tarixi.
Men nima qildim
Yakka oʻzim qurdim — arxitektura, kod va production. Boshqa dasturchilar ishlamagan.
Arxitektura
- Toʻrtta provayder oldida yagona invoys modeli: Payme, Click, Xazna, OSON
- Merchant backendlariga imzolangan, qayta yuboriladigan webhooklar
- Toʻlovlarni simulyatsiya qiluvchi sandbox
Backend
- Laravel asosidagi Merchant API v1.2 (OpenAPI 3.0.3)
- Invoys hayot sikli: pending → paid yoki cancelled
- Komissiya — har bir toʻlov provayderi uchun foiz; merchantdan ushlanadi va toʻlovchi summasiga hech qachon qoʻshilmaydi
Frontend va ilovalar
- Toʻlov havolalari va pul yechish uchun merchant kabineti
- Mijoz provayderni tanlaydigan toʻlov sahifasi
- Ochiq API hujjatlari va Postman kolleksiyasi
API va integratsiyalar
- Payme, Click, Xazna, OSON
- HMAC-SHA256 bilan imzolangan payment.completed webhooki
- My-IT orqali kirish
Maʼlumotlar bazasi
- MySQL: invoyslar, toʻlovlar va provayder tranzaksiyalari identifikatorlari
Xavfsizlik
- Har bir loyiha uchun alohida Bearer token
- Vaqt belgisi va soʻrov tanasi ustidan HMAC, ±5 daqiqalik vaqt oynasi va constant-time taqqoslash
- Webhook yetkazishda redirectlarga ergashilmaydi
Chiqarish va ekspluatatsiya
- Alohida sandbox va production tokenlari
- Webhookni qayta yuborish: darhol, soʻng 30 soniya, 2 daqiqa, 10 daqiqa va 30 daqiqadan keyin, 10 soniyalik timeout bilan
Muhandislik tahlili: Invoys hayot sikli — havoladan webhookgacha
- Merchant backendi loyiha tokeni bilan POST /invoice orqali invoys yaratadi.
- PayX invoys uuid va pay_url ni qaytaradi; holat — «pending».
- Mijoz pay_url ni ochadi va provayderni tanlaydi.
- PayX toʻlovni Payme, Click, Xazna yoki OSON orqali boshlaydi.
- Provayder toʻlovni tasdiqlaydi va oʻz tranzaksiya identifikatorini qaytaradi.
- Invoys «paid» holatiga oʻtadi va komissiya qayd etiladi.
- PayX HMAC bilan imzolangan payment.completed webhookini yuboradi va beshtagacha qayta urinadi.
- Merchant istalgan vaqtda GET /invoice/{uuid} orqali holatni tekshirishi mumkin.
Texnik yechimlar va murosalar
- Bitta invoys, toʻrtta provayder — Merchantlar bitta invoys yaratadi; mijoz toʻlov sahifasida Payme, Click, Xazna yoki OSON ni tanlaydi. (Murosa: PayX har bir provayderning ishlashiga bogʻliq — lekin merchantlar bir marta integratsiya qiladi.)
- Vaqt oynasiga ega imzolangan webhooklar — Har bir webhook vaqt belgisi va tananing HMAC imzosini oʻz ichiga oladi; eski vaqt belgilari rad etiladi. (Murosa: Merchantlar imzolarni tekshirishi va soatlarini toʻgʻri ushlashi kerak — hujjatlarda buning usuli koʻrsatilgan.)
- Idempotentlik kaliti bilan qayta urinishlar — Yetkazish beshtagacha qayta urinadi va invoice_uuid idempotentlik kaliti hisoblanadi, shuning uchun takroriy webhook hech narsani oʻzgartirmaydi. (Murosa: Merchant bir hodisani ikki marta olishi mumkin va takrorlarni invoice_uuid boʻyicha chiqarib tashlashi kerak.)
- Faqat muvaffaqiyat yuboriladi — Faqat payment.completed yuboriladi; bekor qilish va muddati oʻtish GET /invoice/{uuid} orqali oʻqiladi. (Murosa: Webhooklarni qayta ishlash soddaroq, lekin boshqa holatlarni merchantlar oʻzi tekshiradi.)
Asosiy modullar
- Toʻlovlarni qayta ishlash integratsiyasi
- Hisob-fakturalarni boshqarish
- Merchant integratsiyasi
- Toʻlov callbacklari
- Komissiyalarni boshqarish
- Moliyaviy tranzaksiyalar hisobi
- Dasturchi API
payx.uz
Boburbek