📚 Модули Global Pay для OpenCart — Полная документация

Универсальная инструкция по установке и настройке платежных модулей Global Pay для OpenCart 2.x, 3.x и 4.x

📑 Содержание

1. Выбор версии модуля

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

3. Установка

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

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

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

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

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

9. Поддержка

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

1️⃣ Выбор версии модуля {#выбор-версии-модуля}

Модуль Global Pay доступен для трех основных версий OpenCart. Выберите версию, соответствующую вашему магазину:

⚠️ Важно: Используйте только ту версию модуля, которая соответствует вашей версии OpenCart. Установка неподходящей версии может привести к ошибкам.

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

Способ 1: Админ-панель

1. Войдите в админ-панель OpenCart

2. Посмотрите в правый нижний угол страницы

3. Версия отображается в виде: Version 3.0.3.8 или OpenCart 4.0.2.3

 

Способ 2: Файл index.php

1. Откройте файл /admin/index.php

2. Найдите константу VERSION:

 

📦 Скачать модуль

Выберите нужную версию модуля в зависимости от вашей версии OpenCart:

Для OpenCart 2.3.x

📥 Скачать: globalpay-oc2.3-v1.0.0.ocmod.zip 

Для OpenCart 3.x

📥 Скачать: globalpay-oc3-v1.0.0.ocmod.zip 

Для OpenCart 4.x

📥 Скачать: globalpay-oc4-v1.0.0.ocmod.zip 

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

Bitbucket Repository:  
global_solutions/global-pay-plugins-opencart-4.x-3.x-2.3x 

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

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

2️⃣ Системные требования {#системные-требования}

OpenCart 2.3.x

OpenCart 3.x

OpenCart 4.x

Проверка требований

Проверка PHP версии:

Проверка cURL:

Проверка через админку OpenCart:

• Перейдите: System → Maintenance → Error Logs

• Откройте PHP Info (если доступно)

3️⃣ Установка {#установка}

Перед установкой

1. Создайте резервную копию базы данных и файлов магазина

2. Скачайте архив модуля для вашей версии OpenCart (см. раздел Скачать модуль)

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

OpenCart 2.3.x

1. Перейдите в админ-панель OpenCart

2. Extensions → Extension Installer

3. Нажмите Upload (кнопка с иконкой загрузки)

4. Выберите файл globalpay_oc2.ocmod.zip

5. Дождитесь сообщения об успешной установке

6. Перейдите: Extensions → Extensions

7. Выберите тип: Payments

8. Найдите Global Pay в списке

9. Нажмите Install (зеленый значок "+")

OpenCart 3.x

1. Перейдите в админ-панель OpenCart

2. Extensions → Installer

3. Нажмите Upload

4. Выберите файл globalpay_oc3.ocmod.zip

5. Дождитесь завершения установки

6. Перейдите: Extensions → Extensions

7. Выберите тип: Payments

8. Найдите Global Pay

9. Нажмите Install (зеленый "+")

10. Важно: Перейдите в Extensions → Modifications и нажмите Refresh (синяя кнопка обновления)

OpenCart 4.x

1. Перейдите в админ-панель OpenCart

2. Extensions → Installer

3. Нажмите Upload

4. Выберите файл globalpay_oc4.ocmod.zip

5. Дождитесь успешной установки

6. Перейдите: Extensions → Extensions

7. Выберите тип: Payment

8. Найдите Global Pay

9. Нажмите Install

10. Важно: Перейдите в Extensions → Modifications и нажмите Refresh

Вариант B: Ручная установка через FTP

1. Распакуйте архив globalpay_ocX.ocmod.zip на локальном компьютере

2. Загрузите содержимое папки upload/ в корень вашего OpenCart через FTP:

   • Файлы из upload/admin/ → в /admin/

   • Файлы из upload/catalog/ → в /catalog/

3. Перейдите в админ-панель OpenCart

4. Extensions → Modifications → Refresh

5. Extensions → Extensions → тип Payments → найдите Global Pay → Install

Проверка установки

После установки убедитесь, что:

• ✅ Модуль появился в списке Extensions → Extensions → Payments

• ✅ Кнопка Install сменилась на Edit

• ✅ Нет сообщений об ошибках в System → Maintenance → Error Logs

Структура установленных файлов

OpenCart 2.3.x:

OpenCart 3.x и 4.x:

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

Шаг 1: Открытие настроек модуля

1. Перейдите в админ-панель OpenCart

2. Extensions → Extensions

3. Выберите тип: Payments (или Payment в OC4)

4. Найдите Global Pay

5. Нажмите Edit (синяя кнопка с карандашом)

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

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

🔐 Настройки API

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

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

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

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

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

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

Нажмите Save (синяя кнопка сохранения) в правом верхнем углу.

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

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

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

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

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

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

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

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

1. Перейдите: Catalog → Products

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

3. Перейдите на вкладку Data

4. Прокрутите вниз до раздела Global Pay Settings

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

1. Нажмите Save (синяя кнопка в правом верхнем углу)

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

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

Поля IKPU Code и Package Code — это текстовые поля для ввода соответствующих числовых кодов из справочника tasnif.soliq.uz.

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

Наиболее часто используемые коды упаковки

📌 Полный справочник: https://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: Проверка заполнения

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

• ✅ Поле IKPU Code заполнено (17 цифр)

• ✅ Поле Package Code заполнено (числовой код из справочника)

• ✅ Нажата кнопка Save

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

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

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

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

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

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

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

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

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

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

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

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

A: 

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

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

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

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

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

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

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

• Catalog → Products → [Выбрать товар]

• Вкладка Data

• Раздел Global Pay Settings (в нижней части страницы)

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

A:

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

• Проверьте, что в Extensions → Modifications была нажата кнопка Refresh

• Очистите кеш OpenCart: Dashboard → кнопка Refresh (кеш-модификаций)

• Проверьте логи ошибок: System → Maintenance → Error Logs

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

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

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

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

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

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

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

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

   • Catalog → Products → Add New

   • Заполнить основные данные (название, цена)

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

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

     • IKPU Code (Код товара)

     • Package Code (Код упаковки)

   • Сохранить

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

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

   • Убедиться, что модуль Global Pay включен (Status: Enabled)

   • Режим установлен на Sandbox (Test Mode)

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

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

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

Процесс тестирования

1. Добавить товар в корзину (сумма ≥ 1000 сум)

2. Перейти к оформлению заказа (Checkout)

3. Заполнить данные доставки:

   • Имя, фамилия

   • Email

   • Телефон

   • Адрес доставки

4. Выбрать способ оплаты: Global Pay или Оплата картой

5. Ввести данные карты:

   • Номер карты

   • Срок действия (MM/YY)

   • CVV (только для Visa/Mastercard)

   • Имя держателя (только для Visa/Mastercard)

6. Нажать "Confirm Order" (Подтвердить заказ)

7. Ввести OTP-код:

   • Для HUMO (Sandbox): из консоли браузера (см. ниже)

   • Для Uzcard/Visa/Mastercard: из SMS

8. Проверить успешное завершение заказа

Где найти тестовый OTP-код для карт HUMO (только Sandbox)

В тестовой среде Sandbox для карт HUMO OTP-код выводится в консоли браузера:

1. Открыть DevTools (F12)

2. Перейти на вкладку Console

3. Найти сообщение: 🔐 TEST OTP CODE: 123456

📝 Важно:

• OTP-код в консоли отображается только для карт HUMO и только в Sandbox-среде

• Для карт Uzcard, Visa и Mastercard OTP приходит по SMS даже в Sandbox

• В продакшене OTP для всех типов карт приходит по SMS

Проверка результата

После успешной оплаты:

1. Статус заказа должен измениться на Processing (В обработке)

2. Информация о платеже отображается в деталях заказа:

   • Transaction ID

   • Card Type (Visa, Mastercard, Uzcard, Humo)

   • Payment Status

3. Email-уведомление отправлено клиенту и администратору

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

Чек-лист перед запуском

• [ ] Получены продакшн учетные данные от Global Pay

• [ ] Сайт работает по HTTPS

• [ ] Установлен SSL-сертификат

• [ ] Проведено тестирование на тестовом сервере

• [ ] Настроены уведомления о заказах

• [ ] Проверены права доступа к файлам

• [ ] Заполнены поля ИКПУ и Код упаковки для всех товаров

Переключение на продакшн

1. Extensions → Extensions → тип Payments → Global Pay → Edit

2. Изменить Environment на Production (Live Mode)

3. Ввести продакшн учетные данные:

   • Service ID

   • OAuth Username

   • OAuth Password

4. Отключить отладку:

   • Debug Logging: No (Выключено)

5. Нажать Save

Тестирование на продакшене

1. Провести тестовую покупку с реальной картой (сумма ≥ 1000 сум)

2. Проверить создание заказа в OpenCart

3. Проверить статус платежа в админке Global Pay

4. Убедиться в получении email-уведомлений

5. Проверить получение OTP по SMS для всех типов карт (включая HUMO)

Безопасность

• ✅ Используйте HTTPS (SSL-сертификат)

• ✅ Установите права доступа к файлам: 644 для файлов, 755 для папок

• ✅ Ограничьте доступ к админ-панели (IP whitelist, .htaccess)

• ✅ Регулярно обновляйте OpenCart и модули

• ✅ Создавайте резервные копии базы данных

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

Модуль не отображается на чекауте

Проблема: Метод оплаты не виден клиентам

Решение:

1. Проверить, что модуль установлен (Extensions → Extensions → Payments)

2. Проверить, что Status установлен в Enabled

3. Очистить кеш OpenCart:

   • Dashboard → кнопка Refresh (кеш-модификаций)

   • Удалить папки: /system/storage/cache/ и /system/storage/modification/

4. Проверить совместимость темы с OpenCart

5. Проверить логи: System → Maintenance → Error Logs

Ошибка "Информация о карте не найдена"

Проблема: API возвращает ошибку при добавлении карты

Решение:

1. Проверить учетные данные API (Service ID, Username, Password)

2. Убедиться, что выбран правильный режим (Sandbox/Production)

3. Проверить номер карты и срок действия

4. Для Visa/Mastercard обязательно заполнить CVV и имя держателя

5. Убедиться, что сумма заказа ≥ 1000 сум

6. Проверить, что заполнены ИКПУ и Код упаковки для всех товаров в заказе

OTP-код не приходит

Проблема: SMS с OTP не доставляется

Решение (тестовый режим Sandbox для карт HUMO):

1. Для карт HUMO в Sandbox OTP-код не отправляется по SMS

2. OTP-код выводится в консоли браузера (F12 → Console)

3. Искать сообщение: 🔐 TEST OTP CODE: XXXXXX

Решение (тестовый режим Sandbox для Uzcard/Visa/Mastercard):

1. OTP должен приходить по SMS даже в Sandbox

2. Проверить настройки телефона в аккаунте Global Pay

3. Связаться с поддержкой Global Pay, если SMS не приходит

Решение (продакшн для всех карт):

1. В продакшене OTP приходит по SMS для всех типов карт (включая HUMO)

2. Проверить номер телефона в настройках Global Pay

3. Убедиться, что номер телефона корректный

4. Связаться с поддержкой Global Pay

Ошибка "ИКПУ или Код упаковки не заполнены"

Проблема: При оформлении заказа появляется ошибка о недостающих данных

Решение:

1. Открыть каждый товар в заказе: Catalog → Products

2. Перейти на вкладку Data

3. Проверить заполнение полей в разделе Global Pay Settings:

   • IKPU Code

   • Package Code

4. Заполнить пустые поля

5. Сохранить изменения

Проверка логов

Включить логирование:

1. Extensions → Extensions → Payments → Global Pay → Edit

2. Установить Debug Logging: Yes

3. Сохранить

Просмотр логов:

Через файловую систему:

Через админку OpenCart:

• System → Maintenance → Error Logs

• Найти записи с префиксом [GlobalPay]

Формат лога:

Проблемы с кешированием

Проблема: Данные карты не очищаются после отмены, изменения не применяются

Решение:

1. Очистить кеш браузера (Ctrl+Shift+R)

2. Очистить кеш OpenCart:

   • Dashboard → Refresh (синяя кнопка)

3. Удалить кеш через FTP/SSH:

1. Extensions → Modifications → Refresh

Конфликт с темой или модулями

Проблема: Модуль не работает с определенной темой или конфликтует с другими расширениями

Решение:

1. Переключиться на стандартную тему:

   • Design → Themes → выбрать default

2. Отключить другие модули по одному:

   • Extensions → Extensions → отключить подозрительные модули

3. Проверить консоль браузера на JavaScript ошибки (F12 → Console)

4. Проверить логи ошибок: System → Maintenance → Error Logs

Ошибка "cURL error 60: SSL certificate problem"

Проблема: OpenCart не может подключиться к API Global Pay из-за проблемы с SSL-сертификатом

Решение:

1. Обновить cacert.pem на сервере:

1. В php.ini указать путь к сертификату:

1. Перезапустить веб-сервер:

9️⃣ Поддержка {#поддержка}

Репозитории

Bitbucket Repository:  
global_solutions/global-pay-plugins-opencart-4.x-3.x-2.3x 

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

Документация и поддержка

Confluence Wiki:  
Модуль для Opencart. Инструкция по установке и настройке модуля GlobalPay 

Техническая поддержка Global Pay:  
💬 Telegram: @Globalpay_merchants_support

🔟 Дополнительные ресурсы {#дополнительные-ресурсы}

Поддерживаемые типы карт

Ограничения и требования

Совместимость версий модуля

Структура модуля

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

Q: Можно ли использовать модуль с несколькими валютами?

A: В текущей версии модуль работает только с узбекским сумом (UZS). Поддержка других валют не реализована.

Q: Поддерживается ли сохранение карт для повторных платежей?

A: Нет, в текущей версии клиенты должны вводить данные карты при каждой покупке. Функция сохранения карт (tokenization) будет добавлена в будущих версиях.

Q: Можно ли протестировать модуль без получения учетных данных от Global Pay?

A: Нет, для работы модуля требуются Service ID, OAuth Username и OAuth Password даже в тестовом режиме. Обратитесь в техподдержку Global Pay для получения тестовых учетных данных.

Q: Что делать, если после установки модуля сайт перестал работать?

A:

1. Отключите модуль через базу данных:

1. Очистите кеш модификаций:

1. Восстановите сайт из резервной копии

2. Обратитесь в техподдержку

Q: Работает ли модуль с мультиязычными магазинами?

A: Да, модуль поддерживает русский (ru-RU, основной), английский (en-GB) и узбекский (uz-UZ, латиница). Вы можете добавить свои переводы, скопировав языковые файлы и изменив их содержимое.

Версия документа: 1.0.0  
Дата обновления: 20 января 2026  
Автор: Rushan Idrisov

💡 Совет: Сохраните эту инструкцию в закладки для быстрого доступа!