OpenCart IBAN (Opendatabot)

Розширення оплати для OpenCart: створює рахунок IBAN через Opendatabot і перенаправляє клієнта на сторінку оплати.

Підтримувані версії:

• OpenCart 4.x (PHP 8.1+)
• OpenCart 3.x (PHP 7.4+)

---

Встановлення на існуючий магазин

Нижче — покрокова інструкція, як встановити розширення в уже працюючий магазин OpenCart.

Що потрібно перед встановленням

1. Архів розширення — файл opencart_iban.ocmod.zip (для OpenCart 4) або opencart_iban_oc3.ocmod.zip (для OpenCart 3). Якщо у вас вихідний код з репозиторію, архів можна зібрати скриптом (див. розділ «Збірка архіву» в кінці).
2. Ключі API Opendatabot — ключ клієнта (x-client-key) та ім’я клієнта (x-client-name). Їх можна отримати на iban.opendatabot.ua.
3. IBAN та код компанії — ваш український IBAN та ІПН/ЄДРПОУ (8 або 10 цифр).

---

Встановлення в OpenCart 4.x

1. Увійдіть в адмін-панель магазину.
2. Відкрийте Розширення → Встановлювач (Extensions → Installer).
3. Натисніть Завантажити і виберіть файл opencart_iban.ocmod.zip.
4. Після успішної установки відкрийте Розширення → Розширення (Extensions → Extensions).
5. У полі Тип оберіть Оплата (Payments).
6. Знайдіть у списку Opendatabot IBAN Invoice і натисніть Встановити (Install).
7. Натисніть Редагувати (Edit) і заповніть налаштування (див. розділ «Налаштування» нижче).
8. Збережіть форму. За потреби: Система → Налаштування → вкладка Сервер → Оновлення теми та кешу (або Developer Settings → Refresh).

Після цього спосіб оплати «Рахунок IBAN (Opendatabot)» з’явиться в оформленні замовлення (за умови, що валюта кошика — UAH).

---

Встановлення в OpenCart 3.x

1. Увійдіть в адмін-панель магазину.
2. Відкрийте Розширення → Встановлювач (Extensions → Installer).
3. Завантажте файл opencart_iban_oc3.ocmod.zip.
4. Відкрийте Розширення → Модифікації (Extensions → Modifications) і натисніть Оновити (Refresh).
5. Відкрийте Розширення → Розширення, тип — Оплата (Payments).
6. Знайдіть Opendatabot IBAN Invoice → Встановити (Install).
7. Натисніть Редагувати (Edit) і заповніть налаштування (див. нижче).
8. Збережіть. За потреби очистіть кеш теми в адмінці.

Після цього спосіб оплати з’явиться на етапі оплати в чекауті (якщо валюта — UAH).

---

Налаштування розширення

У Розширення → Оплата → Opendatabot IBAN Invoice → Редагувати заповніть:

Поле	Опис
IBAN	Український IBAN (формат UA + 27 цифр, без пробілів). Обов’язково.
РНОКПП / ЄДРПОУ (Code)	ІПН або код компанії — 8 або 10 цифр. Обов’язково.
x-client-key	Ключ клієнта API Opendatabot (отримати на iban.opendatabot.ua). Обов’язково.
x-client-name	Ім’я клієнта API (наприклад, public або назва застосунку). Обов’язково.
Призначення платежу (Payment purpose)	Текст для рахунку. Можна використати плейсхолдер {order_id} — підставиться номер замовлення. Якщо не заповнити, номер замовлення додасться автоматично.
Статус замовлення (Order Status)	Статус, який встановлюється після перенаправлення клієнта на оплату (рекомендовано: «Очікування» / Pending).
Статус (Status)	Увімкнено — щоб спосіб оплати показувався в чекауті.
Порядок сортування (Sort Order)	Порядок відображення серед інших способів оплати.

Після зміни налаштувань натисніть Зберегти.

---

Валюта UAH

Спосіб оплати показується лише тоді, коли валюта кошика — UAH.

Що перевірити в існуючому магазині:

1. Система → Локалізація → Валюти — валюта UAH має існувати і бути увімкненою.
2. Система → Налаштування → ваша торгівельна точка → вкладка Локальні — поле Валюта встановите на UAH (валюта за замовчуванням).
3. У магазині (на сайті) клієнт має оформляти замовлення в UAH (вибір валюти або валюта за замовчуванням). Якщо раніше була інша валюта, можна очистити cookies або відкрити сайт в режимі інкогніто.

Якщо валюта не UAH, на етапі оплати з’явиться повідомлення, що цей спосіб доступний лише для UAH, замість загального «Немає доступних способів оплати».

---

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

«Немає доступних способів оплати. Зв’яжіться з нами!»

Зазвичай означає, що жоден спосіб оплати не повернув варіанти. Можливі причини:

1. Валюта не UAH — переконайтеся, що валюта магазину та кошика клієнта — UAH (див. розділ «Валюта UAH» вище).
2. Розширення не встановлено або вимкнено — у Розширення → Оплата переконайтеся, що Opendatabot IBAN Invoice встановлено і в налаштуваннях Статус = Увімкнено.
3. Не заповнені обов’язкові поля — у налаштуваннях розширення мають бути заповнені: IBAN, РНОКПП/ЄДРПОУ, x-client-key, x-client-name. Якщо хоча б одне порожнє, спосіб оплати не пропонується; коли це єдиний спосіб, з’являється помилка «Немає доступних способів оплати».

Якщо розширення увімкнено, але умови не виконані (наприклад, не UAH або немає ключів), замість загальної помилки клієнт побачить назву способу оплати та пояснення (наприклад, «Цей спосіб доступний лише для UAH»).

У списку «Статус замовлення» нічого немає (українська адмінка)

Якщо в адмін-панелі обрано українську мову, а в списку статусів замовлення порожньо — у базі можливо немає назв статусів для української мови. Розширення підставляє статуси з іншої мови (наприклад, англійської), щоб список не був порожнім. Щоб у списку були саме українські назви, додайте переклади: Система → Локалізація → Статуси замовлень → для кожного статусу заповніть назву українською.

---

Обмеження (поточна версія)

• Оплата лише в UAH.
• Рахунок створюється на сервері (потрібні PHP-розширення curl та доступ в інтернет по HTTPS).

---

Збірка архіву з вихідного коду

Якщо у вас є репозиторій, а не готовий .ocmod.zip:

OpenCart 4.x:

./scripts/build-ocmod-zip-oc4.sh

Готовий файл: dist/opencart_iban.ocmod.zip.

OpenCart 3.x:

./scripts/build-ocmod-zip-oc3.sh

Готовий файл: dist/opencart_iban_oc3.ocmod.zip.

Далі встановлюйте архів так, як описано в розділах «Встановлення в OpenCart 4.x» / «Встановлення в OpenCart 3.x» вище.

---

Структура репозиторію (для розробників)

• src_oc4/ — вихідний код для OpenCart 4.x
• src_oc3/ — вихідний код для OpenCart 3.x (структура upload/)
• scripts/ — скрипти збірки
• dist/ — зібрані .ocmod.zip (в git не потрапляють)
• dev_oc4/ та dev_oc3/ — Docker-стенди для розробки

---

Посилання

• Довідник розробника OpenCart (розширення)
• Opendatabot: створення рахунку IBAN