Click, Payme va Uzcard integratsiyasi: internet-doʻkonlar uchun bosqichma-bosqich

Oʻzbekistonda onlayn-toʻlovlarni qabul qilish — bu API-key va commit emas. Bu ekvayring-bank bilan shartnoma, sayt kontentini moderatsiya va Stripe yoki PayPal dan jiddiy farq qiladigan texnik talablar. Quyida — Click, Payme va Uzcard ni prod da syurprizsiz ulashning isbotlangan yoʻli.

UZ uchun toʻlov tizimlarini qisqa tanlash

UZ e-commerce uchun minimal toʻplam: Click + Payme + Uzcard. Bu 95% auditoriyaga yetadi. Qolgan 5% naqd pul yoki bank oʻtkazma.

Click ulash: bosqichma-bosqich

1. my.click.uz da merchant sifatida roʻyxatdan oʻting. Kerak: taʼsis hujjatlari skani, INN, EGRYuL koʻchirmasi, direktor pasporti
2. Sayt moderatsiyasidan oʻtish: ishlaydigan domen, maxfiylik siyosati, oferta, real tovar/xizmatlar narxlar bilan
3. Shaxsiy kabinetda `service_id`, `merchant_id`, `secret_key`, `user_id` oling
4. `/click/prepare` endpoint — toʻlov oldidan buyurtmani validatsiya qilish
5. `/click/complete` endpoint — Click yakuniy callback jo'natadi
6. Har bir soʻrov uchun MD5 imzo qoʻshish (soxtalashtirish himoyasi)
7. Sandbox da testirovaniye — Click test rekvizitlarini beradi
8. Shartnoma imzolangandan va muvaffaqiyatli testdan keyin productionni faollashtirish

Oddiy muddatlar: roʻyxatdan oʻtish 2–7 kun, moderatsiya 3–10 kun, texnik ulash 3–5 kun (tayyor sayt uchun), testirovaniye va faollashtirish 2–3 kun. Jami: **arizadan birinchi tranzaksiyagacha 2–3 hafta**.

Payme ulash: boshqacha yondashuv

Click dan farqli oʻlaroq, Payme JSON-RPC 2.0 ishlatadi va serveringiz oʻzi quyidagi metodlarni amalga oshirishi kerak: `CheckPerformTransaction`, `CreateTransaction`, `PerformTransaction`, `CancelTransaction`, `CheckTransaction`, `GetStatement`. Yaʼni siz Payme ni chaqirmaysiz, Payme sizning serveringizni chaqiradi.

• business.paycom.uz da merchant sifatida roʻyxatdan oʻting
• Merchant ID va kalit oling (test + production alohida)
• Barcha 6 ta majburiy metodni toʻgʻri xato kodlari bilan amalga oshiring
• Payme dan keladigan soʻrovlar uchun basic auth sozlang
• Test tranzaksiyalar orqali Payme texnik tekshiruvdan oʻting
• Moderatsiya 3–7 kun

Muhim: metodlar ≤2 soniyada javob berishi kerak, aks holda Payme tranzaksiyani muammoli deb hisoblaydi. Yuklama koʻp tizimlar uchun navbat orqali asinxron ishlash ishlating (Redis + BullMQ).

Uzcard va Humo: faqat bank orqali

Uzcard va Humo bilan bevosita integratsiya kichik merchantlar uchun mumkin emas. Ulash ekvayring-bank orqali, bu bank Uzcard Processing Center bilan allaqachon shartnomaga ega. Mashhur variantlar:

• Kapitalbank (capital.uz) — ekvayringni faol rivojlantirmoqda
• Ipoteka bank — keng qamrov
• Asia Alliance Bank — tez KYC
• TBC Bank UZ — zamonaviy API, qulay shaxsiy kabinet

Bank orqali ulash muddati: 3–6 hafta. Kerak: shu bankda hisob shartnomasi, aylanma limitlar, KYB hujjatlari. Aylanmasi yoʻq kichik biznes uchun banklar koʻpincha depozit yoki oldindan toʻlangan komissiya talab qiladi.

Saytda toʻlovlarni qabul qilish arxitekturasi

Node.js / Fastify backend uchun tavsiya etilgan sxema:

1. Frontend buyurtma yuboradi → `POST /api/orders` → `order_id` + toʻlov gateway ga havolalar
2. Foydalanuvchi Click/Payme/Uzcard ni tanlaydi → gateway toʻlov sahifasiga yoʻnaltirish
3. Toʻlovdan keyin — serveringizga callback (webhook)
4. Callback imzosini tekshirish → DB dagi buyurtma holatini yangilash
5. Email + Telegram-bot orqali mijozga tasdiqlash yuborish
6. Tranzaksiyani buxgalteriya yozuvida qayd etish

2026 yildagi tuzoqlar

1. Test-xos maydonlar

Click va Payme test muhitida prod rad etadigan rekvizitlarga ruxsat beradi. Toʻlov testlari real summalar bilan (1000 sumdan) va real kartalar bilan oʻtkazilishi kerak — aks holda siz edge-keyslarni ushlamaysiz.

2. Qaytarishlar va qisman qaytarishlar

OʻzR qonuniga koʻra merchant 10 ish kuni ichida pulni qaytarishi shart. Click API orqali qisman qaytarishlarni qoʻllab-quvvatlaydi, Payme — faqat toʻliq. Uzcard uchun qaytarish bank orqali boradi — 1-3 hafta olishi mumkin.

3. Muntazam toʻlovlar / obunalar

Click 2025-yil yanvaridan tokenizatsiyani qoʻllab-quvvatlaydi — karta keyingi yechimlar uchun saqlanadi. Payme — alohida API orqali ham qoʻllab-quvvatlaydi. Uzcard rasman hozircha yoʻq, qoʻlda hisob-faktura chiqarishni ishlating.

Yuridik majburiyatlar

• Saytda oferta — majburiy
• Maxfiylik siyosati — majburiy (OʻRQ "Shaxsiy maʼlumotlar toʻgʻrisida" talablari)
• Merchant INN va F.I.SH. toʻlov sahifasida koʻrinadigan
• Onlayn-kassa orqali chek (2023 yildan barcha e-commerce > 0 sum uchun)
• Oʻzbekistonda QQS uchun soliq roʻyxatdan oʻtish yillik aylanma 1 mlrd sum dan yuqori boʻlsa