Онлайн-касса в OpenCart: подключение на примере магазина

В магазине на OpenCart покупатель оплатил заказ, а чек не пришёл: платёжный модуль отметил заказ как оплаченный, но кассовый сервис о нём ничего не узнал. Чтобы этого не произошло, нужно связать три части — OpenCart, платёжный сервис и онлайн-кассу — и проверить, как они обмениваются статусами. Ниже — практический сценарий для тестового заказа; конкретные пункты меню зависят от версии OpenCart и выбранного модуля.

Сначала определите, кто будет пробивать чек

В этом примере магазин на OpenCart продаёт товары онлайн, принимает оплату через платёжный сервис и использует отдельную облачную кассу. Это не инструкция к конкретному оператору: у разных провайдеров отличаются личный кабинет, модуль и названия настроек. Цель — настроить поток событий так, чтобы касса получила данные об оплате, а магазин сохранил результат фискализации.

До настройки выясните у поставщика кассового решения:

• есть ли готовое расширение именно для вашей ветки OpenCart — например, 3.x или 4.x;
• какие платёжные сервисы и сценарии оплаты оно поддерживает;
• что происходит при частичной оплате, возврате и отмене заказа;
• где посмотреть ошибки обмена и повторно отправить событие;
• как проверить работу без реального списания денег.

Если в документации написано просто «поддерживается OpenCart», попросите уточнить версию и конкретные ограничения. Совместимость с одной веткой не гарантирует работу с другой: у расширений могут различаться структура и установка.

Три способа связать магазин и кассу

Для обычного магазина начните с первых двух вариантов. Сам факт, что модуль установлен, ещё не подтверждает, что чек формируется после успешной оплаты: расширение может отправлять заказ при другом статусе или не учитывать особенности платёжного модуля.

Проверяйте не наличие кнопки «касса подключена», а полный путь одного тестового заказа: от оплаты до сохранённого результата фискализации.

Настройка на тестовом заказе

Сценарий ниже подходит для магазина, в котором уже настроен способ оплаты, а поставщик кассы выдал инструкции и доступы. Названия полей и порядок экранов намеренно не универсальны: ориентируйтесь на документацию конкретного расширения. Перед изменениями сделайте резервную копию файлов и базы данных.

1. Сверьте версии. Запишите версию OpenCart из панели администратора и найдите в документации модуля точный список поддерживаемых версий. Проверьте также требования к PHP и зависимостям, если поставщик их публикует. Проверка: ваша связка явно указана как поддерживаемая, а не только названа «совместимой с OpenCart».
2. Установите расширение по инструкции его поставщика. Не загружайте модуль, предназначенный для другой ветки OpenCart, и не переносите файлы вручную по совету из случайного форума. Сначала повторите установку на копии магазина или тестовом стенде. Проверка: расширение появилось в панели и не вызвало ошибок загрузки страниц администратора и витрины.
3. Свяжите магазин с кассовым сервисом. Введите только выданные провайдером параметры доступа и выберите нужное окружение, если сервис разделяет тестовый и боевой режимы. Секретные значения не вставляйте в тикеты и публичные инструкции; ограничьте доступ к панели тем, кому он необходим. Проверка: модуль сохраняет настройки, а его журнал не сообщает об ошибке авторизации или соединения.
4. Сопоставьте оплату и статус заказа. Уточните, какое событие запускает передачу данных: создание заказа, подтверждение оплаты или смена статуса. Для сценария с оплатой через платёжный сервис обычно важно проверить именно подтверждённый платёж, а не только заполненную корзину. Не выбирайте статус наугад: сверьтесь с документацией обоих модулей. Проверка: неоплаченный заказ не запускает нежелательное действие, а тестовый оплаченный доходит до кассового сервиса.
5. Проверьте состав данных. Сопоставьте товары, количество, стоимость, скидку и доставку с тем, что кассовый сервис ожидает получить. Правила обработки отдельных позиций и платежей зависят от конфигурации магазина и требований к расчётам — их нужно сверить с поставщиком кассы. Проверка: в тестовом результате нет потерянных позиций, неверной суммы или пустых обязательных полей.
6. Пройдите полный тестовый сценарий. Создайте тестовый заказ, проведите оплату предусмотренным для теста способом и проверьте результат в панели магазина, платёжном сервисе и кассовом кабинете. Отдельно протестируйте отмену или возврат, если такой сценарий есть в магазине. Проверка: статусы согласованы, в журнале нет необъяснённых ошибок, результат операции виден в кассовом сервисе.

Что чаще всего ломается

Заказ есть, чека нет

Частая причина — модуль слушает не тот статус или ждёт подтверждения, которое платёжное расширение не передаёт. Сравните историю статусов заказа с журналом кассового модуля и документацией платёжного сервиса. Не исправляйте проблему простым переводом всех заказов в один статус: так можно запустить нежелательные повторные операции.

Чек отправляется дважды

Такое возможно, если одно событие обрабатывают два расширения или повторная отправка не учитывает уже созданный результат. Проверьте, не включена ли параллельно касса внутри платёжного сервиса и отдельный модуль OpenCart. Затем уточните у поставщика, как его интеграция защищает повторную обработку одного заказа.

Модуль установлен, но панель выдаёт ошибку

Причина может быть в несовпадении версии OpenCart, PHP или зависимостей, а не в кассовом сервисе. Сохраните точный текст ошибки и записи журнала, сравните требования модуля с сервером. Не публикуйте вместе с логами ключи доступа и другие секреты.

Как выбрать подход и не усложнить поддержку

Для стандартной оплаты начните с готового решения, которое поставщик прямо поддерживает для вашей версии OpenCart и платёжного сценария. Если магазин использует нестандартные статусы, частичные оплаты или собственную логику возвратов, сначала проверьте эти случаи на тестовом стенде. Индивидуальная разработка оправдана, когда готовый модуль не покрывает конкретное требование, а не просто потому, что его настройки незнакомы.

После запуска следите за долей заказов, у которых магазин показывает оплату, но кассовый сервис не подтверждает результат. Сверяйте такие расхождения по журналам обеих систем и предусмотрите ручную проверку ошибок. Время хранения журналов и механизм повторной отправки зависят от конкретного расширения — выясните их до запуска, а не после первого потерянного события.

Что делать дальше

Составьте таблицу связки «версия OpenCart — версия платёжного модуля — версия кассового расширения» и подтвердите её у поставщиков. Затем прогоните на копии магазина как минимум успешную оплату, отмену и возврат, если магазин их поддерживает. Когда тесты пройдут, перенесите настройки на рабочий сайт и в первые дни регулярно сверяйте статусы заказов с кассовым кабинетом.

Фискализация — регистрация сведений о расчёте через кассовую систему с формированием фискального документа; конкретный порядок зависит от применимых требований и настроек продавца.