OcBox PaymentHub — хаб оплат для OpenCart 3 і ocStore: LiqPay, Monobank, WayForPay, NovaPay, Rozetka Pay, ПриватБанк, ПУМБ

OcBox PaymentHub, всі українські оплати в одному модулі OpenCart 3

У стандартному OpenCart кожна оплата це окремий модуль: LiqPay ставите один, Monobank інший, WayForPay третій, оплату частинами четвертий. У кожного своя адмінка, свій формат ключів, свій куточок логів. Клієнт заплатив, а замовлення так і висить у «Очікує оплати», бо стандартний вебхук не звірив підпис і не перевів статус. Менеджер вручну відкриває кабінет банку і ставить статус, ще й перевіряє, чи сума збіглась.

OcBox PaymentHub робить те, що мало би бути в OpenCart 3 із коробки: один модуль, всі популярні українські оплати. Дев’ять онлайн-провайдерів і чотири офлайн-способи, єдиний журнал транзакцій, окрема вкладка логів, мапа статусів замовлення і кнопка «Повернути» прямо з картки замовлення.

Головна ідея: зібрати всі оплати вашого магазину в одному модулі, який ви налаштовуєте один раз і забуваєте. Ви знаєте цей біль: 8 замовлень за ранок висять у «Очікує оплати», менеджер перемикається між п’ятьма кабінетами банків, звіряє суми, вручну міняє статуси. Клієнт пише «я оплатив, чому не бачу підтвердження?», і поки ви шукаєте його платіж, він уже пішов до конкурента. Або ви хочете додати оплату частинами Monobank, бо середній чек 8000 грн і клієнти запитують, але окремий модуль коштує як два звичайних.

PaymentHub закриває це один раз: 9 онлайн-методів плюс 4 офлайн-методи, окремий тестовий/бойовий режим на провайдер, автоматичне переведення замовлення в потрібний статус після сповіщення від банку зі звіркою суми й валюти, повернення коштів прямо з адмінки, єдиний реєстр «Транзакції» і окрема вкладка «Логи».

Що ви отримуєте, детально

Робочий чек-лист того, що ви зможете зробити у перший же день.

Що це означає простими словами

Ранок менеджера у магазину, який приймає LiqPay + Monobank + WayForPay + оплату частинами і два офлайн-способи. До PaymentHub: 12 замовлень у «Очікує оплати», по кожному він відкриває кабінет відповідного банку, шукає платіж, звіряє суму, повертається в OpenCart, руками ставить статус, пише коментар. 40 хвилин зранку, увесь час помилки і неточності. Плюс два клієнти написали «я оплатив», по кожному менеджер знову шукає в кабінеті банку. 60 хвилин зранку, і ще нічого не відвантажено.

Після PaymentHub: менеджер відкриває OpenCart, у списку замовлень бачить ті, що вже оплачені (статус проставлений автоматично, лист покупцю пішов). У «Транзакціях» шукає платежі клієнтів, які написали, за 3 секунди знаходить і повідомляє. Все, можна пакувати замовлення.

Ви підключаєте всі українські оплати в одному модулі, а не в п’яти

✓ Дев’ять онлайн-провайдерів оплати
LiqPay, LiqPay Частинами, Monobank, Monobank Покупка Частинами, WayForPay, NovaPay, ПУМБ (Visa/Mastercard), Rozetka Pay, ПриватБанк Оплата Частинами. Всі з однієї адмінки, з єдиним списком статусів. Кожен вмикається або вимикається окремим перемикачем.
⚠ Без цього: чотири окремі модулі, чотири адмінки, чотири формати логів, і жодного місця, де видно всі платежі разом.

✓ Чотири офлайн-способи оплати
100% передоплата на розрахунковий рахунок (реквізити з’являються після оформлення), оплата за реквізитами з довільним описом, післяплата з передоплатою (задаєте суму передоплати), готівка при отриманні в магазині. Для «оплати за реквізитами» банківські дані ви редагуєте прямо у налаштуваннях провайдера, вони показуються покупцю на сторінці оплати.
⚠ Без цього: клієнт після оформлення бачить порожню сторінку «оформлено», а куди платити, доводиться писати вручну в замовленні.

