Interkassa — приём платежей для OpenCart 2.3, 3.x и 4.x

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 после покупки — журнал появится сразу, без переустановки.