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-коду.