✓ Тестовий і бойовий режим окремо на кожен провайдер
Перевіряєте новий гейтвей, перемикаєте його одного в тестовий режим і вводите sandbox-ключі, решта модулів працюють у бойовому. Успішні тестові платежі помічаються як тестові в історії замовлення і не проводяться як реальні. Провайдери без sandbox (WayForPay, Rozetka Pay, Monobank Частинами, ПриватБанк Оплата Частинами, ПУМБ) перемикача не показують, щоб ви випадково не думали, що там є пісочниця. LiqPay при виявленому sandbox-ключі, який запущено в бойовому режимі, показує червоне попередження прямо в налаштуваннях.
⚠ Без цього: щоб протестувати новий гейтвей, доводиться «класти» всю касу магазину на день.

Оплачене замовлення саме стає оплаченим, без ручної звірки

✓ Автоматичне переведення замовлення в оплачене, зі звіркою суми
Модуль ловить сповіщення провайдера, перевіряє підпис (у кожного банку окремий алгоритм за офіційною документацією), звіряє суму і валюту з рахунком, і тільки після цього переводить замовлення у ваш налаштований статус «Оплачено». Якщо сума не збіглась, замовлення лишається у попередньому статусі, а в історію падає запис про розбіжність, щоб менеджер розібрався. Якщо покупець оплатив більше, у історію падає запис «переплата на N». Дублі сповіщень відсіюються.
⚠ Без цього: щоранку менеджер відкриває замовлення в «Очікує оплати», лізе в кабінет банку і руками перевіряє, чи прийшли гроші.

✓ Сторінка очікування, коли банк повільно відповідає
Покупець повертається з банку раніше, ніж прийшло сповіщення. Замість «замовлення оформлено» без підтвердження, PaymentHub показує проміжну сторінку «Очікуємо підтвердження оплати» з автооновленням до хвилини. Коли банк підтверджує, покупець автоматично потрапляє на сторінку «замовлення оформлено». Якщо оплата не пройшла або була скасована, покупець повертається на оформлення з підказкою спробувати ще раз, і кошик зберігається.
⚠ Без цього: покупець бачить «замовлення оформлено» ще до підтвердження і починає писати «оплатив, чому нема листа?».

✓ Мапа статусів замовлення
На кожен провайдер налаштовуєте, у який OpenCart-статус переводити замовлення при «Успіх», «Часткова оплата», «Очікує передоплату», «Отримано передоплату», «Повернуто». Можете тримати окремий статус «Оплачено Monobank» і «Оплачено LiqPay», якщо це зручно бухгалтерії, або звести все в один. Стан оплати зберігається окремо від робочого статусу замовлення магазину, щоб менеджер міг перевести замовлення в «Виконано», не втративши інформацію про оплату.
⚠ Без цього: статуси різних оплат перемішані в одному полі, бухгалтерія не розуміє, які замовлення чим оплачено.

Банк і бухгалтерія бачать ті самі товари і ту саму суму

✓ Позиції замовлення з доставкою в чеку банку
До провайдера йде не «Оплата замовлення N» одним рядком, а справжній список: товари з податком, окремі рядки на доставку і будь-які націнки з підсумків. Сума позицій завжди сходиться із сумою платежу. Якщо в замовленні є купон або від’ємні підсумки, які не розкладаються на позиції, банку йде одна безпечна строка на всю суму, щоб чек не розсинхронізувався. Це важливо для Monobank basketOrder, WayForPay і Rozetka Pay, де кабінет банку показує ці позиції в чеку.
⚠ Без цього: у чеку клієнта Monobank «Оплата замовлення 1234», а в бухгалтерії, три різні товари і доставка. Складно розбирати.

