Boshlashdan oldin nima kerak
To‘lov tizimi bilan shartnomani biznes tuzadi va pul uning hisob raqamiga tushadi. Payme hujjatlarida to‘g‘ridan-to‘g‘ri yozilgan: kassalar bilan faqat yuridik shaxslar ishlay oladi — ro‘yxatda YaTT, XK, MChJ, AJ, DUK, QK va NTM. Dasturchi protokolni ulaydi, lekin siz bilan pul o‘rtasida turmaydi.
- Yuridik shaxs va hisob raqami. Ularsiz kassa ochilmaydi.
- To‘lov tizimi kabinetidagi kassa. Payme Business’da ularning uch turi bor: billingli, billingsiz va joyida to‘lov uchun. Buyurtmali sayt va bot uchun billingli kassa kerak — shunda to‘lov tizimi har bir to‘lovni serveringiz bilan solishtiradi.
- HTTPS’li server. Payme va Click unga o‘zi murojaat qiladi, shuning uchun u faqat sayt ochilganda emas, doimo internetdan ochiq bo‘lishi kerak.
- Barcha tovar va xizmatlarga MXIK kodlari. Ularsiz fiskal chek shakllanmaydi — bu haqda quyida.
Payme: server to‘lov tizimi chaqiruvlariga javob beradi
Payme Business’da ikkita protokol bor. Merchant API’da so‘rovlarni Payme yuboradi, ilovangiz esa javob beradi — bu Payme to‘lov shakli orqali to‘lashda standart yo‘l. Subscribe API’da aksincha: ilovangiz Payme’ni chaqiradi, bu kartani bog‘lash, bir bosishda to‘lash, muntazam to‘lovlar va o‘z to‘lov shaklingiz uchun kerak.
Merchant API’da almashinuv HTTPS ustidan JSON-RPC 2.0 bo‘yicha, POST metodi bilan boradi. Payme o‘zini bazaviy HTTP-autentifikatsiya orqali tanitadi, parol sifatida kassa kaliti ishlatiladi — uni Payme Business texnik mutaxassisi beradi. Noto‘g‘ri ma’lumotli so‘rovni server -32504 xatosi bilan rad etishi shart. Server HTTP 200 statusi bilan javob berishi shart; boshqa har qanday statusni Payme tizim xatosi deb hisoblaydi. Summalar tiyinlarda uzatiladi.
Protokolning ikki tafsiloti integratsiyaning butun ishonchliligini belgilaydi. Birinchisi: tranzaksiya 12 soat ichida yakunlanmasa, Payme uni 4-sabab bilan taym-aut bo‘yicha bekor qiladi. Ikkinchisi: CreateTransaction yoki PerformTransaction’ga javob yo‘qolsa, Payme so‘rovni aynan o‘sha parametrlar bilan takrorlaydi. Demak, server takrorni tanishi va ikkinchi tranzaksiya yaratmasdan, o‘sha natijani qaytarishi shart. Javob uzoq vaqt bo‘lmasa, to‘lov Payme xodimi tomonidan qo‘lda ko‘rib chiqishga o‘tadi.
Click: ikkita imzolangan qadam
Click Shop API’da o‘zaro ishlash ikki bosqichga bo‘lingan, ikkala so‘rovni ham Click serveringizga form-urlencoded formatida yuboradi; javob JSON’da bo‘lishi kerak.
- 01Prepare (action = 0). Buyurtma mavjud va dolzarb ekanini, summa to‘g‘riligini, tovarni berish mumkinligini tekshirish. Internet-do‘kon shu qadamda tovarni ikki marta sotilmasligi uchun bron qiladi. Javobda o‘z to‘lov raqamingizni — merchant_prepare_id’ni qaytarasiz.
- 02Complete (action = 1). Click yechish natijasini xabar qiladi va o‘sha merchant_prepare_id’ni yuboradi. Siz to‘lovni qayd etasiz va merchant_confirm_id’ni qaytarasiz.
Har bir so‘rov imzolangan. Imzo — to‘lov identifikatorlari, maxfiy kalit, summa, amal va vaqtdan olingan md5. Server uni o‘zi qayta hisoblashi va farq bo‘lsa -1 xatosini qaytarishi shart. Bu tekshiruvsiz ishlov beruvchingiz manzilini bilgan har kim buyurtmani soxta so‘rov bilan «to‘lashi» mumkin.
Prepare: md5(click_trans_id + service_id + SECRET_KEY + merchant_trans_id + amount + action + sign_time)
Complete: md5(click_trans_id + service_id + SECRET_KEY + merchant_trans_id + merchant_prepare_id + amount + action + sign_time)Click qoidalariga ko‘ra, Prepare muvaffaqiyatli o‘tgan va pul yechilgan bo‘lsa, Complete’ga javob xato bo‘lishi mumkin emas — ikki holatdan tashqari: to‘lov allaqachon tasdiqlangan (-4) yoki oldin bekor qilingan (-9). Agar pul yechilgandan keyin tovarni berish imkoni bo‘lmasa, server «muvaffaqiyatli» deb javob beradi va Click Merchant API orqali to‘lovni bekor qilishni o‘zi boshlaydi. Takrorlanuvchi xato javoblar to‘lovni Click qo‘llab-quvvatlash xizmatida qo‘lda ko‘rib chiqishga o‘tkazadi.
Uzum Bank
Uzum Bank’da onlayn to‘lov uchun ikki mahsulot bor. Checkout — sayt, ilova yoki bot uchun to‘lov shakli: karta bilan to‘lov, kartani bog‘lash, qaytarishlar, statuslar va fiskalizatsiya. Merchant API — Uzum Bank ilovasidan to‘lov qabul qilish: mijoz bank ilovasida xizmatingizni tanlaydi, serveringiz esa to‘lov haqidagi xabarnomalarni qayta ishlaydi. Ulanish bankning hamkorlik arizasi orqali boradi.
Arxitektura jihatidan bu o‘sha tamoyil: server buyurtmani tekshiradi, natijani qayd etadi va javob beradi. Shuning uchun uchinchi to‘lov tizimini darhol rejalashtirish oqilona: buyurtma va solishtirish mantiqi bitta, faqat protokol uchun adapter farq qiladi.
Fiskal chek va MXIK kodlari
Xaridor fiskal chek olishi kerak, buning uchun to‘lov tizimi xarid tarkibini bilishi lozim. Payme’da bu CheckPerformTransaction javobidagi detail obyekti: har bir pozitsiya bo‘yicha nomi, tiyindagi birlik narxi, soni, MXIK (IKPU) kodi, qadoq kodi va QQS stavkasi — bu maydonlarning barchasi majburiy. Qadoq kodi tasnif.soliq.uz davlat klassifikatoridagi MXIK kartasidan olinadi. Alohida SetFiscalData metodi Payme’dan tayyor chek ma’lumotlarini, jumladan QR-kod havolasini olish imkonini beradi; bekor qilish uchun ikkinchi, alohida chek shakllanadi.
Click’da fiskalizatsiya — alohida API: to‘lovdan keyin server xarid tarkibini MXIK kodi (SPIC maydoni), qadoq kodi, summa va QQS foizi bilan yuboradi, keyin chek havolasini olishi mumkin. So‘rovlar vaqt va maxfiy kalitdan olingan sha1 xeshli Auth sarlavhasi bilan imzolanadi.
- Har bir tovar va xizmat, jumladan yetkazib berish uchun MXIK kodi va qadoq kodi.
- Har bir pozitsiya bo‘yicha QQS stavkasi.
- Chegirma va promokodlar qoidasi: chekdagi pozitsiyalar summasi to‘lov summasiga teng bo‘lishi kerak.
- Qaytarish tartibi: to‘lov bekor qilinganda alohida qaytarish cheki kerak.
Pul yo‘qolishiga olib keladigan odatiy xatolar
Ulanish qanday o‘tadi
- 01
Shartnoma va kassa
Payme, Click yoki Uzum’ga ariza berasiz, kassa, identifikatorlar va kalitlarni olasiz. Kalitlar sayt yoki bot kodiga emas, faqat serverga uzatiladi.
- 02
Buyurtma modeli
Buyurtma qachon yaratilishi, nima bron qilinishi, qanday statuslar bo‘lishi va nima to‘lov hisoblanishini tasvirlaymiz. Bu barcha to‘lov tizimlari uchun bitta mantiq.
- 03
Protokollar va test muhitida sinovlar
Payme metodlari va Click qadamlarini amalga oshiramiz, test muhitida (sandbox) barcha ssenariylarni tekshiramiz: muvaffaqiyat, rad etish, takror, taym-aut, to‘lovdan keyin bekor qilish. Payme’da sandbox, Click’da test muhiti va so‘rovlar to‘plami bor.
- 04
Cheklar, solishtirish va ogohlantirishlar
Fiskalizatsiyani, kabinet bilan kundalik solishtirishni va har qanday farqda Telegram’ga ogohlantirishni ulaymiz.
- 05
Ishchi serverga ko‘chirish
Kassani ishchi rejimga o‘tkazamiz va qaytarish bilan minimal summaga nazorat xaridini o‘tkazamiz.
Tayyor sayt yoki botga to‘lov tizimlarini ulash Payme, Click va Uzum’ni ulash sahifasidagi «Bog‘lam» darajasiga kiradi: $2 500–6 000, ikki haftadan. Agar do‘kon hali yo‘q bo‘lsa, to‘lov internet-do‘kon loyihasiga boshidanoq kiritiladi. Shartnoma narx va muddatni qat’iy belgilaydi: har bir kechikkan kun uchun hisob 2 foizga kamayadi, jami chegirma esa summaning 10 foizidan oshmaydi; ishlaydigan versiyani har ikki haftada ko‘rasiz.
Ishga tushirishdan oldingi chek-list
- «To‘landi» statusini faqat server to‘lov tizimi so‘rovi bo‘yicha qo‘yadi.
- Aynan shu identifikatorli takroriy so‘rov avvalgi natijani qaytaradi va hech narsa yaratmaydi.
- Server Click imzosini va Payme avtorizatsiyasini tekshiradi.
- Summa har bir so‘rovda tekshiriladi; birliklar — so‘m yoki tiyin — chalkashtirilmagan.
- Har bir kiruvchi so‘rov va javob jurnalga yoziladi.
- Kabinet bilan kundalik solishtirish va farqlar haqida ogohlantirish bor.
- Fiskal chek to‘g‘ri MXIK, qadoq kodlari va QQS bilan shakllanadi.
- Bekor qilish va qaytarish, jumladan qaytarish cheki tekshirilgan.
Ko‘p so‘raladigan savollar
Nimani tanlash kerak: Payme, Click yoki Uzum?
Odatda hammasini birdaniga: xaridorlar turli ilovalardan foydalanadi, odatiy to‘lov usulining yo‘qligi esa sotuvga tushadi. Buyurtma va solishtirish mantiqi umumiy, shuning uchun har bir keyingi tizim birinchisidan sezilarli arzonroq qo‘shiladi.
Telegram-botda saytsiz to‘lov qabul qilish mumkinmi?
Ha. Botga baribir to‘lov tizimi so‘rovlarini qabul qiladigan va buyurtma statusini o‘zgartiradigan server kerak, ammo buning uchun alohida sayt shart emas. Bot to‘lov tugmasini beradi, server to‘lovni tasdiqlaydi, bot mijozga chek va buyurtma statusini yuboradi.
Nega «to‘lov uchun rahmat» sahifasida «to‘landi» qo‘yib bo‘lmaydi?
Chunki bu sahifani to‘lovsiz ochish mumkin, to‘lovdan keyin esa unga yetib bormaslik mumkin. Yagona ishonchli manba — to‘lov tizimining serveringizga so‘rovi: Payme’da PerformTransaction, Click’da Complete.
To‘lov vaqtida serverimiz ishlamay qolsa nima bo‘ladi?
Payme so‘rovlarni o‘sha parametrlar bilan takrorlaydi, javob uzoq vaqt bo‘lmasa, to‘lovni qo‘lda ko‘rib chiqishga beradi. Click ham bir necha muvaffaqiyatsiz urinishdan keyin to‘lovni qo‘lda ko‘rib chiqishga o‘tkazadi. Shuning uchun server takrorlarni to‘g‘ri qayta ishlashi, kundalik solishtirish esa e’tibordan chetda qolgan hamma narsani ushlashi kerak.
Payme va Click orqali to‘lovda fiskal chek kerakmi?
Xaridor fiskal chek olishi kerak. To‘lov tizimlari uni serveringiz uzatgan ma’lumotlar bo‘yicha shakllantiradi: har bir pozitsiya uchun MXIK kodi, qadoq kodi va QQS stavkasi kerak. Ularsiz chek shakllanmaydi.
Ulash qancha turadi va qancha vaqt oladi?
Tayyor sayt yoki botga ulash — «Bog‘lam» darajasi, $2 500–6 000, ikki haftadan. Aniq summa to‘lov tizimlari soniga, fiskalizatsiyaga va statuslar qayerga uzatilishiga bog‘liq: CRM, 1C yoki faqat admin panelga. Boshqa oraliqlar — narxlar sahifasida.
Manbalar
Maqoladagi da’volarni tekshirish mumkin: quyida qayta hikoya emas, birlamchi manbalar.
- 01Payme Business: o‘zaro ishlashni sozlash, Merchant API va Subscribe API
- 02Payme Business: o‘zaro ishlash sxemasi, avtorizatsiya va so‘rovlar takrori
- 03Payme Business: Merchant API protokoli (JSON-RPC 2.0, HTTP 200)
- 04Payme Business: Merchant API metodlari va fiskalizatsiya uchun detail obyekti
- 05Payme Business: CreateTransaction va 12 soatlik taym-aut
- 06Payme Business: ma’lumot turlari va tranzaksiya holatlari
- 07Click: Shop API, Prepare va Complete so‘rovlari
- 08Click: Shop API, xato kodlari
- 09Click: tovar va xizmatlarni fiskalizatsiya qilish
- 10Uzum Bank: hamkorlar uchun hujjatlar (Checkout, Merchant API)
Maqolalarni loyihalarda ishlayotgan muhandislar yozadi va ular tahririyat nomidan chiqadi. Har bir matn uchun bitta muallif emas, studiya va tahririyatning e’lon qilingan qoidalari javob beradi; o‘z ochiq kodimiz haqidagi maqolalar muallif ismi bilan imzolanadi.
Qanday yozamiz va nimani tekshiramiz