Saytda va botda Payme, Click orqali to‘lov qabul qilish

Qisqacha: Payme ham, Click ham mohiyatan bir xil ishlaydi — to‘lov tizimi serveringizga o‘zi murojaat qiladi, server esa buyurtmani tekshiradi, to‘lovni qayd etadi va javob beradi. Sayt va Telegram-bot bitta server modulidan foydalanadi. Pul to‘lov tizimida emas, sizning mantiqingizda yo‘qoladi: takroriy so‘rovlar, yo‘qolgan xabarnomalar va noto‘g‘ri paytda yaratilgan buyurtmalar.

10 daqiqa o‘qish

Qisqacha

  • Payme Merchant API bo‘yicha serveringizdagi oltita asosiy metodni o‘zi chaqiradi; tranzaksiyaning to‘rtta holati bor, tasdiqlanmagani 12 soatdan keyin bekor qilinadi.
  • Click Shop API’da ikkita imzolangan so‘rov yuboradi — Prepare va Complete; imzo — parametrlar va maxfiy kalitdan olingan md5.
  • Uzum Bank sayt va bot uchun Checkout to‘lov shaklini va o‘z ilovasidan to‘lov uchun Merchant API’ni beradi.
  • Fiskal chek uchun har bir pozitsiyaga MXIK (IKPU) kodi, qadoq kodi va QQS stavkasi kerak.
  • Asosiy xatolar: idempotentlik yo‘q, xabarnoma yo‘qolgan va buyurtma brauzerda to‘lovdan keyin yaratiladi.

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.

Metod
Serveringiz nima qilishi kerak
CheckPerformTransaction
Buyurtma mavjudligini, summa to‘g‘riligini va to‘lov mumkinligini tekshirish. Fiskal chek uchun ma’lumotlar ham shu yerda uzatiladi
CreateTransaction
Tranzaksiyani doimiy xotiraga saqlash, buyurtmani bron qilish, uni o‘zgartirishni taqiqlash, «to‘lov kutilmoqda» statusini qo‘yish
PerformTransaction
To‘lovni hisobga olish va buyurtmani «to‘langan» holatiga o‘tkazish
CancelTransaction
Yaratilgan yoki o‘tkazilgan tranzaksiyani bekor qilish; xizmat to‘liq ko‘rsatilgan bo‘lsa — -31007 xatosini qaytarish
CheckTransaction
Tranzaksiyaning joriy holati va har bir o‘tish vaqtini qaytarish
GetStatement
Davr uchun tranzaksiyalar ro‘yxatini berish — solishtirish uchun
Holat
Ma’nosi
1
Tranzaksiya yaratilgan, tasdiq kutilmoqda
2
Tranzaksiya yakunlangan — pul yechilgan
-1
Yakunlanishidan oldin bekor qilingan, jumladan taym-aut bo‘yicha
-2
Yakunlangandan keyin bekor qilingan — qaytarish

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.

  1. 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.
  2. 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.

text
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 Shop API hujjatlaridagi imzo formulalari

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.

Cheklar uchun nimani tayyorlash kerak
  • 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

Xato
Nimaga olib keladi
Idempotentlik yo‘q
Javob yo‘qolganda Payme CreateTransaction va PerformTransaction’ni takrorlaydi. Takrorni tanimaydigan server ikkinchi buyurtma yaratadi, bonuslarni ikki marta hisoblaydi yoki tovarni qayta jo‘natadi. Batafsil tahlil — to‘lovlar idempotentligi haqidagi maqolada.
Yo‘qolgan xabarnoma
Server qayta ishga tushirilgan, qulagan yoki noto‘g‘ri HTTP statusi bilan javob bergan. Pul yechilgan, buyurtma esa «to‘lanmagan». Davosi — har bir kiruvchi so‘rov jurnali, qat’iy protokol bo‘yicha javob va GetStatement orqali kundalik solishtirish.
«To‘landi», ammo buyurtma yo‘q
Buyurtma to‘lov sahifasidan qaytgandan keyin brauzerda yaratiladi. Xaridor tabni yopdi — pul bor, buyurtma yo‘q. To‘g‘risi teskari: buyurtma to‘lovdan oldin yaratiladi, statusni esa faqat server to‘lov tizimi so‘rovi bo‘yicha o‘zgartiradi.
Imzo va manba tekshirilmaydi
Ishlov beruvchi har qanday so‘rovni qabul qiladi. Soxta Complete yoki PerformTransaction buyurtmani pulsiz to‘langan holatga o‘tkazadi.
To‘lov vaqtida buyurtma o‘zgaradi
Xaridor ikkinchi tabda tovar qo‘shdi, summa farq qildi. Protokollar to‘lov vaqtida buyurtmani bron qilishni talab qiladi.
Pul kasr sonlarda
So‘m va tiyinlarni suzuvchi nuqtali turda saqlash solishtirishda tiyinlik farqlar beradi. Butun sonda, tiyinlarda saqlash kerak.

