VibeFox Iugu for OpenCart — Допомога

Вимоги

OpenCart: 3.0.x (перевірено на 3.0.5.0) або 4.0.2 і новіші (перевірено на 4.1.0.3).

PHP: 8.0 або новіша.

Валюта: бразильський реал (BRL). Iugu приймає оплату лише в BRL, тому в магазині має бути валюта BRL у розділі System > Localisation > Currencies. Спосіб оплати приховується, якщо покупець оформлює замовлення в іншій валюті, а також при сумі менше R$ 1,00 (мінімум Iugu).

Обліковий запис Iugu: потрібні два API-токени з панелі Iugu: один типу «Test», другий типу «Live» (див. Configuration). Iugu використовує одну адресу API для обох: токен визначає, чи є рахунки тестовими або справжніми. Вебхук в Iugu налаштовувати не потрібно.

CPF/CNPJ (необов'язково): в OpenCart немає власного поля CPF. Якщо ви додасте користувацьке поле клієнта або адреси, назва якого містить CPF або CNPJ (Customers > Custom Fields), його значення передається в Iugu.

Ліцензійний ключ VibeFox: купується на vibefox.net. Один ключ працює на одному домені.

Встановлення

Завантаження — це один zip-файл із пакетами для обох версій OpenCart. Розпакуйте його на своєму комп'ютері. Він містить README.txt, пакет для OpenCart 3 wcp_iugu_gateway-oc3-(version).ocmod.zip і пакет для OpenCart 4 wcp_iugu_gateway.ocmod.zip. Встановлюйте лише пакет для вашої версії OpenCart. Ліцензійний ключ однаковий для обох версій.

OpenCart 3

1. В адмінпанелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл wcp_iugu_gateway-oc3-(version).ocmod.zip. Розширення не містить модифікацій OCMOD, тому оновлювати Extensions > Modifications не потрібно. Замість інсталятора можна скопіювати вміст папки upload цього пакета в кореневу папку вашого магазину.

2. Перейдіть до Extensions > Extensions і виберіть тип Payments. Знайдіть VibeFox Iugu Gateway і натисніть Install (зелена кнопка +). Вашому адміністратору потрібне право змінювати список платіжних розширень.

3. Натисніть Edit (кнопка з олівцем), щоб відкрити сторінку налаштувань. Вставте ліцензійний ключ VibeFox у поле License key у блоці ліцензії вгорі сторінки і натисніть Activate (див. License key).

4. Введіть тестовий і робочий API-токени (див. Configuration), залиште увімкненим Test mode, увімкніть Enable / Disable і натисніть Save.

5. Оформіть тестове замовлення в BRL і оплатіть його на сторінці Iugu тестовим платежем Iugu. Коли все буде готово, вимкніть Test mode.

OpenCart 4

1. В адмінпанелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл wcp_iugu_gateway.ocmod.zip. Не перейменовуйте файл: OpenCart 4 бере код розширення з назви файлу, і перейменований пакет не працює.

2. Пакет з'являється у списку встановлених розширень на цій самій сторінці. Натисніть Install (зелена кнопка +) поруч із ним.

3. Перейдіть до Extensions > Extensions і виберіть тип Payments. Знайдіть VibeFox Iugu Gateway, натисніть Install (зелена кнопка +), а потім Edit (кнопка з олівцем).

4. Введіть ліцензійний ключ і API-токени так само, як у кроках 3–5 для OpenCart 3. Сторінка налаштувань і її поля однакові в обох версіях. Відрізняється лише URL сповіщень (див. Сповіщення про оплату).

Після нового встановлення спосіб оплати вимкнено, а тестовий режим увімкнено.

Налаштування

Усі налаштування розташовані на сторінці розширення: Extensions > Extensions > Payments > VibeFox Iugu Gateway > Edit. Розділи перелічені ліворуч; кнопка Save під списком зберігає всю сторінку. Над налаштуваннями сторінка показує TEST MODE (рахунки створюються з тестовим API-токеном, справжніх списань немає) або LIVE. Вона попереджає, коли відсутній токен активного режиму (тоді спосіб оплати приховується на оформленні), і коли валюта магазину за замовчуванням не BRL (тоді Iugu не пропонується для інших валют). Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.

При збереженні Title не може бути порожнім або довшим за 128 символів, Sort Order має бути цілим числом, Total — числом 0 або більше, а вибрані географічна зона та статуси замовлень мають існувати. Інакше нічого не зберігається, і помилка називає поле.

Iugu

Enable / Disable: Enable Iugu payments вмикає або вимикає спосіб оплати. За замовчуванням: вимкнено.

Title: назва способу оплати, яку бачить покупець на оформленні. Вона також зберігається в замовленні як спосіб оплати. За замовчуванням: Iugu. Обов'язково, до 128 символів.

Description: текст, який показується покупцю на кроці Confirm Order над кнопкою підтвердження. За замовчуванням: Безпечна оплата через Iugu. Вас буде перенаправлено для завершення оплати.

Sort Order: місце Iugu серед способів оплати на оформленні. Залиште поле порожнім або введіть ціле число.

Geo Zone: пропонувати Iugu лише для адрес оплати у вибраній географічній зоні. За замовчуванням: All zones. Географічні зони налаштовуються в System > Localisation > Geo Zones.

Total: сума оформлення в валюті магазину за замовчуванням, яку має досягти замовлення, перш ніж буде запропоновано Iugu. Залиште порожнім, щоб пропонувати Iugu за будь-якої суми. Сам Iugu потребує мінімум R$ 1,00.

Облікові дані API

Створіть API-токени в Iugu Alia (розділ містить посилання туди): Settings > API integration > New. Створіть один токен типу «Test» і один типу «Live».

Test mode: використовує тестовий API-токен, тому справжні списання не виконуються. За замовчуванням: увімкнено. Поки тестовий режим увімкнено, покупці на кроці Confirm Order над описом бачать SANDBOX — Test mode enabled. No real charges. Перевірки статусу та повернення коштів для замовлення завжди використовують токен того режиму, в якому створено його рахунок, тож зміна режиму не ламає старі замовлення.

Test API token: API-токен Iugu типу «Test». Використовується, поки увімкнено тестовий режим.

Live API token: API-токен Iugu типу «Live» (продакшн). Використовується, коли тестовий режим вимкнено. Тримайте його в таємниці.

Збережені токени більше не показуються. Поле залишається порожнім і показує Saved — leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити. Щоб видалити збережений токен, позначте Clear the saved token on save під полем і натисніть Save.

Сповіщення про оплату

Notification URL: кожен рахунок повідомляє Iugu, що потрібно надсилати зміни статусу на цю URL вашого магазину. На OpenCart 3 вона має вигляд https://your-store/index.php?route=extension/payment/wcp_iugu_gateway/webhook, на OpenCart 4 — https://your-store/index.php?route=extension/wcp_iugu_gateway/payment/wcp_iugu_gateway.webhook. Вона має бути доступною з інтернету. В Iugu нічого налаштовувати не потрібно. Додатковий тригер на рівні облікового запису, що вказує на ту саму URL, безпечний. Сповіщення не містять платіжних даних, яким довіряє магазин: рахунок завжди повторно зчитується з API Iugu (статус, сума, валюта) перед тим, як замовлення зміниться.

Розширення реагує на події Iugu, перелічені в цьому розділі: invoice.status_changed, invoice.refund, invoice.released, invoice.dunning_action та invoices. Для кожної з них воно зчитує рахунок і застосовує його статус:

paid: замовлення отримує Order Status After Payment після перевірки суми та валюти.

authorized або in_analysis: оплата карткою очікує на списання або перебуває на перевірці. Замовлення отримує Iugu Payment On Hold Status.

partially_paid: рахунок оплачено частково. Замовлення отримує Iugu Payment On Hold Status.

pending: сповіщення не змінює замовлення. Лише коли покупець повертається з виставленим boleto або PIX, замовлення отримує Awaiting Iugu Payment Status.

expired: рахунок прострочено без оплати. Замовлення в очікуванні отримує Invoice Expired Status.

canceled: рахунок скасовано. Замовлення в очікуванні отримує Invoice Canceled Status.

refunded: рахунок повернено в Iugu. Замовлення отримує Refunded Status.

chargeback: власник картки оскаржив оплату. Оплачене замовлення отримує Iugu Payment On Hold Status.

Прострочений або скасований рахунок замовлення, яке ще не має статусу, залишає замовлення без статусу, щоб покупець міг оплатити знову. Інші події та рахунки, створені не вашим магазином, отримують відповідь HTTP 200 і ігноруються без запиту до Iugu. Без сповіщень рахунок перевіряється лише тоді, коли покупець повертається до магазину зі сторінки Iugu.

Замовлення

OpenCart створює замовлення на кроці Confirm Order без статусу (відсутнє замовлення). Воно отримує статус лише після того, як Iugu повідомить про рахунок — сповіщенням або під час повернення покупця; рахунок завжди зчитується з Iugu. Кожне поле нижче перелічує ваші статуси замовлень OpenCart.

Order Status After Payment: встановлюється після перевіреної оплати Iugu. За замовчуванням: Обробляється.

Awaiting Iugu Payment Status: покупець повернувся зі сторінки Iugu з виставленим boleto або PIX; Iugu підтвердить надходження коштів пізніше. За замовчуванням: Очікує оплати.

Iugu Payment On Hold Status: оплату карткою авторизовано, але не списано; оплата на перевірці; оплачено частково; оскарження платежу (chargeback); сума або валюта відрізняються від замовлення; або оплату отримано після скасування замовлення. Примітка пояснює причину; перевірте її вручну. За замовчуванням: Очікує оплати, оскільки в OpenCart немає статусу «On hold». Ви можете створити власний статус у System > Localisation > Order Statuses і вибрати його тут.

Invoice Expired Status: рахунок замовлення в очікуванні прострочено без оплати. Якщо Iugu пізніше повідомить, що рахунок оплачено, замовлення отримає статус після оплати. За замовчуванням: Невдалий.

Invoice Canceled Status: рахунок замовлення в очікуванні скасовано в Iugu. За замовчуванням: Скасовано.

Refunded Status: встановлюється після повного повернення оплати зі сторінки замовлення або з панелі Iugu. За замовчуванням: Повернено.

Додатково

Debug log: записує запити до API та сповіщення у файл wc_igu_debug.log.php у папці логів OpenCart (storage/logs). Файл не можна відкрити через веб. Токени та дані клієнта (e-mail, телефон, CPF) ніколи не записуються в лог. Помилки та попередження записуються завжди, навіть коли перемикач вимкнено. За замовчуванням: вимкнено.

Log: показує розмір і останні записи логу. Натисніть Clear log, щоб його очистити.

Delete data on uninstall: якщо увімкнено, при видаленні розширення видаляються налаштування шлюзу та лог. Замовлення, посилання на рахунки Iugu та повернення завжди зберігаються, тож старі замовлення працюють після повторного встановлення. За замовчуванням: вимкнено.

Імпорт / експорт

Export: Download JSON зберігає налаштування у файл JSON. API-токени не експортуються.

Import: вставте раніше експортований JSON і натисніть Import, щоб відновити налаштування. Збережені API-токени зберігаються.

Оформлення замовлення

На кроці Payment Method покупець обирає спосіб оплати (за замовчуванням Iugu). На кроці Confirm Order покупець бачить ваш опис і примітку You will be redirected to the Iugu invoice page to pay by credit card, boleto or PIX. OpenCart створює замовлення на цьому кроці, ще без статусу. Коли покупець натискає Confirm Order, розширення створює рахунок Iugu на суму замовлення в BRL зі строком сплати 3 дні та надсилає покупця на сторінку рахунку Iugu. Потрібна дійсна адреса e-mail. Рахунок показує Order # і номер замовлення. Там покупець платить кредитною карткою, boleto або PIX — способами, увімкненими у вашому обліковому записі Iugu. Ім'я та e-mail покупця передаються в Iugu, а також CPF/CNPJ з користувацького поля з назвою CPF або CNPJ, якщо воно містить 11 або 14 цифр. Телефон і адреса надсилаються лише у форматі, який приймає Iugu (бразильські телефони, бразильські адреси з CEP із 8 цифр; номер будинку передається як s/n).

На OpenCart 4 покупець обирає спосіб оплати кнопкою Choose у блоці способу оплати, у вікні Payment method options, і натискає Confirm Order внизу сторінки оформлення. За замовчуванням OpenCart 4 не запитує платіжну адресу; тоді розширення бере адресу та користувацьке поле CPF/CNPJ з адреси доставки.

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише після підтвердження Iugu: рахунок зчитується через API Iugu, коли покупець повертається, і коли Iugu надсилає сповіщення. Тоді замовлення отримує статус стандартним для OpenCart способом, зі звичайними листами про замовлення та оновленням складських залишків, а покупець бачить сторінку успішного оформлення замовлення OpenCart.

Якщо покупець згенерував код boleto або PIX і повернувся до оплати, замовлення отримує Awaiting Iugu Payment Status, а сторінка успіху показує Your Iugu invoice is awaiting payment (boleto / PIX). The order will be confirmed as soon as Iugu reports the payment. Замовлення переходить у статус оплаченого, коли Iugu повідомляє про надходження коштів — сповіщенням або коли покупець знову відкриває посилання повернення. Для замовлення на утриманні сторінка успіху показує We are confirming your payment with Iugu. The order will be updated automatically — please do not pay again. Якщо Iugu був недоступний або ще не повідомив про оплату, коли покупець повернувся, відкривається сторінка Payment confirmation з тим самим текстом і кнопками Check again та Back to checkout.

Якщо рахунок було скасовано або він прострочений, покупець повертається до оформлення з повідомленням The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay. Якщо замовлення було скасовано, бо його рахунок Iugu скасовано, повідомлення таке: Your order was cancelled because its Iugu invoice was canceled. Якщо кошик уже порожній (замовлення з boleto або PIX встигло дійти до сторінки успіху до того, як рахунок прострочився), покупець бачить натомість сторінку Payment confirmation з текстом The Iugu invoice of order #... was not paid (it was canceled or has expired), so the order will not be shipped. To buy these items, please place a new order. (або повідомлення про скасування) і кнопку Continue. На OpenCart 4 ці повідомлення показуються над сторінкою оформлення. OpenCart 3 створює нове замовлення щоразу, коли показується крок Confirm Order; OpenCart 4 оновлює замовлення оформлення, тож після прострочення або скасування рахунку покупець оплачує те саме замовлення новим рахунком. Кошик оплачується лише один раз. Перед створенням нового рахунку розширення перевіряє попередні рахунки кошика: якщо один із них оплачено, ця оплата застосовується, і покупець переходить на сторінку успіху; якщо у того ж замовлення ще є відкритий рахунок з тією самою сумою і режимом, покупця повертають до нього; інші відкриті рахунки скасовуються в Iugu. Якщо старий рахунок все одно оплачено, платіж усе одно зіставляється, а повторна оплата вже оплаченого кошика позначається приміткою. Зміна кошика, зокрема нова кількість, вважається новим кошиком, який потребує власної оплати.

На OpenCart 4 замовлення зберігається в оформленні, доки не буде показано сторінку успіху. Якщо замовлення тим часом закрили (наприклад, строк boleto минув або ви його скасували), покупця повертають до оформлення з повідомленням The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay., або, якщо його було оплачено до закриття, з повідомленням This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. Якщо замовлення вже розміщено, а в кошику тепер нова покупка, Confirm Order перезавантажує сторінку оформлення. В обох випадках наступне натискання Confirm Order оплачує нове замовлення з кошика.

Якщо Iugu не може створити рахунок, покупець залишається на кроці Confirm Order з коротким повідомленням, наприклад Iugu could not create the invoice: з причиною та проханням перевірити платіжні дані, або Could not connect to Iugu. Please try again in a moment. Технічна причина записується в лог.

URL сповіщень також працює, коли магазин у режимі обслуговування: OpenCart 3 пропускає запити платіжних розширень, а на OpenCart 4 розширення додає стартову дію, яка пропускає сповіщення та повернення покупця.

Розширення приймає лише разові платежі. Воно не має форми картки на сайті, збережених карток, підписок чи регулярних списань, carnê (платіжних книжок), розділених платежів і налаштувань розстрочки — для розстрочки використовуйте налаштування сторінки Iugu. Способи оплати, які пропонуються на сторінці Iugu, не можна вибрати в налаштуваннях розширення: пропонуються всі способи, увімкнені у вашому обліковому записі Iugu.

Замовлення та повернення коштів

Статуси замовлень

Без статусу (відсутнє замовлення): покупця надіслано до Iugu, він не оплатив, рахунок прострочено або скасовано, або Iugu ще не підтвердив оплату. У Sales > Orders такі замовлення показуються лише з фільтром Order Status, встановленим на Missing Orders.

Order Status After Payment (за замовчуванням Обробляється): Iugu підтвердив оплату. Примітка показує ID рахунку та спосіб оплати (кредитна картка, boleto або PIX).

Awaiting Iugu Payment Status (за замовчуванням Очікує оплати): покупець повернувся з виставленим boleto або PIX. Замовлення переходить у статус оплаченого, коли Iugu повідомляє про оплату.

Iugu Payment On Hold Status (за замовчуванням Очікує оплати): оплату карткою авторизовано, але ще не списано (списати її в Iugu, і замовлення буде завершено, коли Iugu повідомить, що рахунок оплачено), оплата на перевірці, рахунок оплачено лише частково, відкрито chargeback, Iugu повідомив суму або валюту, що відрізняються від замовлення, або оплата надійшла після скасування замовлення. Примітки пояснюють це. Перевірте замовлення та виконайте його або поверніть оплату.

Invoice Expired Status (за замовчуванням Невдалий): рахунок замовлення в очікуванні прострочено без оплати. Якщо Iugu пізніше повідомить, що рахунок оплачено, замовлення переходить у статус оплаченого.

Invoice Canceled Status (за замовчуванням Скасовано): рахунок замовлення в очікуванні скасовано в Iugu.

Refunded Status (за замовчуванням Повернено): оплату повністю повернуто через розширення або в панелі Iugu.

Якщо інший рахунок того самого замовлення або кошика також оплачено, замовлення не змінюється. Примітка просить повернути дубльований платіж у Iugu. Примітки — це записи в History замовлення, які покупець не бачить. Коли замовлення в очікуванні пізніше оплачується, прострочується або скасовується, OpenCart повідомляє покупця про новий статус.

Вкладка VibeFox Iugu Gateway

У Sales > Orders відкрийте замовлення, оплачене через Iugu. Унизу сторінки замовлення, поруч із History та Additional, вкладка VibeFox Iugu Gateway показує ID Iugu invoice (із посиланням на рахунок в Iugu) з позначкою Test mode для тестових рахунків, Payment method, Status, суми Paid / refunded, форму повернення коштів, історію повернень і Iugu notes замовлення. Вкладка показується користувачам, які мають доступ до розширення.

Повернення коштів

На вкладці VibeFox Iugu Gateway введіть Amount (підставляється сума, яка ще не повернена), за бажання Reason (optional), і натисніть Refund via Iugu. Підтвердьте запитання Refund this amount through Iugu? This cannot be undone. Вам потрібне право змінювати розширення (задається в System > Users > User Groups). Повернення надсилається з токеном того режиму, у якому створено рахунок, тож цей токен має бути налаштований.

Кредитна картка: повні або часткові повернення.

PIX: лише повні повернення.

Boleto: не повертається через Iugu. Поверніть гроші покупцю банківським переказом, а потім зафіксуйте повернення вручну.

Повернення розраховуються від суми, яку Iugu фактично отримав за рахунком, тож після розбіжності суми можна повернути до того, що заплатив покупець, а не суму замовлення. Повертати можна лише оплачені рахунки і не більше за суму, яка ще доступна до повернення в Iugu. Повернення вважається виконаним лише після підтвердження Iugu. Якщо Iugu відхиляє повернення або не підтверджує його, вкладка показує помилку, і повернення не фіксується. Успішне повернення додається до історії повернень і приміток разом з ID рахунку та причиною. Повне повернення переводить замовлення в Refunded Status без сповіщення покупця і без повернення товарів на склад, як і ручна зміна статусу. Часткове повернення статус не змінює. Повернення доступні, коли Iugu повідомив, що рахунок оплачено.

Повернення товарів у Sales > Returns гроші через Iugu не повертають.

Повне повернення, зроблене в панелі Iugu, переводить замовлення в Refunded Status з приміткою. Часткові повернення, зроблені в панелі, не імпортуються.

Ліцензійний ключ

Розширення працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox Iugu Gateway — перший блок на сторінці Extensions > Extensions > Payments > VibeFox Iugu Gateway > Edit, над налаштуваннями. Вставте ключ у License key і натисніть Activate. Після цього блок показує ключ замаскованим, статус (наприклад, дату, до якої ліцензія активна, і ваш домен) та кнопки Check now — перевірити статус ще раз, Change key — ввести інший ключ, і Remove key — видалити ключ із цього магазину. Нижче розташовані рядок Product: opencart-payment-iugu та посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис на vibefox.net. Змінювати ключ можуть лише адміністратори з правом Modify для розширення. Тексти блоку відповідають мові адмінпанелі (включені англійська та російська).

Якщо ключ не прийнято, блок повідомляє причину, наприклад Key not found, This key belongs to another product, Domain limit reached або License expired on з датою. Після зміни адреси магазину або після звільнення місця для домену у вашому обліковому записі натисніть Check now. Якщо сервер ліцензій недоступний, розширення продовжує працювати за останнім відомим статусом.

Один ключ працює на одному домені: адреса магазину з налаштувань OpenCart. Видалення ключа з магазину не звільняє місце для домену. Звільніть місце у вашому обліковому записі на vibefox.net.

Без активного ключа Iugu не показується покупцям на оформленні. Якщо оплата все ж розпочата, покупець бачить This payment method is not available. Please choose another one. Адміністратор, який увійшов в адмінпанель у тому самому браузері, усе ще бачить спосіб оплати в магазині, позначений як (unlicensed — visible to admins only), щоб ви могли налаштувати та протестувати розширення до купівлі ключа. На OpenCart 4 цього попереднього перегляду немає: магазин не бачить вхід адміністратора, тож без активного ключа спосіб оплати приховано для всіх. Після того як ви один раз відкриєте сторінку Edit, на Dashboard адмінпанелі з'являється нагадування. Закрийте його кнопкою ×, щоб приховати на 7 днів. Наявні замовлення не зачіпаються: вже розпочаті оплати й далі підтверджуються, а повернення працюють.

Коли ліцензія закінчується, розширення продовжує працювати, але оновлення та підтримка потребують продовження. Статус автоматично перевіряється знову, коли ви відкриваєте Dashboard або сторінку Edit адмінпанелі: раз на день протягом перших 14 днів після введення ключа, потім раз на тиждень. Cron-завдання не потрібне. Видалення розширення завжди видаляє ліцензійний ключ і статус ліцензії.

Усунення несправностей

Iugu не з'являється на оформленні: перевірте, що ліцензія активна, Enable / Disable увімкнено і встановлено токен активного режиму: Test API token у тестовому режимі, Live API token у робочому. Валюта оформлення покупця має бути BRL, а сума — щонайменше R$ 1,00. Також перевірте, що адреса оплати входить до вибраної Geo Zone і що замовлення досягає Total, заданого в налаштуваннях. На сторінці налаштувань з'являється попередження, якщо токен або валюта задані неправильно.

Оплата пройшла, але замовлення залишається без статусу: сповіщення від Iugu не дійшло до магазину або його не вдалося перевірити. Увімкніть Debug log і подивіться поле Log на сторінці розширення. Перевірте, що магазин доступний з інтернету за Notification URL і що токен того режиму, в якому створено рахунок, усе ще введено. Рахунок також перевіряється, коли покупець повертається до магазину після оплати.

Сповіщення відповідає verification failed: рахунок у цей момент не вдалося зчитати через API Iugu, наприклад через мережеву помилку, неправильний токен або відсутній токен режиму рахунку. Iugu повторить сповіщення.

Сповіщення відповідає busy: кошик у той самий момент оброблявся іншим запитом, або не вдалося встановити статус замовлення. Iugu повторить сповіщення. Лог показує причину.

Сповіщення відповідає invalid invoice id: у сповіщенні не було дійсного ID рахунку. Нічого не змінюється.

Замовлення в Iugu Payment On Hold Status: прочитайте Iugu notes на вкладці замовлення. Оплата карткою очікує списання, оплата на перевірці, оплачено частково або оскаржено, оплачена сума не збіглася із замовленням, або оплата надійшла після скасування замовлення.

Покупець бачить «Iugu payments are not available right now»: API-токен відсутній або неправильний. Перевірте токен активного режиму.

Покупець бачить «A valid billing email is required for Iugu»: у замовленні немає дійсної адреси e-mail.

Покупець бачить «This order already has an Iugu payment that the store has to review»: один із попередніх рахунків замовлення авторизований, на перевірці або оплачений частково. Перевірте рахунок в Iugu і лог.

Покупець бачить This payment method is not available.: сеанс оформлення більше не відповідає замовленню, або спосіб оплати тим часом вимкнули. Покупець перезавантажує оформлення.

Повернення не виконується: прочитайте повідомлення на вкладці. Платежі boleto через Iugu не повертаються, платежі PIX повертаються лише повністю, і повертати можна лише оплачені рахунки. Якщо повідомлення каже, що оплату зроблено в тестовому або робочому режимі, а токен для цього режиму не задано, введіть токен цього режиму. Якщо Iugu не підтвердив повернення, перевірте рахунок в Iugu, перш ніж повторювати спробу.

Для розробників: до створення рахунку розширення викликає подію OpenCart wc_igu_invoice_data із запитом на рахунок і замовленням, наприклад щоб обмежити способи оплати через payable_with.

Видалення

Перейдіть до Extensions > Extensions, виберіть тип Payments і натисніть Uninstall (червона кнопка −) поруч із VibeFox Iugu Gateway. Ліцензійний ключ і статус ліцензії цього розширення завжди видаляються. OpenCart завжди видаляє власні налаштування розширення: Enable / Disable, Sort Order, Geo Zone, Total і статуси замовлень із розділу Orders, які при повторному встановленні повертаються до значень за замовчуванням. Подія OpenCart розширення також видаляється (на OpenCart 4 також її події та стартова дія, яка пропускає сповіщення та повернення покупця в режимі обслуговування). Якщо Delete data on uninstall увімкнено, видаляються інші налаштування шлюзу (назва, опис, тестовий режим, API-токени, перемикач логу налагодження) і лог. Якщо вимкнено, вони зберігаються для майбутнього повторного встановлення. Посилання на рахунки Iugu і повернення завжди зберігаються, тож замовлення, оплачені раніше, можна повернути, а пізні сповіщення й далі зіставляються після повторного встановлення. Наявні замовлення зберігають свої примітки про оплату.

На OpenCart 4, щоб видалити також файли розширення, перейдіть до Extensions > Installer після видалення і натисніть Uninstall (помаранчева кнопка −) поруч із VibeFox Iugu Gateway у списку встановлених розширень, а потім Delete (червона кнопка з кошиком), щоб видалити завантажений пакет.

Iugu — торгова марка її власника. Це розширення не пов'язане з Iugu і не схвалене компанією Iugu.