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.