Инструкция по установке и настройке плагина Global Pay для WooCommerce

Версия плагина: 1.0.0  
Дата обновления: 29 ноября 2025  
Автор: Rushan Idrisov

📦 Важно: Эта инструкция применима ко всем трём версиям плагина (WooCommerce 8.x, 9.x, 10.x).  
Выберите версию плагина, соответствующую вашей версии WooCommerce!

📋 Содержание

1. Требования

2. Выбор версии плагина

3. Установка плагина

4. Базовая настройка

5. Настройка полей товаров (ИКПУ и Код упаковки)

6. Тестирование

7. Настройка для продакшена

8. Устранение проблем

9. Поддержка

10. Дополнительные ресурсы

1️⃣ Требования {#требования}

Системные требования

Выберите версию плагина под вашу версию WooCommerce:

Общие требования (для всех версий):

• PHP: 7.4 или выше (рекомендуется 8.0+)

• MySQL: 5.6+ (или MariaDB 10.2+)

• HTTPS: Обязательно для продакшена

• PHP extensions: curl, json, mbstring

Необходимые данные от Global Pay

• Service ID (идентификатор сервиса)

• OAuth Username (логин для API)

• OAuth Password (пароль для API)

• Доступ к тестовой среде (sandbox) или продакшену

📞 Получение учетных данных: Все учетные данные (тестовые и продакшн) необходимо запрашивать в технической поддержке Global Pay:  
Telegram: @Globalpay_merchants_support

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

🎯 Как узнать вашу версию WooCommerce

1. Войдите в WordPress Admin → Плагины

2. Найдите WooCommerce в списке установленных плагинов

3. Посмотрите номер версии (например, "Версия 10.0.3")

📦 Скачать плагин

Выберите нужную версию плагина в зависимости от вашей версии WooCommerce:

Для WooCommerce 8.x

📥 Скачать: wc-globalpay-gateway-wc8-v1.0.0.zip

Для WooCommerce 9.x

📥 Скачать: wc-globalpay-gateway-wc9-v1.0.0.zip

Для WooCommerce 10.x

📥 Скачать: wc-globalpay-gateway-wc10-v1.0.0.zip

📂 Альтернативный источник

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

Структура репозитория:

3️⃣ Установка плагина {#установка-плагина}

Вариант A: Установка через ZIP-архив (рекомендуется)

1. Скачайте нужную версию плагина (см. раздел Выбор версии плагина)

2. В WordPress Admin перейдите: Плагины → Добавить новый → Загрузить плагин

3. Выберите скачанный ZIP-файл и нажмите Установить

4. После установки нажмите Активировать

 

 

Вариант B: Установка через Bitbucket (для разработчиков)

📞 Доступ к репозиторию: Для получения доступа к Bitbucket-репозиторию обратитесь в техподдержку Global Pay:  
Telegram: @Globalpay_merchants_support

Должны быть файлы:

• wc-globalpay-gateway.php (главный файл)

• includes/ (папка с классами)

• assets/ (папка со стилями и скриптами)

• languages/ (переводы)

Вариант C: Ручная загрузка

1. Скачайте файлы плагина из Bitbucket

2. Загрузите в /wp-content/plugins/wc-globalpay-gateway/

3. Убедитесь, что главный файл wc-globalpay-gateway.php находится в корне папки плагина

4. Активируйте плагин в WordPress Admin → Плагины

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

Шаг 1: Активация плагина

1. Перейдите в WordPress Admin → Плагины

2. Найдите Global Pay Payment Gateway

3. Нажмите Активировать

Шаг 2: Настройка платежного модуля в WooCommerce

1. Перейдите: WooCommerce → Настройки → Платежи  
   (или просто Платежи в главном меню, если доступно)

2. Найдите Оплата картой (Global Pay)

3. Нажмите Управление

 

Шаг 3: Основные настройки

 

🔧 Общие настройки

🔐 Настройки API

Для тестовой среды (Sandbox):

📞 Тестовые учетные данные: Запросите в техподдержке Global Pay:  
Telegram: @Globalpay_merchants_support

Для продакшена (Production):

📞 Продакшн учетные данные: Запросите в техподдержке Global Pay:  
Telegram: @Globalpay_merchants_support

🎨 Дополнительные настройки

Шаг 4: Сохранить настройки

Нажмите Сохранить изменения внизу страницы.

5️⃣ Настройка полей товаров (ИКПУ и Код упаковки) {#настройка-полей-товаров}

Для корректной интеграции с системой маркировки и учёта товаров в Узбекистане необходимо заполнить дополнительные поля для каждого товара.

Что такое ИКПУ и Код упаковки

• ИКПУ (Идентификационный Код Продукции и Услуг) — уникальный код товара в системе маркировки Республики Узбекистан. Это обязательное поле товара для оплаты через системы UzCard и HUMO.

• Код упаковки — код, определяющий тип упаковки товара согласно классификатору

Шаг 1: Заполнение полей ИКПУ и Код упаковки

После активации плагина Global Pay поля автоматически появляются в карточке товара.

Заполнение полей для товара

1. Перейдите: WooCommerce → Товары

2. Выберите товар для редактирования

3. Прокрутите вниз до раздела Product data (Данные о товаре)

4. На вкладке General найдите поля:

   • Код товара (ИКПУ) \* — обязательное поле

   • Код упаковки \* — обязательное поле

5. Заполните значения:

1. Нажмите Обновить или Опубликовать

⚠️ Важно: Оба поля обязательны и помечены звёздочкой (\*). Без заполнения этих полей платеж через Global Pay будет невозможен.

 

Шаг 2: Доступные коды упаковки

Поля Код товара (ИКПУ) и Код упаковки — это текстовые поля для ввода соответствующих числовых кодов из справочника tasnif.soliq.uz.

📖 Справка: Актуальные коды товара и упаковки необходимо получить из официального справочника tasnif.soliq.uz. Вводите только числовой код из справочника.

Шаг 3: Где получить необходимые коды

Где получить коды упаковки и ИКПУ

Коды упаковки (единицы измерения):

• 🌐 Официальный классификатор: https://tasnif.soliq.uz

• 💬 Техподдержка Global Pay (Telegram): @Globalpay_merchants_support — специалисты помогут подобрать коды для вашей категории товаров

• ☎️ Call-центр классификатора: 1198 — бесплатная консультация по кодам упаковки

• 📦 От поставщика: Коды могут быть указаны в сопроводительной документации на товар

ИКПУ (коды товаров):

• 🌐 Официальный классификатор: https://tasnif.soliq.uz

• 📦 От поставщика: Используйте ИКПУ коды, указанные в документации от дистрибьютора

• ☎️ Call-центр: 1198 — консультация по определению ИКПУ для товара

📌 Важно: ИКПУ и коды упаковки берутся из узбекского классификатора товаров и услуг tasnif.soliq.uz

Шаг 4: Проверка заполнения

После заполнения полей убедитесь:

• ✅ Поле Код товара (ИКПУ) заполнено (17 цифр)

• ✅ Поле Код упаковки заполнено (числовой код из справочника, например 796)

• ✅ Нажата кнопка Обновить

Товар готов к продаже через Global Pay! При оформлении заказа эти данные будут автоматически отправлены для фискализации.

Массовое обновление товаров (опционально)

Если у вас много товаров и нужно установить одинаковые значения для всех, можно использовать SQL:

⚠️ Важно: Перед выполнением SQL запросов обязательно создайте резервную копию базы данных!

Часто задаваемые вопросы

Q: Обязательно ли заполнять эти поля?

A: Да, для корректной фискализации через Global Pay поля ИКПУ и Код упаковки являются обязательными. Без них платёж будет отклонён на этапе фискализации чека.

Q: Что будет, если не заполнить ИКПУ?

A: При попытке оплаты через Global Pay система вернёт ошибку фискализации, и платёж не будет обработан. Товар без ИКПУ не может быть продан через платёжный шлюз.

Q: Можно ли использовать один ИКПУ для всех товаров?

A: Технически да, но это неправильно с точки зрения бухгалтерского учёта и законодательства. Каждая категория товаров должна иметь свой уникальный ИКПУ согласно классификатору.

Q: Как узнать правильный код упаковки для моего товара?

A: 

• Коды упаковки берутся из узбекского классификатора tasnif.soliq.uz

• Найдите в справочнике соответствующий единице измерения вашего товара код

• Введите в поле числовой код из справочника

Q: Можно ли изменить ИКПУ после создания товара?

A: Да, вы можете изменить ИКПУ в любое время. Изменения вступят в силу для новых заказов.

Q: Где в админке WooCommerce найти эти поля?

A: После активации плагина Global Pay поля автоматически появляются в:

• WooCommerce → Товары → [Выбрать товар]

• Раздел Product data

• Вкладка General (первая вкладка)

• Поля находятся после полей цены

Q: Что делать, если поля не отображаются?

A:

• Убедитесь, что плагин Global Pay активирован

• Очистите кеш WordPress (если используется кеш-плагин)

• Проверьте, что вы редактируете именно товар (post_type = product)

• Обновите страницу (Ctrl+F5)

Q: Нужно ли заполнять эти поля для вариативных товаров?

A: Да, поля ИКПУ и Код упаковки нужно заполнять как для простых, так и для вариативных товаров. Для вариативных товаров поля заполняются на уровне основного товара.

🔗 Дополнительные ресурсы

• Классификатор товаров и услуг Узбекистана (tasnif.soliq.uz) — Основной источник ИКПУ и кодов упаковки

💡 Рекомендация: Добавьте ссылку tasnif.soliq.uz в закладки — она понадобится при добавлении новых товаров.

6️⃣ Тестирование {#тестирование}

Подготовка магазина

1. Создать тестовый товар:

   • WooCommerce → Товары → Добавить новый

   • Установить цену минимум 1000 сум (например, 10000 сум)

   • Заполнить обязательные поля:

     • Код товара (ИКПУ)

     • Код упаковки

   • Опубликовать

⚠️ Важно: Минимальная сумма заказа для тестирования — 1000 сум. Заказы с меньшей суммой могут быть отклонены API.

1. Проверить настройки чекаута:

   • WooCommerce → Настройки → Дополнительно

   • Убедиться, что включен WooCommerce Blocks Checkout (рекомендуется)

Тестовые карты

⚠️ Важно: Тестовые карты работают только в Sandbox режиме!

🔐 *\Примечание: Для тестовых карт HUMO в Sandbox-среде OTP-код выводится в консоли браузера, а не отправляется по SMS. В продакшене OTP приходит по SMS для всех типов карт.