diff --git a/config_uk.xml b/config_uk.xml deleted file mode 100644 index 96d98a5..0000000 --- a/config_uk.xml +++ /dev/null @@ -1,11 +0,0 @@ - - - hutko - - - - - - 1 - 1 - \ No newline at end of file diff --git a/controllers/front/callback.php b/controllers/front/callback.php index 38b00e3..a617007 100644 --- a/controllers/front/callback.php +++ b/controllers/front/callback.php @@ -36,7 +36,7 @@ class HutkoCallbackModuleFrontController extends ModuleFrontController exit; } try { - // 1. Parse the incoming request body. + // Parse the incoming request body. $calbackContent = $this->getCallbackContent(); @@ -55,13 +55,13 @@ class HutkoCallbackModuleFrontController extends ModuleFrontController $this->context->customer = new Customer($order->id_customer); $this->context->language = new Language($order->id_lang); - // 7. Handle payment status from the callback. + // Handle payment status from the callback. $orderStatusCallback = $calbackContent['order_status']; $currentOrderState = (int)$order->getCurrentState(); switch ($orderStatusCallback) { case 'approved': - // Only success state if no refunds was done. + // Only process success state if no refunds was done. if ($calbackContent['response_status'] == 'success' && (int)$calbackContent['reversal_amount'] === 0) { $expectedState = (int)Configuration::get('HUTKO_SUCCESS_STATUS_ID', null, null, null, Configuration::get('PS_OS_PAYMENT')); // Only change state if it's not already the success state or "Payment accepted". @@ -121,13 +121,13 @@ class HutkoCallbackModuleFrontController extends ModuleFrontController { $calbackContent = json_decode(file_get_contents("php://input"), true); if (!is_array($calbackContent) || !count($calbackContent)) { - PrestaShopLogger::addLog('Hutko Callback: Empty request body received.', 2, null, 'Cart', null, true); + PrestaShopLogger::addLog('Hutko Callback: Empty request body received.', 2); throw new Exception('Empty request'); } // Assuming validateResponse returns true on success, or a string error message on failure. $isSignatureValid = $this->module->validateResponse($calbackContent); if ($isSignatureValid !== true) { - PrestaShopLogger::addLog('Hutko Callback: Invalid signature. Error: ' . $isSignatureValid, 2, null, 'Cart', null, true); + PrestaShopLogger::addLog('Hutko Callback: Invalid signature. Error: ' . $isSignatureValid, 2); throw new Exception('Invalid signature'); } if (Configuration::get('HUTKO_SAVE_LOGS')) { diff --git a/controllers/front/redirect.php b/controllers/front/redirect.php index 156a9a5..925d57a 100644 --- a/controllers/front/redirect.php +++ b/controllers/front/redirect.php @@ -57,7 +57,7 @@ class HutkoRedirectModuleFrontController extends ModuleFrontController return; } $this->context->smarty->assign([ - 'hutko_response' => $responseData['response'], // The URL of the Hutko payment gateway. + 'hutko_response' => $responseData['response'], ]); } } diff --git a/controllers/front/return.php b/controllers/front/return.php index 0da0033..0be11a9 100644 --- a/controllers/front/return.php +++ b/controllers/front/return.php @@ -77,8 +77,6 @@ class HutkoReturnModuleFrontController extends ModuleFrontController // Validate the decoded JSON: // 1. Check if json_decode returned an array. // 2. Check if all expected keys ('id_cart', 'id_module', 'id_order', 'key') exist in the array. - // 3. Check if the 'key' from the decoded data matches the secure key of the currently logged-in customer. - // This is a critical security step to prevent unauthorized access to order details. if ( is_array($decodedPV) && isset($decodedPV['id_cart']) diff --git a/hutko.php b/hutko.php index 542af95..e7ae515 100644 --- a/hutko.php +++ b/hutko.php @@ -45,9 +45,10 @@ class Hutko extends PaymentModule { $this->name = 'hutko'; $this->tab = 'payments_gateways'; - $this->version = '1.3.0'; + $this->version = '1.3.1'; $this->author = 'Hutko'; $this->bootstrap = true; + $this->need_instance = false; parent::__construct(); $this->ps_versions_compliancy = array('min' => '1.7', 'max' => _PS_VERSION_); //Do not translate displayName as it is used for payment identification @@ -99,12 +100,12 @@ class Hutko extends PaymentModule return true; } - + /** * Load the configuration form */ - public function getContent() + public function getContent(): string { /** * If values have been submitted in the form, process. @@ -121,7 +122,7 @@ class Hutko extends PaymentModule } } - return $err . $this->renderForm() . $this->context->smarty->fetch('module:hutko/views/templates/admin/help.tpl').$this->displayLastDayLog(); + return $err . $this->renderForm() . $this->context->smarty->fetch('module:hutko/views/templates/admin/help.tpl') . $this->displayLastDayLog(); } /** @@ -582,7 +583,7 @@ class Hutko extends PaymentModule if (Configuration::get('HUTKO_SHIPPING_INCLUDE') && $order->total_shipping_tax_incl > 0) { $products[] = [ "id" => Configuration::get('HUTKO_SHIPPING_PRODUCT_CODE', null, null, null, '0_0_1'), - "name" => Configuration::get('HUTKO_SHIPPING_PRODUCT_NAME', null, null, null, 'Service Fee'), + "name" => Configuration::get('HUTKO_SHIPPING_PRODUCT_NAME', null, null, null, 'Package material'), "price" => round((float)$order->total_shipping_tax_incl, 2), "total_amount" => round((float) $order->total_shipping_tax_incl, 2), "quantity" => 1, diff --git a/readme.md b/readme.md index 6232818..f6719b0 100644 --- a/readme.md +++ b/readme.md @@ -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`. \ No newline at end of file diff --git a/translations/ru-RU/ModulesHutkoAdmin.ru-RU.xlf b/translations/ru-RU/ModulesHutkoAdmin.ru-RU.xlf index 1314844..468e8da 100644 --- a/translations/ru-RU/ModulesHutkoAdmin.ru-RU.xlf +++ b/translations/ru-RU/ModulesHutkoAdmin.ru-RU.xlf @@ -2,14 +2,19 @@ + + Pay via Hutko: + Оплата через Hutko: + Line: + Hutko is a payment platform whose main function is to provide internet acquiring. - Hutko — це платіжна платформа, основною функцією якої є забезпечення інтернет-еквайрингу. + Hutko – это платежная платформа, основной функцией которой является обеспечение интернет-эквайринга. Line: Please specify the Hutko account details for customers - Пожалуйста, укажите реквизиты учетной записи Hutko для клиентов + Укажите реквизиты учетной записи Hutko для клиентов Line: @@ -29,37 +34,37 @@ Secret key - Секретний ключ + Секретный ключ Line: Status after success payment - Статус після успішної оплати + Статус после успешной оплаты Line: Status for new orders before payment - Статус нових замовлень до оплати + Статус новых заказов до оплаты Line: Include shipping cost to payment - Включити вартість доставки до оплати + Включить стоимость доставки в оплату Line: Yes - Так + Да Line: No - Ні + Нет Line: Shipping Name - Назва для доставки + Название для доставки Line: @@ -79,7 +84,12 @@ Show Visa/MasterCard logo - Показати логотип Visa/MasterCard + Показать логотип Visa/MasterCard + Line: + + + Include fixed amount discounts to Payment amount calculation + Включить фиксированные скидки в расчет суммы платежа Line: @@ -89,22 +99,22 @@ Save - Зберегти + Сохранить Line: Merchant ID is required. - Потрібен ідентифікатор продавця (Merchant ID). + Требуется идентификатор продавца (Merchant ID). Line: Merchant ID must be numeric. - Ідентифікатор продавця має бути числовим. + Идентификатор продавца должен быть числовым. Line: Secret key is required. - Потрібен секретний ключ. + Нужен секретный ключ. Line: @@ -114,7 +124,7 @@ Pay via payment system Hutko - Оплата через платіжну систему Hutko + Оплата через платежную систему Hutko Line: @@ -124,22 +134,22 @@ Order payment # - Оплата замовлення # + Оплата заказа # Line: Order payment not found. - Оплата замовлення не знайдена. + Оплата заказа не найдена. Line: Invalid transaction ID format. - Недійсний формат ідентифікатора транзакції. + Недействителен формат идентификатора транзакции. Line: Refund success. - Повернення коштів успішне. + Возврат средств успешно. Line: @@ -147,6 +157,31 @@ Возврат не удался. Проверьте фактическую сумму на странице учетной записи Hutko. Line: + + Hutko Module Logs + Журналы модуля Hutko + Line: + + + Log file for %s + Файл журнала для %s + Line: + + + The log file is empty. + Файл журнала пуст. + Line: + + + Could not read the log file: + Не удалось прочитать файл журнала: + Line: + + + No log file found in the last %d days. + За последние %d дней не найдено ни одного файла журнала. + Line: + Платежі та повернення коштів Hutko @@ -159,27 +194,27 @@ Amount - Сума + Сумма Line: Payment Date - Дата платежу + Дата платежа Line: Actions - Дії + Действия Line: Refund - Повернення коштів + Возврат средств Line: Refund Amount - Сума відшкодування + Сумма возмещения Line: @@ -189,22 +224,122 @@ Refund Reason/Comment - Причина/коментар повернення коштів + Причина/комментарий возврата средств Line: Optional: A brief reason for the refund. - Необов'язково: Коротка причина повернення коштів. + Необязательно: краткая причина возврата средств. Line: Cancel - Скасувати + Отменить Line: Process Refund - Виконати повернення коштів + Выполнить возврат средств + Line: + + + Welcome to the Hutko payment system. + Добро пожаловать в платежную систему Hutko. + Line: + + + This module provides convenient acceptance of payments from customers, fiscalization and processing of returns directly in your PrestaShop store. + Этот модуль обеспечивает удобный прием платежей от покупателей, фискализацию и обработку возвратов непосредственно в вашем магазине PrestaShop. + Line: + + + How it works: + Как это работает: + Line: + + + When choosing Hutko as a payment method, the order is automatically created in PrestaShop before the actual payment. This allows you to save customer data and not lose potential sales. + При выборе Hutko в качестве способа оплаты заказ автоматически создается в PrestaShop до фактической оплаты. Это позволяет сохранить данные о клиентах и ​​не потерять потенциальные продажи. + Line: + + + A payment record with an amount of 0 is automatically added to the details of this order. This record contains a unique transaction ID, which may be useful when contacting Hutko support. + В детали этого заказа автоматически добавляется запись платежа с суммой 0. Эта запись содержит уникальный идентификатор транзакции, который может быть полезен при обращении в службу поддержки Hutko. + Line: + + + In the details of this zero payment, you will also find the link to the payment page that was offered to the customer. This link can be used, for example, to resend to the customer. + В деталях этого нулевого платежа вы также найдете ссылку на страницу оплаты, куда был перенаправлен клиент. Эту ссылку можно использовать, например, для повторной отправки клиенту. + Line: + + + Shipping cost: + Стоимость доставки: + Line: + + + You can include the shipping cost in the payment amount, or receive payments only for the goods. + Вы можете включить стоимость доставки в сумму платежа или получать платежи только за товар. + Line: + + + Important for trade in Ukraine: Single tax payers are not entitled to provide postal services. Consult with an accountant and lawyer regarding specifying the correct name of the service/goods. + Важно для торговли в Украине: Плательщики единого налога не имеют права предоставлять услуги почтовой связи. Проконсультируйтесь с бухгалтером и юристом по поводу указания правильного наименования услуги/товара. + Line: + + + Refunds processing: + Обработка возвратов: + Line: + + + For convenient management of payments related to Hutko, a special block is available on the order page. Through it, you can quickly issue a full or partial refund to the client. + Для удобного управления платежами, связанными с Hutko, на странице заказа доступен специальный блок, с помощью которого можно быстро оформить полный или частичный возврат средств клиенту. + Line: + + + Important: Fiscalization of refund operations must be carried out independently. The Hutko system does not perform automatic fiscalization of refunds. + Важно: Фискализация операций по возврату должна осуществляться самостоятельно. Система Hutko не осуществляет автоматическую фискализацию возвратов. + Line: + + + Important notes: + Важные примечания: + Line: + + + Refund display in PrestaShop: Depending on the version of PrestaShop, a refund may be displayed in the order payment list as a negative or even positive amount. Do not use this data in the PrestaShop dashboard as a final confirmation of the actual payment to the account. + Отображение возврата в PrestaShop: В зависимости от версии PrestaShop возврат может отображаться в списке платежей по заказу как отрицательная или даже положительная сумма. Не используйте эти данные в панели управления PrestaShop как окончательное подтверждение фактического платежа на счет. + Line: + + + Hutko Fiscalization Limitations: Currently, the Hutko system does not fiscalize payments where the amount to be paid is different from the total value of the items in the cart (for example, a coupon for a fixed amount). + Ограничения по фискализации Hutko: в настоящее время система Hutko не фискализирует платежи, сумма которых к оплате отличается от общей стоимости товаров в корзине (например, купон на фиксированную сумму). + Line: + + + Discount processing settings: The module has an option to take into account coupons for a fixed amount. When it is activated, the order amount, taking into account the coupon discount for a fixed amount, is transferred to Hutko for payment. This prevents the transaction from being fiscalized. By default, the cost of the goods (including percentage discounts) and the cost of delivery (unless disabled in the settings) are transferred to Hutko for payment. Percentage discounts that directly change the price of the goods are always taken into account. + Настройки обработки скидок: В модуле реализована возможность учета купонов на фиксированную сумму. При ее активации сумма заказа с учетом скидки по купону на фиксированную сумму передается в Hutko для оплаты. Это позволяет избежать фискализации транзакции. По умолчанию в Hutko для оплаты передается стоимость товара (включая процентные скидки) и стоимость доставки (если не отключено в настройках). Всегда учитываются процентные скидки, которые напрямую изменяют цену товара. + Line: + + + The module automatically receives information about payment status updates from the Hutko server. When the status changes to "declined" or "expired", the module will assign the order the system status "Payment error". + Модуль автоматически получает информацию об обновлениях статуса платежа с сервера Hutko. При изменении статуса на «отклонен» или «истек», модуль присвоит заказу системный статус «Ошибка платежа». + Line: + + + Administration tab).]]> + Администрирование).]]> + Line: + + + 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 that you select statuses in the module settings in which the "consider paid" setting is disabled + Если в Prestashop статус заказа отмечен как "считается оплаченным", то при присвоении такого статуса Prestashop автоматически создаст новый платеж в блоке "Платежи" на сумму недоплаты. Это может создать недопонимание относительно сумм фактических платежей. Для этого рекомендуем выбирать в настройках модуля статусы, в которых отключена настройка "считается оплаченным" + Line: + + + Hutko Support + Поддержка Hutko Line: diff --git a/translations/uk-UA/ModulesHutkoAdmin.uk-UA.xlf b/translations/uk-UA/ModulesHutkoAdmin.uk-UA.xlf index db031c8..8cbf155 100644 --- a/translations/uk-UA/ModulesHutkoAdmin.uk-UA.xlf +++ b/translations/uk-UA/ModulesHutkoAdmin.uk-UA.xlf @@ -2,6 +2,11 @@ + + Pay via Hutko: + Оплата через Hutko: + Line: + Hutko is a payment platform whose main function is to provide internet acquiring. Hutko — це платіжна платформа, основною функцією якої є забезпечення інтернет-еквайрингу. @@ -82,6 +87,11 @@ Показати логотип Visa/MasterCard Line: + + Include fixed amount discounts to Payment amount calculation + Включити знижки на фіксовану суму до розрахунку суми платежу + Line: + Save Logs Зберігати лог запитів від/до серверу Hutko @@ -147,6 +157,31 @@ Повернення коштів не вдалося. Будь ласка, перевірте фактичну суму на сторінці облікового запису Hutko. Line: + + Hutko Module Logs + Лог операцій Hutko + Line: + + + Log file for %s + Файл логів для %s + Line: + + + The log file is empty. + Файл логів порожній. + Line: + + + Could not read the log file: + Не вдалося прочитати файл логів: + Line: + + + No log file found in the last %d days. + За останні %d днів не знайдено жодного файлу логів. + Line: + Платежі та повернення коштів Hutko @@ -207,6 +242,120 @@ Виконати повернення коштів Line: + + Welcome to the Hutko payment system. + Ласкаво просимо до платіжної системи Hutko. + Line: + + + This module provides convenient acceptance of payments from customers, fiscalization and processing of returns directly in your PrestaShop store. + Цей модуль забезпечує зручне прийняття платежів від клієнтів, фіскалізацію та обробку повернень + безпосередньо + у вашому магазині PrestaShop. + Line: + + + How it works: + Як це працює: + Line: + + + When choosing Hutko as a payment method, the order is automatically created in PrestaShop before the actual payment. This allows you to save customer data and not lose potential sales. + При виборі Hutko як способу оплати замовлення автоматично створюється в PrestaShop перед фактичною оплатою. Це дозволяє зберегти дані клієнтів та не втрачати потенційних продажів. + Line: + + + A payment record with an amount of 0 is automatically added to the details of this order. This record contains a unique transaction ID, which may be useful when contacting Hutko support. + До переліку платежів цього замовлення автоматично додається платіжний запис із сумою 0. Цей запис містить унікальний ідентифікатор транзакції, який може бути корисним під час звернення до служби підтримки Hutko. + Line: + + + In the details of this zero payment, you will also find the link to the payment page that was offered to the customer. This link can be used, for example, to resend to the customer. + У деталях цього нульового платежу ви також знайдете посилання на сторінку оплати, запропоновану клієнту. Це посилання можна використовувати, наприклад, для повторного надсилання клієнту. + Line: + + + Shipping cost: + Вартість доставки: + Line: + + + You can include the shipping cost in the payment amount, or receive payments only for the goods. + Ви можете включити вартість доставки до суми платежу, або отримувати оплати лише за товари. + Line: + + + Important for trade in Ukraine: Single tax payers are not entitled to provide postal services. Consult with an accountant and lawyer regarding specifying the correct name of the service/goods. + Важливо для торгівлі в Україні: Платники єдиного податку не мають права надавати поштові послуги. Проконсультуйтеся з бухгалтером та юристом щодо зазначення правильної назви послуги/товару. + Line: + + + Refunds processing: + Обробка повернень: + Line: + + + For convenient management of payments related to Hutko, a special block is available on the order page. Through it, you can quickly issue a full or partial refund to the client. + Для зручного керування платежами, пов'язаними з Hutko, на сторінці замовлення доступний спеціальний + блок. + Через нього ви можете швидко оформити повне або часткове повернення коштів клієнту. + Line: + + + Important: Fiscalization of refund operations must be carried out independently. The Hutko system does not perform automatic fiscalization of refunds. + Важливо: Фіскалізацію операцій з повернення коштів необхідно здійснювати самостійно. Система Hutko не виконує автоматичної фіскалізації повернень коштів. + Line: + + + Important notes: + Важливі примітки: + Line: + + + Refund display in PrestaShop: Depending on the version of PrestaShop, a refund may be displayed in the order payment list as a negative or even positive amount. Do not use this data in the PrestaShop dashboard as a final confirmation of the actual payment to the account. + Відображення повернення коштів у PrestaShop: Залежно від версії PrestaShop, повернення коштів може відображатися у списку оплат замовлень як від’ємна або навіть додатна сума. Не використовуйте ці дані на панелі інструментів PrestaShop як остаточне підтвердження фактичного платежу на рахунок. + Line: + + + Hutko Fiscalization Limitations: Currently, the Hutko system does not fiscalize payments where the amount to be paid is different from the total value of the items in the cart (for example, a coupon for a fixed amount). + Обмеження фіскалізації Hutko: Наразі система Hutko не фіскалізує платежі, сума яких до сплати відрізняється від загальної вартості товарів у кошику (наприклад, купон на фіксовану суму). + Line: + + + Discount processing settings: The module has an option to take into account coupons for a fixed amount. When it is activated, the order amount, taking into account the coupon discount for a fixed amount, is transferred to Hutko for payment. This prevents the transaction from being fiscalized. By default, the cost of the goods (including percentage discounts) and the cost of delivery (unless disabled in the settings) are transferred to Hutko for payment. Percentage discounts that directly change the price of the goods are always taken into account. + Налаштування обробки знижок: Модуль має опцію врахування купонів на фіксовану суму. При її активації сума замовлення з урахуванням знижки за купоном на фіксовану суму перераховується до Hutko для оплати. Це запобігає фіскалізації транзакції. За замовчуванням до Hutko для оплати перераховується вартість товару (включаючи відсоткові знижки) та вартість доставки (якщо не вимкнено в налаштуваннях). Відсоткові знижки, які безпосередньо змінюють ціну товару, враховуються завжди. + Line: + + + The module automatically receives information about payment status updates from the Hutko server. When the status changes to "declined" or "expired", the module will assign the order the system status "Payment error". + Модуль автоматично отримує від серверу Hutko інформацію про оновлення стану платежу. При зміні статусу + на "помилка" (declined) або "час вичерпано" (expired) - модуль присвоїть замовленню системний статус + "Помилка платежу". + Line: + + + Administration tab).]]> + + Адімністрування).]]> + Line: + + + 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 that you select statuses in the module settings in which the "consider paid" setting is disabled + Якщо статус замовлення в Prestashop в престашоп має відмітку "вважати оплаченим", то при присвоєнні + такого статусу, Prestashop автоматично створить в блоці Платежі новий платіж на суму недоплати. Це може + створити непорозуміння щодо сум фактичних оплат. Для цього рекомендуємо обирати в налаштуваннях модулю + статуси, в яких відключене налаштування "вважати оплаченим" + Line: + + + Hutko Support + Підтримка Hutko + Line: + diff --git a/views/templates/admin/help.tpl b/views/templates/admin/help.tpl index 9fa9b3d..c67c8c4 100644 --- a/views/templates/admin/help.tpl +++ b/views/templates/admin/help.tpl @@ -5,74 +5,52 @@
-

Ласкаво просимо до платіжної системи Hutko.

-

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

-
-

Як це працює:

-

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

-

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

-

- У деталях цього нульового платежу ви також знайдете посилання на сторінку оплати, яке - було - запропоновано клієнту. Це посилання можна використати, наприклад, для повторного надсилання клієнту. +

{l s='Welcome to the Hutko payment system.' d='Modules.Hutko.Admin'}

+

{l s='This module provides convenient acceptance of payments from customers, fiscalization and processing of returns directly in your PrestaShop store.' d='Modules.Hutko.Admin'}


-

Вартість доставки:

-

- Ви можете включити вартість доставки до суми платежу, або отримувати оплати лише за товари. +

{l s='How it works:' d='Modules.Hutko.Admin'}

+

{l s='When choosing Hutko as a payment method, the order is automatically created in PrestaShop before the actual payment. This allows you to save customer data and not lose potential sales.' d='Modules.Hutko.Admin'} +

+

{l s='A payment record with an amount of 0 is automatically added to the details of this order. This record contains a unique transaction ID, which may be useful when contacting Hutko support.' d='Modules.Hutko.Admin'} +

+

{l s='In the details of this zero payment, you will also find the link to the payment page that was offered to the customer. This link can be used, for example, to resend to the customer.' d='Modules.Hutko.Admin'} +

+
+

{l s='Shipping cost:' d='Modules.Hutko.Admin'}

+

{l s='You can include the shipping cost in the payment amount, or receive payments only for the goods.' d='Modules.Hutko.Admin'}

- Важливо: Платники єдиного податку - не мають права надавати послуги пошти. Проконсультуйтеся с бухгалтером та юристом щодо зазначення правильної назви послуги/товару. + {l s='Important for trade in Ukraine: Single tax payers are not entitled to provide postal services. Consult with an accountant and lawyer regarding specifying the correct name of the service/goods.' d='Modules.Hutko.Admin'}


-

Обробка повернень:

-

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

{l s='Refunds processing:' d='Modules.Hutko.Admin'}

+

{l s='For convenient management of payments related to Hutko, a special block is available on the order page. Through it, you can quickly issue a full or partial refund to the client.' d='Modules.Hutko.Admin'}

- Важливо: Фіскалізацію операцій повернення коштів необхідно проводити - самостійно. Система Hutko не здійснює автоматичну фіскалізацію повернень. + {l s='Important: Fiscalization of refund operations must be carried out independently. The Hutko system does not perform automatic fiscalization of refunds.' d='Modules.Hutko.Admin'}


-

Важливі примітки:

+

{l s='Important notes:' d='Modules.Hutko.Admin'}

    -
  • - Відображення повернень у PrestaShop: Залежно від версії PrestaShop, повернення - коштів - може відображатися у списку платежів замовлення як від'ємна або навіть позитивна сума. Не - використовуйте ці дані у панелі PrestaShop як остаточне підтвердження фактичного - зарахування коштів на рахунок. +
  • {l s='Refund display in PrestaShop: Depending on the version of PrestaShop, a refund may be displayed in the order payment list as a negative or even positive amount. Do not use this data in the PrestaShop dashboard as a final confirmation of the actual payment to the account.' d='Modules.Hutko.Admin'}
  • -
  • - Обмеження фіскалізації Hutko: Наразі система Hutko не фіскалізує платежі, де сума - до - сплати відрізняється від суми вартості товарів у кошику (наприклад, купон на фіксовану суму). +
  • {l s='Hutko Fiscalization Limitations: Currently, the Hutko system does not fiscalize payments where the amount to be paid is different from the total value of the items in the cart (for example, a coupon for a fixed amount).' d='Modules.Hutko.Admin'}
  • -
  • - Налаштування обробки знижок: Модуль має опцію врахування купонів на фіксовану суму. - При її - активації до Hutko передається для оплати сума замовлення з урахуванням знижки по купону на - фіксовану - суму. Це перешкоджає фіскалізації операції. - За замовчуванням до Hutko передається для оплати вартість товарів (з урахуванням відсоткових знижок) - та вартість доставки (якщо не вимкнено у налаштуванні). - Відсоткові знижки, які безпосередньо змінюють ціну товару, враховуються завжди. +
  • {l s='Discount processing settings: The module has an option to take into account coupons for a fixed amount. When it is activated, the order amount, taking into account the coupon discount for a fixed amount, is transferred to Hutko for payment. This prevents the transaction from being fiscalized. By default, the cost of the goods (including percentage discounts) and the cost of delivery (unless disabled in the settings) are transferred to Hutko for payment. Percentage discounts that directly change the price of the goods are always taken into account.' d='Modules.Hutko.Admin'}

+

{l s='The module automatically receives information about payment status updates from the Hutko server. When the status changes to "declined" or "expired", the module will assign the order the system status "Payment error".' d='Modules.Hutko.Admin'} +

+
+ +

{l s='If the security level for the SameSite Cookie 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 this scenario to display the order confirmation page to the customer. To avoid inconvenience to customers we recommend setting the SameSite Cookie restriction to "none" (on the Advanced Settings -> Administration tab).' d='Modules.Hutko.Admin'} +

+
+

{l s='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 that you select statuses in the module settings in which the "consider paid" setting is disabled' d='Modules.Hutko.Admin'} +

+

{l s='Hutko Support' d='Modules.Hutko.Admin'}

diff --git a/views/templates/admin/order_payment_refund.tpl b/views/templates/admin/order_payment_refund.tpl index 2af5756..5c200b3 100644 --- a/views/templates/admin/order_payment_refund.tpl +++ b/views/templates/admin/order_payment_refund.tpl @@ -17,7 +17,7 @@
- +
@@ -45,14 +45,6 @@ {/if} - {* - *}