✓ Робота в магазинах з валютою не UAH
Сума в UAH, це вимога всіх українських банків. Якщо у вас магазин у USD або EUR, PaymentHub перераховує суму в гривні за курсом магазину і виставляє рахунок банку саме в UAH. У транзакціях зберігаються гривневі суми, звірка сум у сповіщенні працює коректно. Мінімальна і максимальна сума методу задаються теж у гривнях, щоб «розстрочка від 3000 грн» працювала однаково у будь-якій валюті вітрини.
⚠ Без цього: у USD-магазині Monobank отримує «100 USD» і не проводить платіж, бо очікує гривні.

Усі платежі і повернення знаходите за секунди в одній адмінці

✓ Повернення коштів прямо з картки замовлення
Клієнт повернув товар, ви відкриваєте замовлення в адмінці, тиснете «Повернути», вводите суму (частково або повністю), модуль сам звертається до API провайдера. Транзакція оновлюється, замовлення отримує статус «Повернуто» або «Часткове повернення», у історію падає запис. Працює через API у LiqPay, Monobank, WayForPay, NovaPay, Rozetka Pay і Monobank Частинами. ПриватБанк Оплата Частинами і ПУМБ не підтримують повернення через API за своєю специфікацією, там кнопка не показується, повернення робите в кабінеті банку.
⚠ Без цього: заходите в кабінет кожного банку окремо, робите повернення руками, потім переходите в OpenCart і руками пишете коментар.

✓ Єдиний реєстр транзакцій і окрема вкладка логів
Вкладка «Транзакції», одна таблиця з усіма платежами: ID, замовлення, провайдер, зовнішній ID, сума в UAH, статус, останні цифри картки, дата. Фільтри за провайдером, статусом, датою. Окрема вкладка «Логи» пише кожен запит до провайдера і кожне сповіщення з рівнем «info / warning / error» і повідомленням. Будь-який збій розбирається за хвилину, а не туром по чотирьох кабінетах банків. Кнопка «Знайти зниклі платежі» звіряє транзакції зі статусами замовлень і підказує, що потребує уваги.
⚠ Без цього: «де мій платіж від сьогодні», тур по чотирьох кабінетах банків замість одного пошуку.

Ключі банків під захистом, а товар не їде без грошей

✓ Захист секретів провайдерів
Токени, приватні ключі, merchant secret, паролі callback зберігаються шифровано. Читач-адмін (роль з правом «view» і без «modify») бачить поля секретів прихованими і не може їх змінити. Секрети з символами & < > " коректно зберігаються без ручного переналаштування. Сторінка панелі замовлення екранує все, що приходить з банку (коментарі, ідентифікатор операції, історія), щоб чужий пейлоад не потрапив у розмітку адмінки.
⚠ Без цього: приватний ключ LiqPay лежить у налаштуваннях відкритим текстом, будь-який доступ до бекапу дорівнює чужому доступу до вашої каси.

✓ Огородження ТТН: не відправляти до підтвердження оплати
Кожен спосіб оплати PaymentHub помічений як «передоплата» або «оплата після отримання». Модуль ShippingHub і будь-який інший, що робить накладну, читає цю розмітку і не дає створити накладну на непередплачене замовлення. Окремий перемикач «Контролювати банківський переказ і чек стандартного OpenCart» додає до огородження ще й стокові bank_transfer і cheque, якщо ви ними користуєтесь.
⚠ Без цього: менеджер по помилці друкує накладну на замовлення, яке ще не оплачене, товар їде без грошей.

Технічні деталі

