Saytga Click, Payme va Uzum orqali to‘lov ulash

Siz qabul qilmaydigan to‘lov usuli maqolasida yo‘q to‘lov usuli analitikada xuddi tashlab ketilgan savatdek ko‘rinishini yozgan edik. Bu — bitta bozor uchun amaliy davomi: agar O‘zbekistonda sotayotgan bo‘lsangiz, saytingizga Click, Payme yoki Uzum’ni aslida qanday ulaysiz — hujjatlar, pul, integratsiya va ishlab turgan to‘lovni yo‘qotilgan buyurtmalarga aylantiradigan xatolar.

Avval qisqa javob, chunki buni qidirayotganlarning ko‘pchiligiga aynan u kerak:

• Hujjatlar koddan oldin keladi. Har qanday provayderga yuridik shaxs yoki yakka tartibdagi tadbirkor (YaTT), hisob raqami va imzolangan shartnoma kerak. Integratsiya bir haftalik ish; hujjatlar esa ko‘proq vaqt olishi mumkin.
• «To‘lash» tugmasi — eng oson qismi. To‘lov faqat provayder serveri sizning serveringizga murojaat qilib, to‘g‘ri javob olgandagina haqiqiy bo‘ladi. Barcha jiddiy xatolar aynan shu qayta chaqiruvda yashaydi.
• Har bir to‘lovga fiskal chek beriladi, buning uchun esa mahsulotlaringizga soliq katalogidagi kodlar kerak.
• Ko‘pchilik do‘konlar oxir-oqibat bitta emas, ikkita provayder ulaydi. Qaysi ikkitasi — xaridorlaringizga bog‘liq, qaysi logotip yangiroq ekaniga emas.

Koddan oldin nima kerak

Yuridik shaxs yoki YaTT

Click hujjatlarida merchant yuridik shaxs deb ta’riflanadi, Telegram orqali to‘lov bo‘yicha qo‘llanmada esa ochiq yozilgan: to‘lov qabul qilish uchun yuridik shaxs yoki yakka tartibdagi tadbirkor sifatida ro‘yxatdan o‘tgan bo‘lishingiz va tizimga ulangan banklardan biri bilan to‘lov qabul qilish shartnomasini tuzishingiz kerak (Click hujjatlari). Uzum hamkorlar sahifasida tashkilot rekvizitlari (STIR, hisob raqami, bank MFO’si), davlat ro‘yxatidan o‘tganlik guvohnomasi, rahbar pasporti va — YaTTdan tashqari — rahbarni tayinlash to‘g‘risidagi buyruqni so‘raydi (Uzum Bank Partners).

Agar ro‘yxatdan o‘tmagan jismoniy shaxs sifatida sotayotgan bo‘lsangiz, shu yerda to‘xtang va avval ro‘yxatdan o‘ting. Shartnoma imzolay olmaguningizcha hech qanday integratsiya yordam bermaydi.

Hujjatlar

Eng batafsil e’lon qilingan ro‘yxat Click’da: ro‘yxatdan o‘tganlik guvohnomasi, faoliyat talab qilsa litsenziya, direktorni tayinlash buyrug‘i va uning pasporti, ta’sischilar yig‘ilishi bayonnomasi, ustavning barcha sahifalari — va domen shartnomasi (Click hujjatlari). Oxirgi band ko‘ringanidan muhimroq: provayder sayt sizning biznesingizga tegishli ekanini ko‘rmoqchi. Agar domenni dasturchi o‘z nomiga ro‘yxatdan o‘tkazgan bo‘lsa, buni hozir tuzating; qanday qilish kerakligini Saytingiz kimga tegishli maqolasida tushuntirganmiz.

Fiskal chek uchun mahsulot kodlari

Sotadigan har bir mahsulot yoki xizmatingizga tasnif.soliq.uz milliy mahsulotlar katalogidan MXIK (IKPU) kodi va qadoq kodi kerak. Uzum Checkout hujjatlari fiskallashtirishni «qonunchilik bilan belgilangan majburiy jarayon» deb ataydi va ikkala kodni shu katalogdan qanday topishni ko‘rsatadi (Uzum Checkout). Click’ning fiskal API’sida MXIK kodi, qadoq kodi, QQS summasi va QQS stavkasi har bir pozitsiya uchun majburiy maydon sifatida belgilangan (Click fiskallashtirish).

Buni dasturchi ishni boshlashidan oldin buxgalteringiz bilan birga qiling. Kodlarsiz ikki yuz mahsulotli katalog — hech kim rejalashtirmagan qo‘lda ma’lumot kiritish loyihasi.

Bu qancha turadi: komissiya masalasi

