Hutko — це сучасний платіжний сервіс, який допомагає бізнесу розвиватися на всіх етапах: запуск, масштабування, зростання. Надійно. Швидко. Зручно.

Цей модуль інтегрує платіжний шлюз Hutko у ваш інтернет-магазин на PrestaShop, надаючи покупцям можливість безпечно та комфортно оплачувати замовлення онлайн.

Можливості

Повна інтеграція з платіжною платформою Hutko для PrestaShop 1.7.7 – 8.2 (та 9.0-бета).
Підтримка збереження платіжного посилання — зручно для повторної оплати.
Повернення коштів (повне або часткове) безпосередньо зі сторінки замовлення.
Синхронізація статусів платежів: Схвалено, Відхилено, Минув термін, Обробляється.
Автоматичне оновлення статусу замовлень у PrestaShop.
Можливість включення доставки у загальну суму платежу.
Журнал запитів до Hutko API — для діагностики та підвищеної безпеки.

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

Перед встановленням переконайтесь, що на сервері активовано PHP-розширення cURL.

Завантаження модуля
- Отримайте актуальну версію з офіційного репозиторію модуля.
Інсталяція в PrestaShop
- Увійдіть в адмін-панель.
- Перейдіть у Модулі > Менеджер модулів.
- Натисніть кнопку Завантажити модуль.
- Завантажте .zip файл модуля.
Встановлення
- Після завантаження PrestaShop автоматично розпізнає модуль.
- Дотримуйтесь інструкцій на екрані для завершення інсталяції.

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

Після встановлення перейдіть до налаштувань модуля та внесіть реквізити свого облікового запису Hutko.

Відкрити параметри модуля
- Панель адміністратора → Модулі > Менеджер модулів.
- Знайдіть "Hutko" та натисніть Налаштувати.
Введіть облікові дані
- Ідентифікатор продавця (Merchant ID) — унікальний код від Hutko (обов’язкове поле).
- Секретний ключ — необхідний для захисту підпису операцій (обов’язкове поле).
- Виберіть статуси замовлення:
  - для успішної оплати
  - для очікування оплати
- Опціонально: ввімкніть/вимкніть показ логотипів платіжних карток.
Збережіть налаштування
- Натисніть кнопку Зберегти.

⚠️ Без коректних облікових даних сервісу Hutko модуль не працюватиме.

Використання

Після налаштування модуль автоматично додає Hutko як спосіб оплати на сторінці оформлення замовлення.

Клієнт обирає "Оплатити через Hutko".
Відбувається переадресація на платіжну сторінку Hutko.
Після успішної оплати — автоматичне повернення до PrestaShop і оновлення статусу замовлення.
У разі помилки — клієнта буде перенаправлено з повідомленням про помилку.
Модуль автоматично отримує від серверу Hutko інформацію про оновлення стану платежу. При зміні статусу на "помилка" (declined) або "час вичерпано" (expired) - модуль присвоїть замовленню системний статус "Помилка платежу".
Якщо в налаштуваннях Prestashop встановлено рівень безпеки для Cookie SameSite "strict", то, при поверненні на сайт зі сторінки платежів Hutko, клієнт буде деавторизований. Це обмеження системи Prestashop. Модуль має спеціальну сторінку переадресації, яка дозволяє навіть при такому сценарї відобразити клієнту сторінку з підтвердженням замовлення. Для уникнення незручностей клієнтів рекомендуємо встановити обмеження Cookie SameSite у "none" (на вкладці Розширені параметри -> Адімністрування).
Якщо статус замовлення в Prestashop має відмітку "вважати оплаченим", то при присвоєнні такого статусу, Prestashop автоматично створить в блоці Платежі новий платіж на суму недоплати. Це може створити непорозуміння щодо сум фактичних оплат. Для цього рекомендуємо обирати в налаштуваннях модулю статуси, в яких відключене налаштування "вважати оплаченим".

Підтримка

Якщо у вас виникли запитання або труднощі:

Звертайтеся до документації Hutko API.
Ставте питання на форумі PrestaShop.

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.

Features
Installation
Configuration
Usage
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.

Downloading the module

Get the current version from the official module repository.

Installing in PrestaShop

Log in to the admin panel.
Go to Modules > Module Manager.
Click the Download module button.
Download the .zip module file.

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.

Open module settings

Admin panel → Modules > Module manager.
Find "Hutko" and click Configure.

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.

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.

The customer selects "Pay via Hutko".
Redirects to the Hutko payment page.
After successful payment, automatic return to PrestaShop and update of the order status.
In case of an error, the customer will be redirected with an error message.
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".
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).
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.
Ask a question on the PrestaShop forum.

Releases 2

v1.3.2 Latest

2025-06-24 12:50:25 +03:00

Languages

PHP 84.2%

Smarty 15.8%

readme.md Unescape Escape

Платіжний модуль Hutko для PrestaShop