WooCommerce UZ

📦 Muhim: Ushbu yo‘riqnoma plaginning barcha uch versiyasiga mos keladi (WooCommerce 8.x, 9.x, 10.x).
Siz foydalanayotgan WooCommerce versiyasiga mos plagin versiyasini tanlang!

1️⃣ Talablar {#tребования}

Tizim talablari

WooCommerce versiyasiga qarab mos plagin tanlanadi:

Umumiy talablar (hamma versiyalar uchun)

• PHP: 7.4+ (tavsiya: 8.0+)

• MySQL: 5.6+ yoki MariaDB 10.2+

• HTTPS: production uchun majburiy

• PHP kengaytmalari: curl, json, mbstring

Global Pay’dan kerakli ma’lumotlar

• Service ID

• OAuth Username

• OAuth Password

• Sandbox yoki Production muhiti uchun akkaunt

📞 Ushbu ma’lumotlarni olish uchun: Global Pay texnik qo‘llab-quvvatlash:
Telegram: @Globalpay_merchants_support

2️⃣ Plagin versiyasini tanlash {#выбор-версии-плагина}

🎯 WooCommerce versiyasini qanday tekshirish?

1. WordPress admin paneliga kiring

2. Plaginlar bo‘limiga o‘ting

3. Ro‘yxatda WooCommerce toping

4. Uning versiyasini ko‘ring (masalan: "10.0.3")

📦 Plaginni yuklab olish

WooCommerce 8.x uchun

📥 Yuklab olish: wc-globalpay-gateway-wc8-v1.0.0.zip

 

 

 

wc-globalpay-gateway-wc8-v1.0.0.zip

02 Dec 2025, 09:03 AM

WooCommerce 9.x uchun

📥 Yuklab olish: wc-globalpay-gateway-wc9-v1.0.0.zip

 

 

 

wc-globalpay-gateway-wc9-v1.0.0.zip

02 Dec 2025, 09:10 AM

WooCommerce 10.x uchun

📥 Yuklab olish: wc-globalpay-gateway-wc10-v1.0.0.zip

 

 

 

wc-globalpay-gateway-wc10-v1.0.0.zip

02 Dec 2025, 09:12 AM

📂 Bitbucket manzili

https://bitbucket.org/global_solutions/global-pay-plugins-woo-8.x-9.x-10-x 

Repository tuzilmasi:

3️⃣ Plaginni o‘rnatish {#установка-плагина}

A varianti: ZIP orqali o‘rnatish (tavsiya etiladi)

1. Kerakli plagin versiyasini yuklab oling (Plagin versiyasini tanlash)

2. WordPress Admin → Plaginlar → Yangi qo‘shish → Plagin yuklash

3. ZIP faylni tanlang

4. O‘rnatish tugmasini bosing

5. Faollashtirish tugmasini bosing

B varianti: Bitbucket orqali o‘rnatish (dasturchilar uchun)

Plagin tarkibi quyidagicha bo‘lishi kerak:

• wc-globalpay-gateway.php

• includes/

• assets/

• languages/

C varianti: Qo‘lda yuklash

1. Bitbucket’dan plagin fayllarini yuklab oling

2. /wp-content/plugins/wc-globalpay-gateway/ papkasiga joylashtiring

3. wc-globalpay-gateway.php asosiy fayl papka ildizida bo‘lishi shart

4. WordPress’da plaginni faollashtiring

4️⃣ Bazaviy sozlamalar {#базовая-настройка}

Qadam 1: Plaginni faollashtirish

• WordPress Admin → Plaginlar

• GlobalPay Payment Gateway ni toping

• Faollashtirish tugmasini bosing

Qadam 2: WooCommerce’da to‘lov usulini sozlash

• WooCommerce → Sozlamalar → To‘lovlar

• Opłata kartoy (GlobalPay) usulini toping

• Boshqarish tugmasini bosing

Qadam 3: Asosiy sozlamalar

🔧 Umumiy sozlamalar

🔐 API sozlamalari

Test muhiti (Sandbox) uchun:

Prodakshen uchun (Production):

🎨 Qo‘shimcha sozlamalar

Qadam 4: Sozlamalarni saqlash

Pastdagi Saqlash tugmasini bosing

5️⃣ Mahsulot maydonlarini sozlash (IKPU va O‘rov kodi)

O‘zbekiston Respublikasida mahsulotlarni markalash va hisob tizimlari bilan to‘g‘ri integratsiya qilish uchun har bir mahsulotga qo‘shimcha maydonlarni to‘ldirish zarur.

IKPU va O‘rov kodi nima?

• IKPU (Identifikatsion Kod Produktsii va Xizmatlari) — bu O‘zbekiston Respublikasi markalash tizimidagi mahsulotning noyob kodi. Bu UzCard va HUMO to‘lov tizimlari orqali to‘lov amalga oshirish uchun majburiy maydon hisoblanadi.

• O‘rov kodi — mahsulot o‘rov turini ko‘rsatuvchi kod bo‘lib, tasniflagichga (klassifikatorga) muvofiq belgilanadi.

1-qadam: IKPU va O‘rov kodini to‘ldirish

GlobalPay plagini faollashtirilgandan so‘ng, ushbu maydonlar avtomatik tarzda mahsulot kartasida paydo bo‘ladi.

Mahsulot uchun maydonlarni to‘ldirish tartibi:

1. O‘ting: WooCommerce → Mahsulotlar (Products)

2. Tahrirlash uchun kerakli mahsulotni tanlang

3. Pastga aylantirib, Product data (Mahsulot ma’lumotlari) bo‘limiga kiring

4. General (Umumiy) varaqasida quyidagi maydonlarni toping:

   • Mahsulot kodi (IKPU) * — majburiy maydon

   • O‘rov kodi * — majburiy maydon

5. Maydonlarni to‘ldirish:

👉 Yangilash (Update) yoki E’lon qilish (Publish) tugmasini bosing.

⚠️ Muhim: Har ikkala maydon (*) bilan belgilanadi va majburiy hisoblanadi. Bu maydonlar to‘ldirilmasa, GlobalPay orqali to‘lov amalga oshmaydi.

2-qadam: Mavjud o‘rov kodlari

Mahsulot kodi (IKPU) va O‘rov kodi maydonlari — bu tasnif.soliq.uz saytidagi ma’lumotnomadan olingan raqamli kodlarni kiritish uchun mo‘ljallangan matnli maydonlardir.

📖 Ma’lumot: Amaldagi mahsulot va o‘rov kodlarini rasmiy saytdan — tasnif.soliq.uz orqali toping. Faqat raqamli kodni kiriting.

3-qadam: Zarur kodlarni qayerdan olish mumkin

O‘rov kodlari (o‘lchov birliklari):

• 🌐 Rasmiy klassifikator: https://tasnif.soliq.uz

• 📞 GlobalPay texnik yordam: support@global.uz — mutaxassislar sizning mahsulot toifangiz uchun to‘g‘ri kodni tanlashda yordam beradi

• 📞 Klassifikator call-markazi: 1198 — bepul maslahat (o‘rov kodlari bo‘yicha)

• 📦 Taqdim etuvchi (ta’minotchi): Mahsulot hujjatlarida kodlar ko‘rsatilgan bo‘lishi mumkin

IKPU (mahsulot kodlari):

• 🌐 https://tasnif.soliq.uz

• 📦 Taqdim etuvchi tomonidan berilgan hujjatlardan foydalaning

• 📞 Call-markaz: 1198 — mahsulot uchun to‘g‘ri IKPU kodini aniqlash bo‘yicha maslahat

📌 Muhim:
IKPU va o‘rov kodlari faqat O‘zbekistonning rasmiy tasnif.soliq.uz klassifikatoridan olinadi.

4-qadam: To‘ldirishni tekshirish

To‘ldirgandan so‘ng, quyidagilarga ishonch hosil qiling:

✅ Mahsulot kodi (IKPU) — 17 xonali raqam bilan to‘ldirilgan
✅ O‘rov kodi — klassifikatordagi raqamli kod (masalan, 796)
✅ Yangilash (Update) tugmasi bosilgan

Tovar endi GlobalPay orqali sotuvga tayyor! Buyurtma amalga oshirilganda, ushbu ma’lumotlar avtomatik tarzda fiskalizatsiya tizimiga uzatiladi.

Ko‘p sonli mahsulotlarni bir vaqtda yangilash (ixtiyoriy)

Agar sizda ko‘p mahsulotlar bo‘lsa va bir xil qiymatni hammasiga o‘rnatmoqchi bo‘lsangiz, quyidagi SQL buyruqlaridan foydalanishingiz mumkin:

⚠️ Eslatma: SQL so‘rovlarini bajarishdan oldin bazaning zaxira nusxasini yarating!

Tez-tez so‘raladigan savollar (FAQ)

Q: Ushbu maydonlarni to‘ldirish majburiymi?

A: Ha, GlobalPay orqali fiskalizatsiya to‘g‘ri ishlashi uchun IKPU va O‘rov kodi majburiydir. Aks holda, to‘lov rad etiladi.

Q: Agar IKPU to‘ldirilmasa nima bo‘ladi?

A: GlobalPay to‘lov tizimi fiskalizatsiya xatosini qaytaradi va to‘lov amalga oshmaydi.

Q: Barcha mahsulotlar uchun bitta IKPU dan foydalanish mumkinmi?

A: Texnik jihatdan mumkin, ammo bu buxgalteriya va qonunchilik nuqtai nazaridan noto‘g‘ri. Har bir mahsulot toifasi uchun o‘ziga xos IKPU bo‘lishi kerak.

Q: O‘rov kodini qayerdan bilsam bo‘ladi?

A: tasnif.soliq.uz saytidan o‘zingizning mahsulot o‘lchov birligiga mos kodni toping va shu kodni kiriting.

Q: IKPU ni keyinchalik o‘zgartirish mumkinmi?

A: Ha, istalgan vaqtda o‘zgartirishingiz mumkin. O‘zgarishlar yangi buyurtmalarga tatbiq etiladi.

Q: WooCommerce admin panelida bu maydonlar qayerda?

A: GlobalPay plagini faollashtirilgandan so‘ng:

• WooCommerce → Mahsulotlar → [Tanlangan mahsulot]

• Product data → General (Umumiy) bo‘limida, narx maydonlaridan keyin joylashgan.

Q: Maydonlar ko‘rinmasa nima qilish kerak?

A:

1. GlobalPay plagini faollashtirilganini tekshiring

2. WordPress keshi (cache) ni tozalang

3. Siz mahsulotni (product post type) tahrirlayotganingizga ishonch hosil qiling

4. Sahifani yangilang (Ctrl+F5)

Q: Variatsiyali mahsulotlar uchun ham to‘ldirish kerakmi?

A: Ha, har ikkala maydonni — oddiy hamda variatsiyali mahsulotlar uchun to‘ldirish kerak. Variatsiyali mahsulotlarda maydonlar asosiy mahsulot darajasida to‘ldiriladi.

📸 Maydonlarni to‘ldirish namunasi:

🔗 Qo‘shimcha manbalar:

• O‘zbekiston tovar va xizmatlar klassifikatori: tasnif.soliq.uz — IKPU va o‘rov kodlarining asosiy manbasi

💡 Tavsiya: tasnif.soliq.uz saytini “Bookmarks”ga qo‘shing — yangi mahsulot qo‘shishda kerak bo‘ladi.

6️⃣ Sinovdan o‘tkazish {#тестирование}

Do‘konni tayyorlash

1. Sinov tovarini yarating:

   • WooCommerce → Tovarlar → Yangi qo‘shish

   • Narxini kamida 1000 so‘m qilib belgilang (masalan, 10000 so‘m)

   • Nashr etish tugmasini bosing

⚠️ Muhim: Sinov uchun buyurtma summasi ≥ 1000 so‘m bo‘lishi kerak. Kichik summalar API tomonidan rad qilinadi.

1. Chekaut sozlamalarini tekshiring:

   • WooCommerce → Sozlamalar → Qo‘shimcha

   • WooCommerce Blocks Checkout yoqilganiga ishonch hosil qiling

Sinov kartalar

⚠️ Muhim: Sinov kartalar faqat Sandbox muhitida ishlaydi.
🔐 Eslatma: HUMO kartasi uchun Sandboxda OTP-kod brauzer konsolida chiqadi, SMS orqali emas. Prodakshenda esa barcha kartalar uchun SMS orqali yuboriladi.

Sinov jarayoni

1. Savatga tovar qo‘shing (≥ 1000 so‘m)

2. Buyurtma berish sahifasiga o‘ting

3. Yetkazib berish ma’lumotlarini kiriting

4. To‘lov usulini tanlang: Opłata kartoy (GlobalPay)

5. Karta ma’lumotlarini kiriting:

   • Karta raqami

   • Amal muddati (MM/YY)

   • CVV (Visa/Mastercard uchun)

   • Karta egasining ismi (Visa/Mastercard uchun)

6. Buyurtmani joylashtirish tugmasini bosing

7. OTP kodni kiriting:

   • HUMO (Sandbox): brauzer konsolidan

   • Uzcard/Visa/Mastercard: SMS orqali

8. Buyurtma muvaffaqiyatli yakunlanganini tekshiring

HUMO uchun OTP kodni topish (faqat Sandbox)

1. DevTools (F12) ni oching

2. Console oynasiga o‘ting

3. Quyidagi xabarni toping: 🔐 TEST OTP CODE: 123456

📝 Eslatma:

• HUMO uchun OTP faqat Sandboxda va brauzer konsolida chiqadi

• Uzcard, Visa va Mastercard uchun OTP har doim SMS orqali keladi

• Prodakshenda barcha kartalar uchun OTP = SMS orqali

7️⃣ Prodakshengа tayyorlash {#настройка-для-продакшена}

Ishga tushirishdan oldingi ro‘yxat

• Prodakshen hisob ma’lumotlari olingan

• Sayt HTTPS orqali ishlayapti

• SSL sertifikati o‘rnatilgan

• Test serverida sinovdan o‘tkazilgan

• Buyurtma xabarnomalari ishlamoqda

• Fayl ruxsatlari to‘g‘ri o‘rnatilgan

Prodakshengа o‘tish

1. WooCommerce → Sozlamalar → To‘lovlar → GlobalPay

2. Muhitni Prodakshen (Production) qilib o‘rnating

3. Quyidagilarni kiriting:

   • Service ID

   • OAuth Username

   • OAuth Password

4. Otladkani o‘chiring:

   • API loglash: ❌

   • Chekaut otladkasi: ❌

5. Sozlamalarni saqlang

Prodakshen test

1. Haqiqiy karta bilan sinov xaridi qiling (≥ 1000 so‘m)

2. Buyurtma WooCommerce’da yaratilganini tekshiring

3. GlobalPay adminida to‘lov statusini ko‘ring

4. Email xabarnoma kelganini tasdiqlang

5. Barcha kartalarda SMS orqali OTP kelayotganini tekshiring

8️⃣ Muammolarni bartaraf etish {#устранение-проблем}

Plagin chekautda ko‘rinmayapti

Muammo: To‘lov usuli mijozga chiqmayapti
Yechim:

1. Plagin faollashtirilganligini tekshiring

2. WooCommerce → To‘lovlar → GlobalPay yoqilganini aniqlang

3. WordPress va brauzer keshi tozalansin

4. Mavzu (tema) WooCommerce bilan mosligini tekshiring

“Ma’lumot topilmadi” xatosi

Muammo: API karta ma’lumotlarini qaytarolmayapti
Yechim:

• API ma’lumotlarini (Service ID, Username, Password) tekshiring

• Muhit (Sandbox yoki Prodakshen) to‘g‘riligini aniqlang

• Karta raqami va amal muddatini tekshiring

• Visa/Mastercard uchun CVV va ismni to‘liq kiriting

• Buyurtma summasi ≥ 1000 so‘m bo‘lishi kerak

OTP kelmayapti

Sandbox – HUMO uchun:

• SMS kelmaydi — brauzer konsolidan oling

Sandbox – Uzcard/Visa/Mastercard:

• SMS kelishi kerak

• GlobalPay qo‘llab-quvvatlash bo‘limi bilan bog‘laning

Prodakshen:

• Har doim SMS orqali OTP yuboriladi

Loglarni tekshirish

1. WooCommerce → To‘lovlar → GlobalPay

2. API loglash ni yoqing

3. Quyidagicha tekshiring:

Yoki WordPress debug log orqali:

Kesh bilan muammo

Muammo: Karta ma’lumotlari bekor bo‘lgandan keyin tozalanmaydi
Yechim:

• Brauzer keshini tozalang (Ctrl+Shift+R)

• WP-CLI orqali tranzientlarni o‘chiring:

Tema yoki plaginlar bilan ziddiyat

Muammo: Plagin ba’zi temalarda ishlamaydi
Yechim:

1. Standart temaga (masalan, Storefront) o‘ting

2. Boshqa plaginlarni navbat bilan o‘chirib tekshiring

3. Brauzer konsolidan JavaScript xatolarini ko‘ring

4. Tema WooCommerce Blocksni qo‘llab-quvvatlashini tekshiring

9️⃣ Qo‘llab-quvvatlash

Repository

Bitbucket:

https://bitbucket.org/global_solutions/global-pay-plugins-woo-8.x-9.x-10-x 

Hujjatlar va texnik yordam

Confluence Wiki:
WooCommerce uchun GlobalPay o‘rnatish va sozlash yo‘riqnomasi

GlobalPay API hujjatlari:

https://globalsolutions.portal.swaggerhub.com/globalpay/docs/main-page

Texnik yordam:
💬 Telegram: @Globalpay_merchants_support

🔟 Qo‘shimcha ma’lumotlar

Qo‘llab-quvvatlanadigan karta turlari

Cheklovlar va talablar

Plagin tuzilmasi

Hujjat versiyasi: 1.0.0
Yangilangan sana: 29 noyabr 2025
Muallif: Rushan Idrisov