Bu yerda nimani tekshira oldik-u, nimani tekshira olmadik — halol aytishimiz kerak.

Click ulanish uchun to‘lov ham, abonent to‘lovi ham yo‘qligini bildiradi; bankka Click orqali o‘tgan aylanmadan foiz ko‘rinishida xizmat haqi to‘laysiz (Click hujjatlari). Foizning o‘zi bank bilan shartnomada belgilanadi va e’lon qilinmaydi.

Uzum hamkorlarni bepul ulaydi va bitta raqamni e’lon qiladi: Uzum kartasi bilan to‘lovlar uchun 0% va boshqa banklar kartalari uchun 0,4% — lekin bu Uzum to‘lov, ya’ni QR kod orqali to‘lov usuli uchun. API orqali onlayn ekvayring haqida faqat narx «tanlangan ekvayring turiga bog‘liq» deyilgan (Uzum Bank Partners).

Payme 2026-yil sentabrida biz kira olgan sahifalarda onlayn ekvayring stavkasini e’lon qilmaydi.

Shuning uchun manbasini ko‘rsata olmaydigan «odatiy komissiya»ni yozmaymiz. O‘rniga maslahatimiz: har bir provayderdan aylanmangiz va toifangiz uchun stavkani yozma ravishda so‘rang, u bilan birga yana uchta savol bering — pul hisobingizga qanchalik tez tushadi (Uzum hisob raqamiga har kuni yechib olishni va’da qiladi), qaytarishlar biror narsa turadimi va aylanma o‘sgani sari stavka o‘zgaradimi.

Integratsiya aslida qanday ishlaydi

Xaridor o‘tishni ko‘radi, serveringiz — yozishmani

Tashqaridan uchalasi bir xil ko‘rinadi: xaridor tugmani bosadi, provayderning to‘lov sahifasiga o‘tadi, Uzcard yoki Humo kartasi bilan to‘laydi va qaytib keladi. Click’dagi eng oddiy variant — bu tom ma’noda my.click.uz/services/pay manziliga servis ID’ngiz, summa va buyurtma raqami bilan havola (Click to‘lov tugmasi); Payme’da ham shunga o‘xshash to‘lov shakli bor.

Saytingizga qaytish hech narsani isbotlamaydi. «Rahmat» sahifangizni istalgan odam ochishi mumkin. Buyurtma faqat provayder serveringizga bu haqda xabar berganda to‘langan hisoblanadi va har bir provayderda bu yozishma uchun o‘z protokoli bor:

• Click (Shop API) serveringizga ikkita so‘rov yuboradi. Prepare buyurtma mavjudmi, summa to‘g‘rimi va uni hali bajara olasizmi, deb so‘raydi; Click hujjatlari onlayn do‘konlarga qayta sotilmasligi uchun mahsulotni shu bosqichda band qilishni aytadi. Complete pul yechilganini bildiradi. Ikkalasi ham tranzaksiya ma’lumotlari va maxfiy kalitingizdan tuzilgan MD5 satr bilan imzolanadi va bu imzoni tekshirish shart (Click Shop API).
• Payme (Merchant API) JSON-RPC orqali ishlaydi: CheckPerformTransaction, CreateTransaction, PerformTransaction, CancelTransaction, CheckTransaction va GetStatement, HTTP Basic autentifikatsiyasi bilan. Hujjatlar buyurtmani to‘lov yoki taymaut bo‘yicha bekor qilinguncha band qilishni, xaridorga uni o‘zgartirishni taqiqlashni talab qiladi, to‘lanmagan tranzaksiyani esa Payme 12 soatdan — 43 200 000 millisekunddan keyin bekor qiladi (Payme CreateTransaction).
• Uzum’da ikkita mahsulot bor. Checkout — saytlar uchun to‘lov shlyuzi: siz to‘lovni ro‘yxatdan o‘tkazasiz, xaridorni Uzum shakliga yuborasiz, to‘lov tugagach Uzum sizga callback yuboradi; u Uzcard va Humo’dan tashqari Visa va Mastercard’ni ham qabul qiladi (Uzum Checkout). Merchant API xaridor sizga Uzum Bank ilovasi ichidan to‘laganda kerak: /check, /create, /confirm, /reverse va /status vebxuklari; 30 daqiqa ichida tasdiqlanmagan tranzaksiya muvaffaqiyatsiz hisoblanadi, serveringizda xato bo‘lsa /status 10 martagacha takrorlanadi (Uzum Merchant API).

Fiskal cheklar

