Przelewy24 & BLIK Payments для OpenCart — оплата переводом, картой и BLIK в Польше

Przelewy24 & BLIK Payments для OpenCart — модуль оплаты для польского рынка. Покупатель платит банковским переводом, картой или BLIK через Przelewy24, а заказ в магазине подтверждается сам. Модуль работает на Przelewy24 REST API v1 и не верит на слово ни возврату покупателя, ни уведомлению: оплата зачисляется только после проверки подписи и запроса transaction/verify, как того требует Przelewy24. Три сборки — для OpenCart 4.x, 3.x и 2.3.

Что нужно от вас. Аккаунт продавца в Przelewy24 — merchant ID, ключ CRC и API-ключ выдаёт Przelewy24 после регистрации магазина. Валюта заказа — PLN, либо EUR и другие валюты, если их принимает ваш аккаунт. BLIK-код прямо в чекауте (Pro) работает, только если Przelewy24 включил для вашего аккаунта эту услугу; иначе BLIK идёт через страницу Przelewy24. Модуль написан по официальной спецификации Przelewy24 REST API и проверен на тестовых магазинах с имитацией ответов Przelewy24 — первый платёж советуем провести в sandbox вашего аккаунта.

Как это выглядит для покупателя

Без Pro покупатель после подтверждения заказа попадает на страницу Przelewy24, выбирает банк, карту или BLIK и возвращается в магазин. Данные карты и банка через ваш сайт не проходят. Если покупатель закрыл вкладку и не вернулся, заказ всё равно станет оплаченным — по уведомлению от Przelewy24.

Страница возврата с Przelewy24 не запускает OpenCart, поэтому покупатель не теряет сессию даже при строгих настройках cookie (SameSite=Strict на OpenCart 4). Как только Przelewy24 подтверждает оплату, покупатель видит обычную страницу «Заказ оформлен», корзина пуста.

Что получает админ

• Merchant ID, POS ID, ключ CRC и API-ключ — всё, что нужно для старта. Где их взять в панели Przelewy24, подсказано прямо под полями.
• Sandbox с отдельными ключами. Один переключатель переводит магазин в sandbox Przelewy24; настоящие деньги там не двигаются.
• «Check connection» — модуль делает запрос к Przelewy24 вашими ключами и говорит, приняты ли они. Ошибку в ключе вы увидите в админке, а не от покупателя.
• Адрес для уведомлений передаётся в Przelewy24 с каждым платежом — в панели Przelewy24 ничего вписывать не нужно.
• Методы на странице Przelewy24 (карты, переводы, BLIK, рассрочка, кошельки), язык страницы оплаты, время на оплату и режим «ждать результата» — на ваш выбор.
• Статусы: ожидает оплаты, оплачен, требует проверки, полностью возвращён. Плюс геозона и порядок сортировки.
• История заказа: номер транзакции Przelewy24, сумма, возвраты, предупреждение о второй оплате или расхождении суммы.
• Журнал отладки: коды и подписи замаскированы.

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

1. Покупатель в чекауте выбирает Przelewy24. С Pro и включённым BLIK — вводит 6-значный BLIK-код прямо в чекауте или жмёт «Other methods» для перевода или карты. Работает в стандартном чекауте и в One Page Checkout.
2. Модуль регистрирует транзакцию в Przelewy24 (transaction/register) с уникальным номером сессии, суммой и валютой заказа и подписью SHA-384 на ключе CRC. Сумма берётся из строки «Итого» — с купонами, доставкой и опциями товара.
3. Покупатель платит на странице Przelewy24. Для BLIK-кода в чекауте (Pro) модуль передаёт код в Przelewy24 (paymentMethod/blik/chargeByCode), а покупатель подтверждает оплату в приложении банка.
4. Уведомление приходит на адрес магазина. Модуль проверяет подпись SHA-384 и сумму. Подделать оплату, отправив POST на сайт, не получится — такой запрос получает отказ.
5. Подтверждение. Модуль вызывает transaction/verify — без этого Przelewy24 не зачисляет деньги продавцу. Только после успешного verify заказ становится оплаченным.
6. Возврат покупателя — не доказательство оплаты. Страница ожидания сама спрашивает Przelewy24 о статусе и переходит на «Заказ оформлен», как только оплата подтверждена.
7. Сверка суммы. Если оплачена не та сумма, что в заказе, модуль не подтверждает платёж и ставит статус «требует проверки» с пояснением в истории.
8. Отмена. Покупатель отменил оплату — видит кнопки «I have paid» и «Try to pay again». Новая попытка получает новую сессию; поздняя оплата старой попытки тоже не потеряется.
9. С Pro можно вернуть деньги из журнала платежей (transaction/refund) — полностью или частями; результат от Przelewy24 записывается в историю заказа.

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

• Подпись проверяется по-настоящему. SHA-384 от полей уведомления и вашего ключа CRC, плюс совпадение суммы с сессией заказа. Неподписанное или чужое уведомление отклоняется, повторное — ничего не меняет.
• transaction/verify обязателен. Заказ не становится оплаченным, пока Przelewy24 не подтвердил verify.
• Каждая попытка — отдельная сессия Przelewy24. Если покупатель оплатил старую попытку уже после новой, модуль найдёт и её; вторая оплата уже оплаченного заказа отмечается в истории, чтобы менеджер вернул одну из них.
• OpenCart 4: повторная попытка оплачивает тот же заказ. OpenCart 3 и 2.3: заказ появляется в списке только после подтверждения Przelewy24, поэтому брошенные попытки не засоряют админку.
• Свои таблицы для сессий и возвратов. При удалении модуля они сознательно остаются — журнал и возвраты доступны после переустановки.
• Ключ CRC и API-ключ хранятся в базе зашифрованными (AES-256 + HMAC) и не попадают в лог.
• Без правок ядра и без OCMOD-модификаций: обычное платёжное расширение OpenCart.
• Pro-гейт без «кирпича»: когда триал закончился, останавливаются только Pro-функции, а приём оплаты работает дальше.

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

1. OpenCart 4: Extensions → Installer → загрузите cc_przelewy.ocmod.zip (имя архива не меняйте) и нажмите «Install». OpenCart 3: Extensions → Installer → cc_przelewy24-oc3.ocmod.zip. OpenCart 2.3: залейте содержимое папки upload/ из cc_przelewy24-oc23.ocmod.zip в корень магазина (FTP или файловый менеджер хостинга).
2. Extensions → Extensions → Payments → Przelewy24 + BLIK (CatCode) → «Install», затем «Edit».
3. Включите Sandbox, впишите merchant ID и ключи sandbox-аккаунта, сохраните и нажмите «Check connection».
4. Добавьте в магазин валюту PLN (если её ещё нет) и проведите тестовый заказ в sandbox.
5. Впишите боевые ключи и выключите Sandbox.
6. Для Pro: «Try Pro» → e-mail для триала или ключ после покупки. Переключатель «BLIK code at checkout» — после того, как Przelewy24 включит сервис BLIK-кода.