
iugu для OpenCart (Pix, boleto, карта)
iugu для OpenCart 4.x, 3.x, 2.3 (Бразилия): Pix и boleto через счёт iugu; Pro добавляет карту с рассрочкой, вебхуки, возвраты, split, журнал. Лицензия навсегда.
- Совместимость
- OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · язык модуля: English, Português (Brasil)
- PHP
- 7.0 и новее
- Версия
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Лицензия
- сайт + тестовая копия, навсегда
- Триал
- 7 дней, без карты, один на сайт
- Обновлено
- 16.11.2026
Что есть во Free,
а что даёт Pro
Бесплатная версия работает без ограничения по времени. Pro добавляет остальные функции из таблицы.
Главное о модуле
Что получают покупатель и магазин
На кассе покупатель выбирает Pix, boleto или (в Pro) карту. CPF или CNPJ он вводит сам либо модуль берёт его из дополнительного поля магазина; контрольные цифры проверяются, и неверный номер до iugu не доходит.
Что в админке
Extensions → Extensions → Payments → iugu by CatCode: вкладки с подключением, кассой, статусами заказа, Pro и журналом.

Триал стартует, когда вы попросите
Свежая установка — бесплатная версия, ничего не включается само. Кнопка «Попробовать Pro 7 дней» → e-mail → ключ сразу в окне и письмом.

Один ключ — сайт и тестовая копия
Переносите сайт — отвяжите лицензию на старом домене и активируйте на новом сами. Тестовая копия (staging., dev.) работает с тем же ключом и места сайта не занимает. Для студий — ключи на 5, 25 сайтов или без ограничений.
Технические требования
OpenCart 4.0.2.x–4.1.x, 3.0.x или 2.3.0.2; PHP 7.0+ для 2.3, расширение cURL.
Нужен аккаунт iugu и API-токены из панели Alia. Для боевых платежей iugu требует верификации компании-мерчанта в Бразилии (CNPJ).
Валюта платежей: BRL. Если в сессии другая валюта или сумма меньше R$ 1,00, метод на кассе не предлагается.
Boleto требует полного адреса плательщика: CEP, улица и номер дома в поле address_1 в виде «Rua X, 123». Без них iugu отклоняет счёт, и покупатель видит сообщение об адресе.
Бесплатная версия не получает вебхуков: boleto, оплаченный позже, обновится только кнопкой «Проверить статус в iugu» или когда покупатель вернётся на сайт. Автостатусы по вебхукам и cron-проверке — Pro.
Заказ ставится в «ожидает оплаты» до оплаты, поэтому неоплаченные Pix и boleto остаются в списке заказов, пока их не отменит магазин или (в Pro) iugu не сообщит о просрочке.
Для оплаты картой нужен Account ID (32 символа из Alia → Configurações → Informações da Conta). AdBlock в браузере покупателя блокирует iugu.js, и тогда покупатель видит соответствующее сообщение. Рассрочка от R$ 5 в месяц; комиссии рассрочки задаются в аккаунте iugu.
Подписки и планы iugu не поддерживаются: модуль принимает разовую оплату заказа.
История версий
Для OpenCart 4.x, 3.x и 2.3: Pix и boleto через счёт iugu, CPF/CNPJ с проверкой, заказ в статусе ожидания со ссылкой на оплату, статус по возврату покупателя и кнопкой в заказе, среды Teste…
Вместе с iugu покупают


Conta Azul ERP для OpenCart — заказы как продажи, клиенты по CPF/CNPJ (Бразилия)

Brazilian Checkout Fields для OpenCart 2.3, 3.x и 4.x — CPF, CNPJ, адрес по CEP

