193 lines
11 KiB
Markdown
193 lines
11 KiB
Markdown
# Платіжний модуль Hutko для PrestaShop
|
||
|
||
**Hutko** — це сучасний платіжний сервіс, який допомагає бізнесу розвиватися на всіх етапах: запуск, масштабування, зростання. Надійно. Швидко. Зручно.
|
||
|
||
Цей модуль інтегрує платіжний шлюз Hutko у ваш інтернет-магазин на PrestaShop, надаючи покупцям можливість безпечно та комфортно оплачувати замовлення онлайн.
|
||
|
||
---
|
||
|
||
## Зміст
|
||
|
||
1. [Можливості](#можливості)
|
||
2. [Встановлення](#встановлення)
|
||
3. [Налаштування](#налаштування)
|
||
4. [Використання](#використання)
|
||
5. [Підтримка](#підтримка)
|
||
|
||
---
|
||
|
||
## Можливості
|
||
|
||
- Повна інтеграція з платіжною платформою Hutko для PrestaShop 1.7.7 – 8.2 (та 9.0-бета).
|
||
- Підтримка збереження платіжного посилання — зручно для повторної оплати.
|
||
- Повернення коштів (повне або часткове) безпосередньо зі сторінки замовлення.
|
||
- Синхронізація статусів платежів: Схвалено, Відхилено, Минув термін, Обробляється.
|
||
- Автоматичне оновлення статусу замовлень у PrestaShop.
|
||
- Можливість включення доставки у загальну суму платежу.
|
||
- Журнал запитів до Hutko API — для діагностики та підвищеної безпеки.
|
||
|
||
---
|
||
|
||
## Встановлення
|
||
|
||
Перед встановленням переконайтесь, що на сервері активовано PHP-розширення **cURL**.
|
||
|
||
1. **Завантаження модуля**
|
||
- Отримайте актуальну версію з офіційного репозиторію модуля.
|
||
|
||
2. **Інсталяція в PrestaShop**
|
||
- Увійдіть в адмін-панель.
|
||
- Перейдіть у `Модулі > Менеджер модулів`.
|
||
- Натисніть кнопку `Завантажити модуль`.
|
||
- Завантажте `.zip` файл модуля.
|
||
|
||
3. **Встановлення**
|
||
- Після завантаження PrestaShop автоматично розпізнає модуль.
|
||
- Дотримуйтесь інструкцій на екрані для завершення інсталяції.
|
||
|
||
---
|
||
|
||
## Налаштування
|
||
|
||
Після встановлення перейдіть до налаштувань модуля та внесіть реквізити свого облікового запису Hutko.
|
||
|
||
1. **Відкрити параметри модуля**
|
||
- Панель адміністратора → `Модулі > Менеджер модулів`.
|
||
- Знайдіть "Hutko" та натисніть `Налаштувати`.
|
||
|
||
2. **Введіть облікові дані**
|
||
- `Ідентифікатор продавця (Merchant ID)` — унікальний код від Hutko (**обов’язкове** поле).
|
||
- `Секретний ключ` — необхідний для захисту підпису операцій (**обов’язкове** поле).
|
||
- Виберіть статуси замовлення:
|
||
- для успішної оплати
|
||
- для очікування оплати
|
||
- Опціонально: ввімкніть/вимкніть показ логотипів платіжних карток.
|
||
|
||
3. **Збережіть налаштування**
|
||
- Натисніть кнопку `Зберегти`.
|
||
|
||
> ⚠️ Без коректних облікових даних сервісу Hutko модуль не працюватиме.
|
||
|
||
---
|
||
|
||
## Використання
|
||
|
||
Після налаштування модуль автоматично додає Hutko як спосіб оплати на сторінці оформлення замовлення.
|
||
|
||
1. Клієнт обирає "Оплатити через Hutko".
|
||
2. Відбувається переадресація на платіжну сторінку Hutko.
|
||
3. Після успішної оплати — автоматичне повернення до PrestaShop і оновлення статусу замовлення.
|
||
4. У разі помилки — клієнта буде перенаправлено з повідомленням про помилку.
|
||
5. Модуль автоматично отримує від серверу Hutko інформацію про оновлення стану платежу. При зміні статусу на "помилка" (declined) або "час вичерпано" (expired) - модуль присвоїть замовленню системний статус "Помилка платежу".
|
||
6. Якщо в налаштуваннях Prestashop встановлено рівень безпеки для Cookie SameSite "strict", то, при поверненні на сайт зі сторінки платежів Hutko, клієнт буде деавторизований. Це обмеження системи Prestashop. Модуль має спеціальну сторінку переадресації, яка дозволяє навіть при такому сценарї відобразити клієнту сторінку з підтвердженням замовлення. Для уникнення незручностей клієнтів рекомендуємо встановити обмеження Cookie SameSite у "none" (на вкладці Розширені параметри -> Адімністрування).
|
||
7. Якщо статус замовлення в Prestashop має відмітку "вважати оплаченим", то при присвоєнні такого статусу, Prestashop автоматично створить в блоці Платежі новий платіж на суму недоплати. Це може створити непорозуміння щодо сум фактичних оплат. Для цього рекомендуємо обирати в налаштуваннях модулю статуси, в яких відключене налаштування "вважати оплаченим".
|
||
|
||
---
|
||
|
||
## Підтримка
|
||
|
||
Якщо у вас виникли запитання або труднощі:
|
||
|
||
- Звертайтеся до [документації Hutko API](https://hutko.org/uk/).
|
||
- Ставте питання на [форумі PrestaShop](https://www.prestashop.com/forums/).
|
||
|
||
---
|
||
|
||
© Hutko, 2025. Усі права захищено.
|
||
|
||
# Hutko Payment Module for PrestaShop
|
||
|
||
**Hutko** is a modern payment service that helps businesses grow at all stages: launch, scale, growth. Reliable. Fast. Convenient.
|
||
|
||
This module integrates the Hutko payment gateway into your online store on PrestaShop, giving customers the opportunity to pay for orders safely and comfortably online.
|
||
|
||
---
|
||
|
||
## Table of Contents
|
||
|
||
1. [Features](#Features)
|
||
2. [Installation](#installation)
|
||
3. [Configuration](#configuration)
|
||
4. [Usage](#usage)
|
||
5. [Support](#support)
|
||
|
||
---
|
||
|
||
## Features
|
||
|
||
- Full integration with the Hutko payment platform for PrestaShop 1.7.7 – 8.2 (and 9.0-beta).
|
||
- Support for saving the payment link — convenient for repeated payments.
|
||
- Refund (full or partial) directly from the order page.
|
||
- Synchronization of payment statuses: Approved, Rejected, Expired, Processing.
|
||
- Automatic update of order statuses in PrestaShop.
|
||
- Ability to include shipping in the total payment amount.
|
||
- Hutko API request log — for diagnostics and increased security.
|
||
|
||
---
|
||
|
||
## Installation
|
||
|
||
Before installation, make sure that the PHP extension **cURL** is activated on the server.
|
||
|
||
1. **Downloading the module**
|
||
- Get the current version from the official module repository.
|
||
|
||
2. **Installing in PrestaShop**
|
||
- Log in to the admin panel.
|
||
- Go to `Modules > Module Manager`.
|
||
- Click the `Download module` button.
|
||
- Download the `.zip` module file.
|
||
|
||
3. **Installation**
|
||
- After downloading, PrestaShop will automatically recognize the module.
|
||
- Follow the on-screen instructions to complete the installation.
|
||
|
||
---
|
||
|
||
## Settings
|
||
|
||
After installation, go to the module settings and enter your Hutko account details.
|
||
|
||
1. **Open module settings**
|
||
- Admin panel → `Modules > Module manager`.
|
||
- Find "Hutko" and click `Configure`.
|
||
|
||
2. **Enter credentials**
|
||
- `Merchant ID` — a unique code from Hutko (**required** field).
|
||
- `Secret key` — required to protect the signature of transactions (**required** field).
|
||
- Select order statuses:
|
||
- for successful payment
|
||
- for payment pending
|
||
- Optional: enable/disable the display of payment card logos.
|
||
|
||
3. **Save settings**
|
||
- Click the `Save` button.
|
||
|
||
> ⚠️ Without correct Hutko service credentials, the module will not work.
|
||
|
||
---
|
||
|
||
## Usage
|
||
|
||
After configuration, the module automatically adds Hutko as a payment method on the checkout page.
|
||
|
||
1. The customer selects "Pay via Hutko".
|
||
2. Redirects to the Hutko payment page.
|
||
3. After successful payment, automatic return to PrestaShop and update of the order status.
|
||
4. In case of an error, the customer will be redirected with an error message.
|
||
5. The module automatically receives information about the payment status update from the Hutko server. If the status changes to "declined" or "expired", the module will assign the order the system status "Payment error".
|
||
6. If the security level for Cookie SameSite is set to "strict" in the Prestashop settings, then when returning to the site from the Hutko payment page, the customer will be deauthorized. This is a limitation of the Prestashop system. The module has a special redirect page, which allows even in such a scenario to display the order confirmation page to the client. To avoid customer inconvenience, we recommend setting the SameSite Cookie restriction to "none" (on the Advanced Settings -> Administration tab).
|
||
7. If the order status in Prestashop is marked "consider paid", then when assigning such a status, Prestashop will automatically create a new payment in the Payments block for the amount of the underpayment. This may create a misunderstanding regarding the amounts of actual payments. To do this, we recommend choosing statuses in the module settings in which the "consider paid" setting is disabled.
|
||
|
||
---
|
||
|
||
## Support
|
||
|
||
If you have any questions or difficulties:
|
||
|
||
- Contact the [Hutko API documentation](https://hutko.org/uk/).
|
||
- Ask a question on the [PrestaShop forum](https://www.prestashop.com/forums/).
|
||
|
||
---
|
||
|
||
© Hutko, 2025. All rights reserved. |