Soliq qo‘mitasining talabi 2022-yil oxirida to‘liq kuchga kirganidan beri to‘lov xizmatlari fiskal chekni xaridor va sotuvchi o‘rtasidagi vositachi sifatida beradi (Gazeta.uz). Payme 2022-yil 24-dekabrdan barcha to‘lovlarga elektron fiskal chek bera boshlagan va merchantlardan sotadigan narsalari uchun MXIK kodi, QQS stavkasi va chek turini so‘ragan (Payme blogi).

Amalda bu integratsiyangiz har bir pozitsiya bo‘yicha ma’lumot yuborishini anglatadi: Payme CheckPerformTransaction javobida pozitsiyalar bilan detail obyektini qabul qiladi (Payme hujjatlari), Click’da to‘lovdan keyin pozitsiyalarni yuborish uchun alohida so‘rov bor (Click fiskallashtirish), Uzum Checkout esa menejeringiz yoqib bersa, bir bosqichli to‘lovlarni avtomatik fiskallashtiradi. Javobda olgan chek havolasini saqlab qo‘ying: kelasi bahorda chek so‘ragan xaridorga qo‘llab-quvvatlash xizmatiga murojaat kerak bo‘lmasligi lozim.

Test rejimi

Uchalasi ham haqiqiy bir so‘m ham harakatlanmasidan oldin sinab ko‘rishga imkon beradi. Payme’ning test.paycom.uz dagi qum qutisi ikki ssenariyni ketma-ket o‘tkazadi — xavfsizlik tekshiruvlari bilan tasdiqlanmagan tranzaksiyalar, keyin bekor qilish bilan tasdiqlanganlari — va haqiqiy to‘lovlarni faqat qum qutisidan muvaffaqiyatli o‘tgandan keyin sinashni tavsiya qiladi (Payme qum qutisi). Click hujjatlarida Prepare va Complete so‘rovlarini brauzerdan to‘g‘ridan-to‘g‘ri serveringizga yuboradigan qum qutisi bor. Uzum Checkout belgilangan 3-D Secure kodi bilan Humo va Uzcard test kartalarini e’lon qiladi.

Yonma-yon taqqoslash

Paynet va o‘z bankingiz orqali to‘g‘ridan-to‘g‘ri karta ekvayringi ham bor. Ularni jadvalga kiritmadik, chunki tekshirish uchun merchantlarga mo‘ljallangan ochiq integratsiya hujjatlarini topa olmadik.

Telegram botlar ham xuddi shu provayderlar bilan ishlaydi

Agar vitrinangiz sayt emas, bot bo‘lsa (Telegram — chat ilovasi emas, vitrina maqolasida shu haqda yozganmiz), Click yoki Payme BotFather’dagi Payments menyusi orqali ulanadi: avval provayderning test ulanishi, keyin merchant logini bilan jonli ulanish. Bot sendInvoice orqali hisob yuboradi va pre-checkout so‘roviga 10 soniya ichida javob berishi shart, aks holda tranzaksiya bekor qilinadi (Telegram). Raqamli mahsulotlar Telegram qoidalarida alohida holat va Telegram Stars orqali to‘lanadi. To‘liq narx manzarasini Telegram bot yaratish narxi 2026 maqolasida tahlil qilganmiz.

Eng qimmatga tushadigan xatolar

1. Buyurtmani qaytish sahifasi bo‘yicha to‘langan deb belgilash. Yagona haqiqat manbai — serverga kelgan imzolangan qayta chaqiruv. Qaytish sahifasi — «to‘lovni tekshiryapmiz» ekrani.
2. So‘m va tiyinni aralashtirish. Click Shop API so‘m yuboradi; Payme va Uzum — tiyin; Click’ning o‘z fiskal API’si esa tiyin kutadi. Pulni eng kichik birlikda butun son sifatida saqlang va chegarada konvertatsiya qiling — Ko‘p valyutalilik aslida nimani anglatadi maqolasidagi qoida, bitta valyutaga qo‘llangan.
3. Mahsulotni band qilmaslik. Click ham, Payme ham tekshiruv va to‘lov orasida buyurtmani ushlab turishni so‘raydi. Busiz oxirgi mahsulot uchun ikki xaridor to‘lashi mumkin.
4. Idempotent bo‘lmagan ishlovchilar. Provayderlar so‘rovlarni takrorlaydi. Uzum /statusni o‘n martagacha takrorlaydi; Click’da «to‘lov allaqachon tasdiqlangan» degan alohida xato bor. Ikki marta kelgan bitta so‘rov ikki marta jo‘natishga olib kelmasligi kerak.
5. Pul yechilgandan keyin xato bilan javob berish. Click ochiq yozadi: Prepare muvaffaqiyatli o‘tib, kartadan pul yechilgan bo‘lsa, Complete’ga javob xato bo‘lishi mumkin emas; buyurtmani bajara olmasangiz, muvaffaqiyat deb javob bering va to‘lovni bekor qilishni boshlang. Xato bilan javob to‘lovni qo‘lda tekshiruvga yuboradi.
6. Fiskal ma’lumotlarni «keyinga» qoldirish. Yo‘q MXIK yoki qadoq kodlari testda emas, ishga tushirishda chiqadi — agar haqiqiy katalog bilan sinamasangiz.
7. Akkauntlarning noto‘g‘ri nomda bo‘lishi. Merchant shartnomasi, domen va kabinetlarga kirish biznesga tegishli, jonli kalitlar esa server konfiguratsiyasida saqlanadi — hech qachon repozitoriyda emas.

