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

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

Как это работает — шаг за шагом

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

Что под капотом

• Нативная сборка для OpenCart 4.x — неймспейсы, Twig-шаблоны, штатный инсталлятор. Для OpenCart 3.x и 2.3 — отдельные порты, а не «условно совместимый» код.
• Secret key не лежит в БД открытым текстом — хранится зашифрованным (AES-256-CBC + HMAC) с ключом, привязанным к конкретной установке, поэтому обычный дамп базы ключ не отдаст.
• Каждый вебхук проверяется: HMAC-MD5 подпись плюс сверка суммы — подделать «успешную оплату» запросом извне не выйдет.
• Pro-гейт мягкий: без ключа после триала отключаются только Pro-функции, а бесплатный приём оплаты работает дальше.

Как установить

1. В админке OpenCart откройте Расширения → Инсталлятор и загрузите wayforpay.ocmod.zip. Для OpenCart 3.0.x используйте сборку wayforpay-oc3-1.1.3.ocmod.zip, для OpenCart 2.3 — wayforpay-oc2-1.1.3.ocmod.zip из загрузок товара (в 2.3 содержимое папки upload/ заливается в корень магазина по SFTP, потому что штатный инсталлятор этой версии копирует файлы только через FTP).
2. Перейдите в Расширения → Платежи, найдите WayForPay и нажмите «Установить».
3. В настройках включите модуль. Для проверки оставьте тестовый режим — оплата пойдёт через публичный тестовый мерчант, реальные средства не списываются.
4. Для боевого режима впишите merchant login и secret key из кабинета WayForPay.
5. Для Pro: вставьте лицензионный ключ из email после оплаты — расширенные функции включатся без переустановки.