Ulanish qanday o‘tadi

Shartnomadan birinchi to‘lovgacha
  1. 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.

  2. 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.

  3. 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.

  4. 04

    Cheklar, solishtirish va ogohlantirishlar

    Fiskalizatsiyani, kabinet bilan kundalik solishtirishni va har qanday farqda Telegram’ga ogohlantirishni ulaymiz.

  5. 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

Birinchi haqiqiy to‘lovdan oldin tekshiring
  • «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.

  1. 01Payme Business: o‘zaro ishlashni sozlash, Merchant API va Subscribe API
  2. 02Payme Business: o‘zaro ishlash sxemasi, avtorizatsiya va so‘rovlar takrori
  3. 03Payme Business: Merchant API protokoli (JSON-RPC 2.0, HTTP 200)
  4. 04Payme Business: Merchant API metodlari va fiskalizatsiya uchun detail obyekti
  5. 05Payme Business: CreateTransaction va 12 soatlik taym-aut
  6. 06Payme Business: ma’lumot turlari va tranzaksiya holatlari
  7. 07Click: Shop API, Prepare va Complete so‘rovlari
  8. 08Click: Shop API, xato kodlari
  9. 09Click: tovar va xizmatlarni fiskalizatsiya qilish
  10. 10Uzum Bank: hamkorlar uchun hujjatlar (Checkout, Merchant API)
dbit.one injiniring tahririyati
Bu tizimlarni quradigan muhandislar

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

Tegishli xizmatlar

Keyingi o‘qish

Injiniring6 daqiqa o‘qish

Takroriy so‘rov puldan ikki marta yechmasligi kerak

Qisqacha: tarmoq to‘lov o‘tgan-o‘tmaganini aytmaydi — u shunchaki jim qoladi. Mijoz tugmani ikkinchi marta bosadi, mobil ilova so‘rovni o‘zi takrorlaydi, va himoyasiz siz ikki marta yechasiz. Idempotentlik jadvallar va kod darajasida qanday ishlashini hamda uni odatda qayerda buzishlarini ko‘rib chiqamiz.

Narx va muddat5 daqiqa o‘qish

Internet-do‘kon yaratish qancha turadi

Qisqacha: 500 tagacha tovarli katalog, to‘lov, yetkazib berish va boshqaruv paneli bo‘lgan do‘kon $6 000–12 000 turadi va taxminan 5 haftada ishga tushadi. 1C bilan almashinuv, shaxsiy kabinet va bonuslar bilan do‘kon — $15 000–30 000, omborlar, ulgurji savdo va ilovali tarmoq — $40 000–80 000. Quyida — summa nimalardan tuziladi, uni nima sezdirmay shishiradi va nimada tejash mumkin emas.

Tanlov va jarayon10 daqiqa o‘qish

Sayt va ilova uchun texnik topshiriq namunasi

Qisqacha: texnik topshiriq — pudratchi narx va muddatni hisoblaydigan, siz esa ishni qabul qiladigan hujjat. Sayt, bot yoki ilova uchun yuz sahifalik kitob kerak emas. Maqsad, foydalanuvchilar va ularning rollari, qabul qilish mezonlari bilan ssenariylar, ishga tushirish uchun funksiyalar, integratsiyalar, tezlik va xavfsizlik talablari hamda domen, akkauntlar va kod kimning nomiga rasmiylashtirilishi yozilgan bir necha sahifa yetarli. Quyida — nusxa olib to‘ldirsa bo‘ladigan 12 bo‘limli namuna, noaniq va tekshiriladigan ifodalar misollari, ko‘p uchraydigan bo‘shliqlar va texnik topshiriq smetaga qanday ta’sir qilishi. Hozir hujjat yozishga vaqt bo‘lmasa, saytimizdagi brifdan boshlang: biznes tilidagi 25 ta savol va oxirida narxning dastlabki oralig‘i.

Loyihangiz bo‘yicha savollar bormi?

Vazifangizni tasvirlang — 24 soat ichida baho, muddat va reja bilan qaytamiz.

hello@dbit.one