From f70d167190e2fe048bbbec27293a827798b1d0d7 Mon Sep 17 00:00:00 2001 From: O K Date: Tue, 17 Jun 2025 15:51:43 +0300 Subject: [PATCH] update readme --- install.xml | 1 - readme.md | 93 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 93 insertions(+), 1 deletion(-) create mode 100644 readme.md diff --git a/install.xml b/install.xml index 7cbd518..5b1a4f6 100644 --- a/install.xml +++ b/install.xml @@ -4,7 +4,6 @@ 1.0.0 Panariga/Hutko https://hutko.org - https://www.yourhutkosite.com Extensions > Payments.]]> \ No newline at end of file diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..489fa9d --- /dev/null +++ b/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. У статусах платежів зберігається посилання на оплату, яке ви легко можете повторно направити клієнту. +