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 в настройки шлюза.