WayForPay — оплата карткою для OpenCart 2.3, 3.x і 4.x

WayForPay для OpenCart — платіжне розширення, що під’єднує еквайринг WayForPay до магазину на OpenCart 3.x або 4.x. Покупець оплачує карткою Visa чи Mastercard на захищеній сторінці WayForPay, а далі все автоматично: WayForPay надсилає serviceUrl-вебхук, модуль перевіряє HMAC-MD5 підпис і сам змінює статус замовлення. Менеджеру не треба щоранку звіряти оплати в кабінеті банку з замовленнями в адмінці.

Базова версія — безкоштовна. Скачати з офіційного OpenCart marketplace: opencart.com/…/extension_id=48711. Ліцензійний ключ Pro розблоковує журнал платежів зі звіркою статусів, двоетапну оплату AUTH/SETTLE та часткові й повторні повернення коштів з адмінки.

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

1. Покупець на чекауті обирає «Оплата карткою (WayForPay)» і підтверджує замовлення.
2. Модуль формує підписаний запит і перенаправляє покупця на захищену сторінку оплати WayForPay — дані картки ваш сервер не бачить.
3. WayForPay проводить оплату і надсилає на магазин підписаний serviceUrl-вебхук.
4. Модуль звіряє HMAC-MD5 підпис і суму — замовлення автоматично отримує потрібний статус в OpenCart.
5. Коли покупець повертається на сайт, статус додатково перевіряється запитом CHECK_STATUS — замовлення не закриється «оплаченим», якщо гроші реально не пройшли.
6. З Pro: у журналі платежів видно кожну транзакцію — статус, суму, масковану картку, orderReference — і звідти ж робляться повернення.

Скільки коштує

1 490 грн — разова покупка. Ліцензія безстрокова: платите один раз, оновлення й технічна підтримка входять у ціну. Один ключ — один домен і його піддомени.

Переносите магазин на інший домен — деактивуйте ліцензію на старому й активуйте на новому самостійно в кабінеті.

Ліцензія безстрокова — нічого не спливає і не вимикається. Один ключ — один домен; переносите магазин — деактивуйте ліцензію на старому домені й активуйте на новому самостійно.

Один ключ — один домен. Переносите магазин — деактивуйте ліцензію на старому домені й активуйте на новому самостійно, без звернення до підтримки.

Спершу тріал, потім оплата. Свіжий інстал — це безкоштовна версія: Pro сам не вмикається і нічого не гасне через тиждень. Коли захочете подивитись Pro — натисніть «Спробувати Pro» в налаштуваннях модуля, вкажіть email і отримайте ключ на 7 днів (він же прийде листом). Тож журнал платежів, AUTH/SETTLE і повернення ви перевіряєте на власному магазині ще до покупки — саме тому повернення коштів після оплати не передбачене.

Технічні вимоги

• OpenCart 4.0.2 – 4.1.x (нативна збірка) або OpenCart 3.0.2 – 3.0.5.0 (окрема збірка в комплекті)
• PHP 8.0+
• Merchant login і secret key з кабінету WayForPay — лише для бойового режиму; тестовий працює одразу без договору

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

• Нативна збірка для OpenCart 4.x — неймспейси, Twig-шаблони, штатний інсталятор. Для OpenCart 3.x — окремий порт, а не «умовно сумісний» код.
• Secret key не лежить у БД відкритим текстом — зберігається обфускованим з прив’язкою до конкретної інсталяції, тож звичайний дамп бази ключа не віддасть.
• Кожен вебхук перевіряється: HMAC-MD5 підпис плюс звірка суми — підробити «успішну оплату» запитом ззовні не вийде.
• Pro-гейт м’який: без ключа після тріалу зупиняються лише оновлення й нові функції, а Pro-функції продовжують працювати, а безкоштовне приймання оплати працює далі.

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

1. В адмінці OpenCart відкрийте Розширення → Інсталятор і завантажте wayforpay.ocmod.zip. Для OpenCart 3.0.x використовуйте збірку wayforpay-oc3.ocmod.zip із завантажень товару.
2. Перейдіть у Розширення → Платежі, знайдіть WayForPay і натисніть «Встановити».
3. У налаштуваннях увімкніть модуль. Для перевірки лишіть тестовий режим — оплата піде через публічний тестовий мерчант, реальні кошти не списуються.
4. Для бойового режиму впишіть merchant login і secret key з кабінету WayForPay.
5. Для Pro: вставте ліцензійний ключ з email після оплати — розширені функції увімкнуться без переустановлення.

Історія версій

1.1.1 — 14 серпня 2026 (збірки OpenCart 3.x і 2.3)

Повернення з адмінки в цих двох збірках нарешті працює як задумано. Раніше «-500» у полі суми мовчки повертало всю суму замовлення, а в збірці для OpenCart 3 повернення взагалі падало з помилкою і кнопка нічого не робила. Тепер порожнє поле = повне повернення, будь-яке інше значення має бути числом більше нуля і не більшим за залишок; часткові повернення рахуються накопичувально й показані окремою колонкою «Повернено» в журналі, а замовлення переходить у статус «Повернено» лише коли повернуто всю суму. Заразом виправлено підпис до операції капчури в двоетапному режимі: у історію замовлення більше не потрапляє службовий текст замість людського.

1.0.6 — 2 серпня 2026

Виправлено недоплату: колбек на суму, меншу за замовлення, більше не зберігається як Approved — раніше це назавжди блокувало наступну повну оплату, бо Approved є фінальним станом. Тепер замовлення лишається неоплаченим із поміткою про недоплату, а повна оплата проходить нормально. Ліцензія переживає недоступність catcode.com.ua: мережева помилка більше не вважається відповіддю «ключ недійсний», тож Pro не гасне під час збою (14-денний пільговий період нарешті працює). Часткові повернення в журналі рахуються накопичувально. Тріал стартує лише вашим кліком, свіжий інстал — чиста безкоштовна версія.

1.0.2 — 23 липня 2026

Виправлено конфлікт при оформленні замовлення на OpenCart 4.0.2.x: перевірка гео-зони більше не завантажує відсутню в цій версії каталогу модель і не блокує вибір способу оплати чи доставки.

1.0.0 — липень 2026

Перший публічний реліз: оплата карткою через захищену сторінку WayForPay, serviceUrl-вебхук з перевіркою HMAC-MD5 підпису, CHECK_STATUS-звірка на поверненні, тестовий режим на публічному мерчанті; Pro — журнал платежів, AUTH/SETTLE, повні й часткові повернення. Дві збірки: OpenCart 4.0.2–4.1.x і 3.0.2–3.0.5.0.