Konduto Antifraud для OpenCart — антифрод-анализ заказов для Бразилии
Полное описание модуля
iugu by CatCode для OpenCart 4.x, 3.x и 2.3 принимает в бразильских реалах Pix и boleto через счёт (fatura) iugu с вашим собственным аккаунтом iugu. Покупатель выбирает способ оплаты на кассе, вводит CPF или CNPJ и переходит на страницу оплаты iugu с QR-кодом Pix или boleto.
Что получают покупатель и магазин
На кассе покупатель выбирает Pix, boleto или (в Pro) карту. CPF или CNPJ он вводит сам либо модуль берёт его из дополнительного поля магазина; контрольные цифры проверяются, и неверный номер до iugu не доходит. Счёт создаётся с суммой заказа в центах, данными плательщика (имя, телефон, адрес, CEP) и сроком оплаты, который вы задаёте в настройках.
Заказ ставится в статус «ожидает оплаты», корзина очищается, а ссылка на оплату (для boleto ещё и линия для банковского приложения) лежит в истории заказа и в письме покупателю. Покупателя переводит на страницу iugu; если он возвращается, не заплатив, то видит страницу «заказ ждёт оплаты» с кнопками «Открыть страницу оплаты» и «Проверить ещё раз».
Статус счёта модуль читает в iugu и ведёт заказ по таблице переходов iugu: поздний или повторный ответ никогда не отменяет уже проведённую оплату, а если оплаченная сумма не совпадает с заказом, статус не меняется и остаётся заметка. Два одновременных нажатия «Continue with iugu» дают один счёт, а не два.
Если iugu недоступен, ответил ошибкой или отклонил адрес, покупатель видит короткое понятное сообщение, заказ не создаётся, а корзина остаётся на месте; подробности пишутся в журнал попыток.
Что в админке
Extensions → Extensions → Payments → iugu by CatCode: вкладки с подключением, кассой, статусами заказа, Pro и журналом. В панели iugu (Alia → Configurações → Integrações API) создайте токен типа Teste и токен типа Produção, вставьте их, выберите среду и нажмите «Check connection»: модуль покажет, принял ли iugu токен, и сколько счетов в аккаунте. Токены хранятся зашифрованными и на странице не показываются; пустое поле оставляет сохранённый токен.
Настройки кассы: название метода и описание для каждого языка магазина, срок оплаты, геозона, порядок сортировки и статусы заказа для «ожидает оплаты», «оплачено», «отменено», «просрочено» и «возвращено». Интерфейс модуля — на английском и португальском (Бразилия).
Вкладка iugu на странице заказа показывает счета, способ оплаты, состояние, сумму и журнал событий по каждому счёту, а кнопка «Проверить статус в iugu» перечитывает счёт. В Pro там же отменяется счёт и делается возврат (для карты также частичный). Журнал платежей с фильтрами, итогами и экспортом в CSV открывается из настроек.
Без лицензии Pro-поля показываются выключенными с пояснением, а сохранённые Pro-значения не попадают в запросы к iugu. Кнопка «Try Pro» запускает пробный период на 7 дней.
Как это работает, шаг за шагом
- Установите архив для вашей версии OpenCart и установите метод в разделе «Payments».
- В панели iugu создайте API-токены (Teste и Produção) и вставьте их на вкладке подключения.
- Выберите среду, укажите Account ID (для карты) и нажмите «Check connection».
- Задайте название метода, срок оплаты и статусы заказа.
- Оформите заказ в BRL, выберите Pix или boleto, введите CPF или CNPJ и нажмите «Continue with iugu».
- В Pro добавьте адрес вебхука в панели iugu (Gatilhos) или вызовите cron-URL из настроек.
Что под капотом
- iugu API v1: счета (invoices), отмена, возврат, оплата картой по токену iugu.js; авторизация токеном аккаунта.
- Данные карты не попадают в магазин: iugu.js превращает её в одноразовый токен в браузере покупателя, на сервер идёт только токен.
- Вебхуки iugu не содержат подписи, поэтому тело вебхука не берётся на веру: модуль перечитывает счёт в iugu и применяет только его реальное состояние; поддельное сообщение ничего не меняет. Ссылка вебхука подписана.
- Каждое изменение состояния выполняется под замком на счёт: параллельные копии вебхука дают одну запись, а запоздавший статус не откатывает более новый.
- Токены хранятся зашифрованными; в журнале модуля нет токенов, данных карты, e-mail, имени, телефона, адреса и полного CPF.
- Фоновая проверка открытых счетов работает только в Pro, порциями, и закрывает случаи, когда вебхук не дошёл.
- Интерфейс на английском и португальском (Бразилия).
Установка
- OpenCart 4: Extensions → Installer, загрузите cc_iugu.ocmod.zip, не переименовывая его.
- OpenCart 3.x: Extensions → Installer, загрузите cc_iugu-oc3.ocmod.zip, затем Extensions → Modifications → Refresh.
- OpenCart 2.3: Extensions → Installer, загрузите cc_iugu-oc2.ocmod.zip (нужны настройки FTP в System → Settings → FTP; иначе распакуйте архив и загрузите содержимое папки upload/ в корень магазина вручную), затем Extensions → Modifications → Refresh.
- Extensions → Payments → iugu by CatCode: установите и откройте настройки.
- Вставьте API-токены, выберите среду и нажмите «Check connection».
- Для Pro: вставьте ключ лицензии или запустите пробный период на вкладке «Pro».
Вопросы
о модуле
Не нашли ответ? Напишите в Telegram — ответим в течение рабочего дня.
Это официальный модуль iugu?
Нет, это независимая интеграция через публичный API iugu. iugu является торговой маркой своего владельца.
Где взять API-токены?
В панели iugu (Alia): Configurações → Integrações API. Создайте токен типа Teste для пробных платежей и Produção для боевых.
Какие способы оплаты есть?
Pix и boleto в бесплатной версии, кредитная карта с рассрочкой 2–12 в Pro.
Проходят ли данные карты через мой сайт?
Нет. iugu.js в браузере покупателя создаёт одноразовый токен, на ваш сервер идёт только он.
Что будет, если покупатель оплатил Pix, но не вернулся на сайт?
В Pro вебхук iugu и фоновая проверка сами изменят статус заказа. В бесплатной версии статус обновит кнопка «Проверить статус в iugu» в заказе.
Почему boleto отклоняется?
iugu требует полный адрес плательщика: CEP, улицу и номер. Номер модуль берёт из поля address_1 («Rua X, 123»); если его нет, покупатель видит сообщение об адресе, а заказ не создаётся.
Можно ли вернуть деньги?
Да, в Pro: возврат со страницы заказа, для карты также частичный.
Какие валюты поддерживаются?
Только BRL. В другой валюте метод на кассе не показывается.
Какие версии OpenCart поддерживаются?
OpenCart 4.0.2.x–4.1.x, 3.0.x и 2.3.0.2: три отдельных архива в одном продукте.
Лицензия навсегда?
Да, для OpenCart это одна оплата и лицензия навсегда, на два сайта.
Что будет после пробного периода?
Pro выключается, бесплатная часть продолжает работать.
Пока нет ни одного отзыва. Будьте первым.
Пока вопросов нет. Спроси — мы ответим в течение 24 часов.
Не тот вариант, что искали?
Делаем кастомные модули под WordPress, WooCommerce, OpenCart и Shopify. Расскажите о задаче — подготовим оценку.
Заказать кастомный модуль
Покупка модуля
—
Оплата списывается в гривне, ваш банк пересчитает её в вашу валюту. Цена в евро ориентировочная.




