• Дев’ять онлайн-провайдерів: LiqPay, LiqPay Частинами, Monobank, Monobank Покупка Частинами, WayForPay, NovaPay, ПУМБ, Rozetka Pay, ПриватБанк Оплата Частинами.
• Чотири офлайн-способи: 100% передоплата на рахунок, оплата за реквізитами, післяплата з передоплатою, готівка в магазині при отриманні.
• Валідація підпису сповіщення за офіційною документацією кожного банку (LiqPay, WayForPay, Rozetka Pay X-ROZETKAPAY-SIGNATURE, ПриватБанк PayParts v2, Monobank ECDSA, NovaPay RSA публічним ключем банку).
• Звірка суми і валюти при кожному сповіщенні, ідемпотентність повторних сповіщень, захист від перезапису вже оплаченого замовлення.
• Автоматична конвертація UAH при вітрині у не-UAH валюті, суми транзакцій зберігаються в UAH.
• Проміжна сторінка очікування з polling до 60 секунд (по 3 секунди), «м’який» fallback з двома кнопками, якщо банк не відповів.
• Панель замовлення в адмінці: транзакції, історія, кнопка повернення (де підтримується провайдером), внесення оплати вручну, коментарі.
• OCMOD, файлова доставка, дві таблиці в базі (транзакції і платежі по замовленнях), без сторонніх залежностей.

Працює разом з іншими модулями оформлення OcBox

Модулі розраховані на спільну роботу. ShippingHub не дає створити ТТН, поки PaymentHub не підтвердив оплату. Shipping Rules вирішує, які доставки й оплати бачить покупець. SmartOrder збирає все це на одній сторінці оформлення. При цьому кожен модуль працює і окремо, на стандартному оформленні OpenCart.

• OcBox ShippingHub: Нова Пошта, Укрпошта, Meest і Rozetka Delivery, ТТН з картки замовлення і статуси доставки без ручної роботи.
• OcBox SmartOrder: оформлення замовлення на одній сторінці, купівля в один клік, покинуті кошики.
• OcBox Shipping Rules: правила показу доставок і оплат, тарифи за вагою і сумою кошика, доплати.

Сумісність

• OpenCart 3.0.x та ocStore 3.0.x
• PHP 7.4+
• ionCube Loader: потрібен (версія 14 або вище)
• Працює з будь-яким шаблоном: модуль живе в адмінці, на оформленні інтегрується як звичайні способи оплати OpenCart.

Робочого файла модуля на форумі немає, тут описова сторінка. Кожна збірка компілюється індивідуально під ваш домен, тому доступ до завантаження надається після оплати. Напишіть в особисті повідомлення і вкажіть домен, версію PHP і версію ionCube Loader.

ionCube Loader: зверніть увагу!
Модуль закодований ionCube Encoder 15. Для роботи потрібен ionCube Loader версії 14 або вище. Якщо у вас на хостингу встановлений Loader 13.x або нижче, модуль не запуститься.

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

Продовження ліцензії на оновлення

У вартість модуля вже входить рік оновлень. Далі продовження за тією ж ціною щорічно, щоб отримувати нові версії. Якщо не продовжувати, модуль продовжує працювати як і раніше, просто без нових версій. Клієнти, які придбали до впровадження продовжень, зберігають умови на дату покупки. Продовження не включає повторну ionCube-компіляцію, установку та персональні консультації.

Регламент видачі файлів модуля

У робочі дні в робочий час файл модуля передається покупцеві протягом доби з моменту оплати, як правило менш ніж за годину. У вихідні дні та офіційні (державні) свята можливі затримки, модуль буде надісланий з настанням найближчого робочого дня. Дякуємо за розуміння.

Рекомендовані платні модулі OcBox

Smart Related $30 — пов’язані товари	SEO FAQ AI $30 — AI FAQ + Schema.org	AI Product Editor $50 — масове редагування
Image Pro $15 — WebP, водяний знак	Filter $30 — розумний фільтр + SEO	Category Manager $15 — візуальний менеджер категорій
AI Smart Search $200 — AI-пошук з синонімами	AI Chat $100 — AI-консультант 24/7	AI Photo Studio $50 — AI-обробка фото
ShippingHub $80 — хаб доставок	SmartOrder $30 — швидке замовлення	ShippingRules $30 — правила доставки
AI Megareports $20 — звіти й Telegram-дайджест	Product Bundles $30 — комплекти і набори	Simple Super Search $15 — нечіткий пошук без Sphinx

Підписуйтесь на наш канал: t.me/ocboxchannel