Hutko — оплата карткою і частинами ПУМБ для OpenCart 2.3, 3.x і 4.x

Hutko для OpenCart — модуль оплати, який приймає картки Visa та Mastercard через еквайринг Hutko у магазинах на OpenCart 2.3, 3.x і 4.x. Введення картки відбувається на захищеній сторінці Hutko, а результат повертається в магазин підписаним server-callback-ом: модуль перевіряє SHA1-підпис і сам виставляє замовленню правильний статус. Оплачені й неоплачені замовлення розділяються автоматично, без ручної звірки з кабінетом.

З версії 1.2.0 — ще й «Оплата частинами ПУМБ». Окремого API для онлайн-розстрочки в ПУМБ немає: банк продає її через свій сервіс hutko. Модуль додає на чекаут окремий спосіб оплати, і покупець одразу потрапляє на сторінку Hutko з розстрочкою ПУМБ — до 24 платежів, підтвердження в застосунку банку. Магазин отримує всю суму одразу, а ризик неповернення бере на себе банк. Працює на OpenCart 4, 3 і 2.3.

Як це працює — крок за кроком

1. На чекауті покупець обирає «Оплата карткою (Hutko)» і підтверджує замовлення.
2. Модуль формує підписаний запит і відправляє покупця на захищену сторінку оплати Hutko.
3. Hutko проводить платіж і надсилає магазину server-callback з SHA1-підписом.
4. Модуль перевіряє підпис — і замовлення отримує потрібний статус в OpenCart без участі менеджера.
5. На поверненні покупця статус додатково звіряється, тож «оплаченим» замовлення стає лише після реального проходження коштів.
6. Оплата частинами ПУМБ: покупець вводить на сторінці Hutko телефон, привʼязаний до застосунку ПУМБ, обирає кількість платежів і підтверджує розстрочку в застосунку. Поки підтвердження немає, замовлення чекає оплати з позначкою в історії; щойно банк погодив — приходить callback, і замовлення отримує статус «оплачено» на повну суму.
7. З Pro: заблокована preauth-сума списується (capture), коли ви переводите замовлення у виконаний статус, а повернення робите з журналу платежів.

Оплата частинами ПУМБ: умови

• Від 3 до 24 платежів без комісії для покупця; перший платіж — через 30 днів.
• Сума покупки — від 500 до 300 000 грн; фактичний ліміт залежить від кредитної історії покупця і ліміту на його картці ПУМБ.
• Магазин отримує всю суму на рахунок у ПУМБ наступного робочого дня, ризик неповернення бере банк.
• Що потрібно магазину: бізнес-рахунок у ПУМБ, мерчант Hutko і заявка в підтримку hutko на підключення послуги. Умови банку та тарифи — на сторінці hutko.org «Оплата частинами від ПУМБ»; їх встановлює банк, і вони можуть змінюватися.
• Поки послугу не підключено, Hutko не створює такий платіж; покупець побачить прохання обрати інший спосіб оплати.
• Оплата частинами входить у безкоштовну версію модуля.

Що під капотом

• Нативний код під OpenCart 4 — неймспейси, Twig, штатний інсталятор; для OpenCart 3 і 2.3 зібрано окремі порти, а не один архів «на всі версії».
• Secret key зберігається зашифрованим (AES-256-CBC + HMAC) з прив’язкою до інсталяції — у дампі БД відкритого ключа не буде.
• Callback без валідного SHA1-підпису відхиляється — статус замовлення неможливо змінити стороннім запитом.
• Розстрочка — це той самий Hutko: модуль передає payment_systems=installments, тож сторінка оплати відкривається одразу на розстрочці ПУМБ. Callback, SHA1-підпис, звірка статусу й захист від недоплати — ті самі, що й для картки. В OpenCart 4 це друга опція способу Hutko, в OpenCart 3 і 2.3 — окреме платіжне розширення «Hutko — оплата частинами ПУМБ».
• М’який Pro-гейт: Pro-поля видно завжди, але без ключа вони сірі — одразу зрозуміло, що саме дає ліцензія. Після завершення тріалу без ключа вимикаються лише Pro-функції, безкоштовне приймання оплат не зупиняється.

Як встановити

1. Розширення → Інсталятор: завантажте hutko.ocmod.zip. Для OpenCart 3.0.x беріть hutko-oc3-1.2.1.ocmod.zip, для OpenCart 2.3 — hutko-oc2-1.2.1.ocmod.zip із завантажень товару.
2. OpenCart 2.3: штатний Інсталятор у цій версії копіює файли лише по FTP, тому вміст теки upload/ з архіву заливається в корінь магазину файловим менеджером або по SFTP — ядро при цьому не перезаписується.
3. У Розширення → Платежі знайдіть Hutko і натисніть «Встановити», потім відкрийте налаштування.
4. Увімкніть модуль і для першої перевірки лишіть тестовий режим — оплата піде через публічний тестовий мерчант.
5. Для реальних оплат вимкніть тест і впишіть Merchant ID та secret key з кабінету Hutko.
6. Оплата частинами ПУМБ: після підключення послуги в hutko в OpenCart 4 відкрийте вкладку «Оплата частинами ПУМБ» у налаштуваннях Hutko; в OpenCart 3 і 2.3 встановіть у Розширення → Платежі «Hutko — оплата частинами ПУМБ». Увімкніть і за потреби змініть межі суми.
7. Для Pro: вставте ліцензійний ключ з email після покупки — журнал і розширені функції з’являться одразу, без переустановлення.