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

Hutko – це платіжний сервіс, який рухає бізнес вперед. Запуск, набирання обертів, масштабування – ми подбаємо про вас усюди.

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

Зміст

1. [Функції](#функції та особливості)

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

3. Конфігурація

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

5. Підтримка

Функції та особливості

• Інтеграція з платіжним шлюзом Hutko для PrestaShop 1.7.7 - 8.2 (та 9.0-бета).

• Зберігання платіжного посилання для можливості надання клієнту повторно.

• Можливість повного або часткового повернення коштів безпосередньо зі сторінки обробки замовлення.

• Підтримка різних статусів платежів (Схвалено, Відхилено, Минув термін дії, Обробляється).

• Автоматичне оновлення статусу замовлення в PrestaShop.

• Можливість включення вартості доставки у суму платежу.

• Можливість зберігання логів запитів до серверу для виявлення помилок та в інтересах безпеки.

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

Виконайте такі кроки, щоб встановити модуль Hutko у вашому магазині PrestaShop: Переконайтесь що на сервері встановлений модуль PHP cURL.

1. Завантажте модуль: Отримайте останню версію модуля Hutko з офіційного джерела.

2. Завантажте в PrestaShop:

• Увійдіть до панелі адміністратора PrestaShop.

• Перейдіть до Модулі > Менеджер модулів.

• Натисніть кнопку «Завантажити модуль» (зазвичай розташована у верхньому правому куті).

• Перетягніть файл модуля .zip в область завантаження або клацніть, щоб вибрати файл.

3. Встановіть модуль:

• Після завантаження PrestaShop автоматично виявить модуль.

• Дотримуйтесь будь-яких підказок на екрані.

Конфігурація

Після успішної інсталяції необхідно налаштувати модуль, використовуючи дані вашого облікового запису Hutko:

1. Конфігурація модуля доступу:

• У панелі адміністратора PrestaShop перейдіть до Модулі > Менеджер модулів.

• Знайдіть модуль "Hutko" та натисніть кнопку "Налаштувати".

2. Введіть необхідні облікові дані:

• Ідентифікатор продавця (Merchant ID): Введіть свій унікальний ідентифікатор продавця, наданий Hutko. Це обов'язкове поле.

• Секретний ключ: Введіть свій секретний ключ, наданий Hutko. Це обов'язкове поле, яке є критично важливим для безпечної перевірки підпису.

• Статус успішного замовлення: Виберіть статус замовлення, який слід застосовувати до замовлень, успішно оплачених через Hutko (дивіться примітку 7 у розділі Використання).

• Статус нових замовлень до оплати: Виберіть статус замовлення, який слід застосовувати до нових замовлень, оплата за які ще не надійшла (дивіться примітку 7 у розділі Використання).

• Показати логотип картки: Увімкніть або вимкніть відображення логотипів картки на сторінці вибору способу оплати.

3. Зберегти зміни: Натисніть кнопку "Зберегти", щоб застосувати налаштування конфігурації.

Важливо: Без правильного налаштування Ідентифікатора продавця та Секретного ключа модуль не працюватиме належним чином і не відображатиметься як варіант оплати під час оформлення замовлення.

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

Після налаштування варіант оплати 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 PrestaShop, будь ласка, зверніться до наступного:

• Документація Hutko: Зверніться до офіційного API та документації інтеграції Hutko для отримання детальної інформації.

• Форуми PrestaShop: Шукайте або залишайте своє запитання на офіційних форумах PrestaShop.