
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 з перевіркою, замовлення в статусі очікування з посиланням на оплату, статус за поверненням покупця й кнопкою в…
Разом з 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. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















