panariga/hutko
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases 2 Wiki Activity

fix translation

Browse Source
This commit is contained in:
O K
2025-06-08 15:40:24 +03:00
parent a35c8aa098
commit d258c6f5bf
11 changed files with 375 additions and 227 deletions
Download Patch File Download Diff File Expand all files Collapse all files

130
readme.md
View File

@@ -6,7 +6,7 @@ Hutko – це платіжний сервіс, який рухає бізнес
## Зміст
1. [Функції](#функції)
1. [Функції](#функції та особливості)
2. [Встановлення](#встановлення)
@@ -16,23 +16,26 @@ Hutko – це платіжний сервіс, який рухає бізнес
5. [Підтримка](#підтримка)
## Функції
## Функції та особливості
* Безперешкодна інтеграція з платіжним шлюзом Hutko.
* Безпечна обробка платежів.
* Інтеграція з платіжним шлюзом Hutko для PrestaShop 1.7.7 - 8.2 (та 9.0-бета).
* Зберігання платіжного посилання для можливості надання клієнту повторно.
* Можливість повного або часткового повернення коштів безпосередньо зі сторінки обробки замовлення.
* Підтримка різних статусів платежів (Схвалено, Відхилено, Минув термін дії, Обробляється).
* Автоматичне оновлення статусу замовлення в PrestaShop.
* Надійна обробка зворотних викликів платежів для запобігання умовам гонки.
* Можливість включення вартості доставки у суму платежу.
* Можливість зберігання логів запитів до серверу для виявлення помилок та в інтересах безпеки.
## Встановлення
Виконайте такі кроки, щоб встановити модуль Hutko у вашому магазині PrestaShop:
Переконайтесь що на сервері встановлений модуль PHP cURL.
1. **Завантажте модуль:** Отримайте останню версію модуля Hutko з офіційного джерела або з наданого вами пакета.
1. **Завантажте модуль:** Отримайте останню версію модуля Hutko з офіційного джерела.
2. **Завантажте в PrestaShop:**
@@ -48,7 +51,6 @@ Hutko – це платіжний сервіс, який рухає бізнес
* Після завантаження PrestaShop автоматично виявить модуль.
* Натисніть кнопку «Встановити» поруч із модулем «Hutko».
* Дотримуйтесь будь-яких підказок на екрані.
@@ -64,13 +66,15 @@ Hutko – це платіжний сервіс, який рухає бізнес
2. **Введіть необхідні облікові дані:**
* **Ідентифікатор продавця:** Введіть свій унікальний ідентифікатор продавця, наданий Hutko. Це обов'язкове поле.
* **Ідентифікатор продавця (Merchant ID):** Введіть свій унікальний ідентифікатор продавця, наданий Hutko. Це обов'язкове поле.
* **Секретний ключ:** Введіть свій секретний ключ, наданий Hutko. Це обов'язкове поле, яке є критично важливим для безпечної перевірки підпису.
* **Статус успішного замовлення:** (Необов'язково, якщо застосовується) Виберіть статус замовлення, який слід застосовувати до замовлень, успішно оплачених через Hutko.
* **Статус успішного замовлення:** Виберіть статус замовлення, який слід застосовувати до замовлень, успішно оплачених через Hutko (дивіться примітку 7 у розділі Використання).
* **Статус нових замовлень до оплати:** Виберіть статус замовлення, який слід застосовувати до нових замовлень, оплата за які ще не надійшла (дивіться примітку 7 у розділі Використання).
* **Показати логотип картки:** (Необов'язково) Увімкніть або вимкніть відображення логотипів картки на сторінці вибору способу оплати.
* **Показати логотип картки:** Увімкніть або вимкніть відображення логотипів картки на сторінці вибору способу оплати.
3. **Зберегти зміни:** Натисніть кнопку "Зберегти", щоб застосувати налаштування конфігурації.
@@ -87,6 +91,9 @@ Hutko – це платіжний сервіс, який рухає бізнес
3. Після успішної оплати клієнта буде перенаправлено назад на сторінку підтвердження замовлення вашого магазину PrestaShop, і статус замовлення буде оновлено відповідно.
4. У разі невдалої оплати клієнта буде перенаправлено назад на сторінку замовлення з відповідним повідомленням про помилку.
5. Модуль автоматично отримує від серверу Hutko інформацію про оновлення стану платежу. При зміні статусу на "помилка" (declined) або "час вичерпано" (expired) - модуль присвоїть замовленню системний статус "Помилка платежу".
6. Якщо в налаштуваннях Prestashop встановлено рівень безпеки для Cookie SameSite "strict", то, при поверненні на сайт зі сторінки платежів Hutko, клієнт буде деавторизований. Це обмеження системи Prestashop. Модуль має спеціальну сторінку переадресації, яка дозволяє навіть при такому сценарї відобразити клієнту сторінку з підтвердженням замовлення. Для уникнення незручностей клієнтів рекомендуємо встановити обмеження Cookie SameSite у "none" (на вкладці Розширені папраметри -> Адімністрування).
7. Якщо статус замовлення в Prestashop має відмітку "вважати оплаченим", то при присвоєнні такого статусу, Prestashop автоматично створить в блоці Платежі новий платіж на суму недоплати. Це може створити непорозуміння щодо сум фактичних оплат. Для цього рекомендуємо обирати в налаштуваннях модулю статуси, в яких відключене налаштування "вважати оплаченим".
## Підтримка
@@ -96,104 +103,3 @@ Hutko – це платіжний сервіс, який рухає бізнес
* **Форуми PrestaShop:** Шукайте або залишайте своє запитання на офіційних форумах PrestaShop.
* **Зв’язатися з розробником:** Для отримання безпосередньої підтримки ви можете звернутися до автора модуля `panariga`.
# Hutko PrestaShop Payment Module
Hutko is a payment service that drives businesses forward. Launch, gain momentum, scale – we've got you covered everywhere.
This module integrates the Hutko payment gateway into your PrestaShop store, allowing your customers to pay for their orders securely through Hutko.
## Table of Contents
1. [Features](#features)
2. [Installation](#installation)
3. [Configuration](#configuration)
4. [Usage](#usage)
5. [Support](#support)
## Features
* Seamless integration with the Hutko payment gateway.
* Secure payment processing.
* Support for various payment statuses (Approved, Declined, Expired, Processing).
* Automatic order status updates in PrestaShop.
* Robust handling of payment callbacks to prevent race conditions.
## Installation
Follow these steps to install the Hutko module on your PrestaShop store:
1. **Download the Module:** Obtain the latest version of the Hutko module from the official source or your provided package.
2. **Upload to PrestaShop:**
* Log in to your PrestaShop admin panel.
* Navigate to **Modules > Module Manager**.
* Click on the "Upload a module" button (usually located in the top right corner).
* Drag and drop the module's `.zip` file into the upload area, or click to select the file.
3. **Install the Module:**
* Once uploaded, PrestaShop will automatically detect the module.
* Click on the "Install" button next to the "Hutko" module.
* Follow any on-screen prompts.
## Configuration
After successful installation, you must configure the module with your Hutko account details:
1. **Access Module Configuration:**
* In your PrestaShop admin panel, go to **Modules > Module Manager**.
* Find the "Hutko" module and click on the "Configure" button.
2. **Enter Required Credentials:**
* **Merchant ID:** Enter your unique Merchant ID provided by Hutko. This is a mandatory field.
* **Secret Key:** Enter your Secret Key provided by Hutko. This is a mandatory field and is crucial for secure signature validation.
* **Success Order Status:** (Optional, if applicable) Select the order status that should be applied to orders successfully paid via Hutko.
* **Show Cards Logo:** (Optional) Enable or disable the display of card logos on the payment selection page.
3. **Save Changes:** Click the "Save" button to apply your configuration settings.
**Important:** Without setting the correct **Merchant ID** and **Secret Key**, the module will not function correctly and will not appear as a payment option during checkout.
## Usage
Once configured, the Hutko payment option will automatically appear on your checkout page for customers.
1. Customers select "Pay via Hutko" on the payment step of the checkout.
2. They are redirected to the Hutko payment page to complete their transaction.
3. Upon successful payment, the customer is redirected back to your PrestaShop store's order confirmation page, and the order status is updated accordingly.
4. In case of payment failure, the customer will be redirected back to the order page with an appropriate error message.
## Support
If you encounter any issues or have questions regarding the Hutko PrestaShop module, please refer to the following:
* **Hutko Documentation:** Consult the official Hutko API and integration documentation for detailed information.
* **PrestaShop Forums:** Search or post your question on the official PrestaShop forums.
* **Contact Developer:** For direct support, you can contact the module author `panariga`.