Как добавить новый способ оплаты в OpenCart

Интеграция с новой — платёжной системой или создание кастомного способа оплаты — стандартная задача при разработке OpenCart. Разберём, как создать модуль оплаты с нуля.

Структура модуля оплаты

upload/
├── catalog/
│   ├── controller/extension/payment/mypayment.php
│   ├── model/extension/payment/mypayment.php
│   └── view/theme/default/template/extension/payment/mypayment.twig
└── admin/
    ├── controller/extension/payment/mypayment.php
    ├── model/extension/payment/mypayment.php
    ├── language/ru-ru/extension/payment/mypayment.php
    └── view/theme/default/template/extension/payment/mypayment.twig

Основные методы модели

Модель должна содержать метод getMethod, который возвращает информацию о способе оплаты:

$this->load->model('extension/payment/mypayment');
$method_data = $this->model_extension_payment_mypayment->getMethod($address);
// $method_data содержит: code, title, terms, sort_order

Рекомендации из практики

Как лучше: Подключайте платёжные шлюзы через модуль-агрегатор (ЮKassa, Tinkoff, СБП). Один модуль — несколько способов оплаты для покупателя.

Как не делать: Не подключайте платежи напрямую через API каждого банка. Агрегатор проще в интеграции, обновлении и отчётности.

Кейс из практики: Подключили СБП через агрегатор. Покупатель выбирает оплату по QR-коду — деньги поступают мгновенно, комиссия 0.4-0.7% вместо 2-3% за карты. Магазин экономит 30 000 руб. в месяц на комиссиях.

По практике, настройка платёжной системы — закажите доработку OpenCart. Закажите доработку OpenCart

Обработка callback

После оплаты платёжная система отправляет уведомление на URL callback. Контроллер должен принять запрос, проверить подпись, обновить статус заказа и вернуть подтверждение.

$order_id = $this->request->post['order_id'];
$this->load->model('checkout/order');
$this->model_checkout_order->addOrderHistory($order_id, $this->config->get('payment_mypayment_order_status_id'));

FAQ

Како

Безопасность callback. При обработке уведомления от платёжной системы всегда проверяйте: (1) подпись запроса (обычно HMAC-SHA256 или MD5 с солью), (2) что заказ с указанным ID существует, (3) что статус заказа ещё не был изменён (идемпотентность). Игнорирование хотя бы одного из этих пунктов — потенциальная дыра в безопасности.

Тестирование. После настройки модуля обязательно проведите тест: создайте заказ в sandbox-режиме, проверьте callback, убедитесь, что статус заказа изменился корректно. После этого отмените платёж и проверьте, что обработка отмены тоже работает — не все разработчики реализуют отмену, и это может привести к ошибкам учёта.

минимальный набор файлов нужен?

Контроллер (catalog + admin) и модель (catalog + admin). Без модели модуль не будет виден в списке способов оплаты.

Как протестировать модуль перед запуском?

Используйте тестовый режим платёжной системы (sandbox). Сделайте тестовый платёж и проверьте, что статус заказа меняется корректно.

Итог

Создание модуля оплаты — это контроллер, модель и обработка callback. Минимум 4 файла, максимум — интеграция с любым платёжным шлюзом.

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

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