update readme

readme.md

@@ -0,0 +1,93 @@
+# Платіжний модуль Hutko для OpenCart
+
+Hutko — це сучасний платіжний сервіс, який допомагає бізнесу розвиватися на всіх етапах: запуску, масштабуванні та розширенні. Надійний. Швидкий. Зручний.
+
+Цей модуль інтегрує платіжний шлюз Hutko у ваш інтернет-магазин OpenCart, надаючи клієнтам безпечний та зручний спосіб оплати замовлень онлайн.
+
+## Зміст
+1. [Функції](#функції)
+2. [Вимоги](#вимоги)
+3. [Встановлення](#встановлення)
+4. [Конфігурація](#конфігурація)
+5. [Використання](#використання)
+6. [Підтримка](#підтримка)
+
+## Функції
+* Інтеграція онлайн-платежів з платіжною платформою Hutko для **OpenCart 3.x**.
+* Підтримка збереження платіжних посилань — зручно для повторних спроб платежів.
+* Повернення коштів (повне або часткове) безпосередньо зі сторінки перегляду замовлення OpenCart.
+* Синхронізація статусів платежів.
+* Автоматичне оновлення статусів замовлень в OpenCart.
+* Можливість включення/виключення вартості доставки до загальної суми платежу.
+* Журнал запитів до API Hutko — для діагностики та підвищення безпеки.
+
+## Вимоги
+* **Версія OpenCart:** 3.0.0.0 або пізнішої версії
+* **Версія PHP:** 7.3 або пізнішої версії.
+* **Розширення PHP cURL:** Повинно бути ввімкнено на вашому сервері.
+
+## Встановлення
+
+**Перед встановленням переконайтеся, що розширення PHP cURL активне на вашому сервері.**
+
+1. **Завантажте модуль:**
+* Отримайте останню версію модуля з офіційного репозиторію модулів (шукайте на hutko.org).
+
+2. **Встановлення в OpenCart:**
+* Увійдіть до панелі адміністратора OpenCart.
+* Перейдіть до **Розширення > Інсталятор**.
+* Натисніть кнопку **Завантажити**.
+* Виберіть завантажений файл модуля `.ocmod.zip` та завантажте його.
+* Зачекайте завершення процесу завантаження та встановлення.
+* Далі перейдіть до **Розширення > Зміни**.
+* Натисніть синю кнопку **Оновити** (у верхньому правому куті), щоб застосувати будь-які зміни.
+* Потім перейдіть до **Розширення > Розширення**.
+* Виберіть **Платежі** з випадаючого фільтра «Виберіть тип розширення».
+* Знайдіть "Hutko".
+* Натисніть зелену кнопку **Встановити** (значок `+`) поруч.
+
+## Налаштування
+
+Після встановлення вам потрібно налаштувати модуль за допомогою облікових даних вашого облікового запису Hutko.
+
+1. **Налаштування модуля доступу:**
+* В адміністративній панелі OpenCart перейдіть до **Розширення > Розширення**.
+* Виберіть **Платежі** з випадаючого фільтра "Виберіть тип розширення".
+* Знайдіть Hutko у списку та натисніть синю кнопку **Редагувати** (значок олівця).
+
+2. **Введіть облікові дані облікового запису:**
+* **Ідентифікатор продавця:** Ваш унікальний ідентифікатор, наданий Hutko (обов'язкове поле).
+* **Секретний ключ:** Секретний ключ, необхідний для захисту підписів транзакцій (обов'язкове поле).
+
+3. **Статуси замовлень:**
+* Виберіть відповідні статуси замовлень OpenCart, які модуль має встановити для:
+* **Статус успішного платежу:** (наприклад, Обробка, Завершено)
+* **Статус нового замовлення:** (наприклад, Очікування)
+* **Статус невдалого платежу:** (наприклад, Не вдалося, Скасовано)
+* **Статус платежу, термін дії якого минув:** (наприклад, Минув, Скасовано)
+
+4. **Додаткові налаштування:**
+* Встановити **Геозону**, для якої доступний цей спосіб оплати.
+* Встановити **Загальну суму** – загальна сума замовлення має досягати цього значення, щоб спосіб оплати був доступним.
+* Встановити **Порядок сортування**, щоб контролювати його позицію серед інших способів оплати.
+* Увімкнути/вимкнути модуль можна за допомогою опції **Статус**.
+* Для сумісності фіскалізації можливо вимкнути передачу фіксованих знижок до серверів Hutko.
+
+5. **Зберегти налаштування**:
+
+* Натисніть кнопку **Зберегти** (угорі праворуч).
+
+⚠️ **Модуль не працюватиме належним чином без дійсних облікових даних сервісу Hutko.**
+
+## Використання
+
+Після налаштування модуль автоматично додасть Hutko як варіант оплати на сторінці оформлення замовлення.
+
+1. Клієнт вибирає «Сплатити через Hutko».
+2. Клієнта перенаправляє на захищену сторінку оплати Hutko.
+3. Після успішної оплати клієнт автоматично перенаправляється назад до вашого магазину OpenCart, і статус замовлення оновлюється відповідно.
+4. У разі помилки оплати або відхилення клієнта буде перенаправлено назад з відповідним повідомленням про помилку, а статус замовлення відображатиме помилку.
+5. Модуль автоматично отримує оновлення від сервера Hutko щодо статусу оплати. Якщо статус зміниться на «відхилено» або «термін дії минув», модуль призначить відповідний налаштований статус замовлення в OpenCart (наприклад, «Невдалий платіж» або «Помилка платежу»).
+6. Замовлення створюється до оплати. Таким чином ви не втрачаєте контакти клієнта та зможете швидше повернути його до процесу покупки.
+7. У статусах платежів зберігається посилання на оплату, яке ви легко можете повторно направити клієнту.
+