Interkassa — приймання платежів для OpenCart 2.3, 3 і 4

Interkassa для OpenCart — модуль оплати, який приймає платежі через агрегатор Interkassa: покупець платить на захищеній сторінці sci.interkassa.com (картка, платіжні системи, термінали — усе, що ввімкнено у вашій касі), а результат повертається в магазин підписаним server-callback-ом. Модуль перевіряє підпис, ID каси й суму — і сам виставляє замовленню правильний статус, без ручної звірки з кабінетом.

У комплекті три збірки — нативна під OpenCart 4.0.2–4.1.x і окремі порти під OpenCart 3.0.2–3.0.5.0 та 2.3.0.x.

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

1. На чекауті покупець обирає «Онлайн-оплата (Interkassa)» і підтверджує замовлення.
2. Модуль збирає підписану SCI-форму (сума, валюта, номер платежу, чотири URL повернення) і відправляє покупця на сторінку оплати Interkassa.
3. Interkassa проводить платіж і надсилає магазину callback на адресу взаємодії (ik_ia_u).
4. Модуль перевіряє підпис (md5 або sha256 — як налаштовано в касі), ID каси та суму. Запит, який не збігається хоча б в одному, відхиляється з 403.
5. Замовлення отримує статус — «оплачено», «відхилено» або «очікує оплати» — за вашою мапою статусів, а повторний той самий callback не додає другий запис в історію.
6. З Pro кожен платіж лягає в журнал: статус Interkassa, сума, номер інвойса, код авторизації, ознака тестового режиму.

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

• Нативний код під OpenCart 4 — неймспейси, Twig, штатний інсталятор; для OpenCart 3 і 2.3 зібрано окремі порти, а не один архів «на всі версії».
• Секретний ключ зберігається зашифрованим (AES-256-CBC з HMAC) з прив’язкою до інсталяції — у дампі БД відкритого ключа не буде.
• Callback без валідного підпису відхиляється, як і запит із чужим ID каси чи іншою сумою — статус замовлення неможливо змінити стороннім запитом.
• Оплачене замовлення не відкочується: пізній або підроблений callback зі статусом «відхилено» не перемальовує ні замовлення, ні журнал, а повернення покупця кнопкою «Назад» не створює другий платіж на тому самому замовленні.
• М’який Pro-гейт: журнал видно завжди, але без ключа кнопка сіра — одразу зрозуміло, що саме дає ліцензія. Після завершення тріалу вимикається лише журнал, приймання оплат не зупиняється.

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

1. Розширення → Інсталятор: завантажте interkassa.ocmod.zip. Для OpenCart 3.0.x беріть interkassa-oc3.ocmod.zip із завантажень товару.
2. OpenCart 2.3: беріть interkassa-oc2.ocmod.zip і залийте вміст папки upload/ у корінь магазину по FTP/SFTP або через файловий менеджер хостингу — штатний Інсталятор 2.3 копіює файли тільки по FTP і на більшості хостингів падає з «FTP needs to be enabled in the settings». Далі — Extensions → Payments → Interkassa → «+».
3. У Розширення → Платежі знайдіть Interkassa і натисніть «Встановити», потім відкрийте налаштування.
4. Увімкніть модуль, впишіть ID каси та секретний ключ, оберіть алгоритм підпису — той самий, що стоїть у налаштуваннях каси Interkassa.
5. Скопіюйте «URL взаємодії» з налаштувань модуля і вкажіть його в кабінеті Interkassa як ik_ia_u.
6. Для першої перевірки лишіть тестовий режим — оплата піде через тестовий шлюз, реальні кошти не списуються.
7. Для Pro: натисніть «Спробувати Pro» або вставте ліцензійний ключ з email після покупки — журнал з’явиться одразу, без переустановлення.