Biz bilan qilish qancha turadi

Internet-do‘konlarimiz $499 dan boshlanadi va bir haftadan besh haftagacha tayyor bo‘ladi, narxlar sahifasidagi do‘kon tarifi esa to‘lov shlyuzi, ombor va buyurtmalar, chegirmalar va yetkazib berishni sozlashni, shuningdek olti oylik qo‘llab-quvvatlashni o‘z ichiga oladi. To‘lovli Telegram botlar — $199 dan. Payme va Click bizning stekimizda bor.

Oldingi maqoladagi ish hajmi bo‘yicha halol izoh hamon o‘z kuchida: bitta provayder do‘konning standart yig‘ilishiga kiradi; ikkinchisini qurishdan oldin baholab, narxini aytamiz, shunda siz raqamni ko‘rib qaror qilasiz. Hujjatlar va merchant shartnomasi sizniki bo‘lib qoladi: texnik qismni va mahsulot kodlari ro‘yxatini biz tayyorlaymiz, lekin shartnoma biznesingiz va bank o‘rtasida tuziladi.

Sizga nima kerakligini ayting. Javobda qat’iy narx va topshirish sanasini olasiz — bepul va davom ettirish majburiyatisiz.

Ko‘p beriladigan savollar

Click yoki Payme’ni jismoniy shaxs sifatida qabul qilsa bo‘ladimi?

Provayderlarning o‘z hujjatlariga ko‘ra — yo‘q. Click bank bilan shartnomasi bor yuridik shaxs yoki YaTTni talab qiladi, Uzum tashkilot rekvizitlari va davlat ro‘yxatidan o‘tganlik guvohnomasini so‘raydi. Avval ro‘yxatdan o‘ting: bu eng uzoq qadam va u dasturchingizga bog‘liq emas.

Qaysi provayderni birinchi ulash kerak?

Xaridorlaringiz allaqachon qaysi biri orqali to‘layotgan bo‘lsa, o‘shani. Ma’lumot bo‘lmasa, Click yoki Payme’dan boshlang — ikkalasi ham Uzcard va Humo kartalari uchun keng qo‘llanadi — va Siz qabul qilmaydigan to‘lov usuli maqolasida yozilganidek, amalga oshmagan to‘lovlarni ariza sifatida saqlang. Bir oydan keyin qaysi ikkinchi usul sizga savdoni yo‘qotayotganini bilasiz.

Ulanish qancha vaqt oladi?

Uch provayderning hech biri muddatni e’lon qilmaydi. Hujjatlar, provayder tekshiruvi va qum qutisidagi testlarni birinchi kundan boshlanadigan, do‘konni qurish bilan parallel ketadigan alohida yo‘nalish sifatida rejalashtiring.

Chet elda chiqarilgan kartalarni qabul qilsa bo‘ladimi?

Uzum Checkout qo‘llab-quvvatlanadigan tizimlar orasida Visa va Mastercard’ni ko‘rsatadi. Muayyan xorijiy karta o‘tishi shartnomangiz va kartani chiqargan bankka bog‘liq, shuning uchun saytda va’da qilishdan oldin provayderdan to‘g‘ridan-to‘g‘ri so‘rang va haqiqiy xorijiy karta bilan sinab ko‘ring.

Tilda yoki boshqa konstruktor bu provayderlarni qo‘llab-quvvatlaydimi?

Tilda’da katalog mahsulotlari uchun o‘rnatilgan Click ulanishi bor va u har bir mahsulot uchun MXIK kodi va qadoq kodini so‘raydi (Tilda yordam markazi). Tilda yordam markazida o‘rnatilgan Payme ulanishini topmadik. Agar ikkala provayder yoki buyurtmalar atrofida o‘z mantiqingiz kerak bo‘lsa, aynan shu yerda konstruktor tugaydi va o‘z to‘lov tizimingiz boshlanadi.