Hutko — оплата карткою і частинами ПУМБ для WooCommerce

Hutko for WooCommerce — платіжний плагін для приймання оплат карткою Visa/Mastercard, Apple Pay та Google Pay через еквайринг Hutko. Оплата відбувається на захищеній сторінці Hutko, а підтвердження замовлення — без вашої участі: Hutko надсилає server-callback на REST-вебхук магазину, плагін перевіряє SHA1-підпис і переводить замовлення у «В обробці» чи «Виконано». Замовлення закривається оплаченим тільки тоді, коли гроші реально пройшли.

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

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

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

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

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

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

• Окремий REST-маршрут для callback-ів — wc-hutko/v1/webhook; кожен запит проходить перевірку SHA1-підпису до будь-якої зміни замовлення.
• server_callback_url передається у кожному платежі — прописувати його вручну в кабінеті Hutko не потрібно.
• Secret key зберігається у БД зашифрованим, а не відкритим текстом у таблиці опцій.
• Сумісність з HPOS і блоковим чекаутом заявлена через WooCommerce FeaturesUtil — плагін готовий до сучасних інсталяцій Woo.
• Розстрочка — це той самий Hutko: плагін передає payment_systems=installments, тож сторінка оплати відкривається одразу на розстрочці ПУМБ. Callback, SHA1-підпис і звірка статусу — ті самі, що й для картки; у замовленні зберігається, яким методом Hutko пройшла оплата.
• Межі суми перевіряються двічі — коли будується список способів оплати і ще раз перед переходом у банк, якщо кошик змінили вже на сторінці чекауту.
• Логування у WooCommerce → Статус → Журнали — при розборі спірної оплати видно кожен запит і відповідь.

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

1. Плагіни → Додати новий → Завантажити: оберіть hutko-for-woocommerce-1.2.1.zip і активуйте плагін.
2. Відкрийте WooCommerce → Налаштування → Оплата і увімкніть Hutko.
3. Для перевірки лишіть «Тестовий режим»: оплати підуть через публічний тестовий мерчант Hutko, реальні кошти не рухаються.
4. Для бойового режиму впишіть Merchant ID і secret key з кабінету Hutko.
5. Для оплати частинами: після підключення послуги в hutko відкрийте WooCommerce → Налаштування → Оплата → «Hutko — оплата частинами ПУМБ», увімкніть і за потреби змініть межі суми.
6. Для Pro: після покупки вставте ліцензійний ключ з email у налаштування шлюзу.