# Плагин OpenCart

> Установите официальное расширение Paymos для OpenCart, подключите магазин без копирования секретов и проверьте статусы в тестовом режиме.

## 1. Требования

- OpenCart 4.0.2.0 или новее и публичный HTTPS Store URL
- Аккаунт Paymos и выбранный в дашборде проект
- Официальный пакет со страницы [GitHub Releases](https://github.com/paymos-labs/opencart/releases/latest)

Официальный пакет одинаков для всех мерчантов и не содержит API-ключей, API-секретов, ID проекта, секретов вебхуков, токенов OAuth и кодов устройства.

## 2. Установка

Загрузите релиз .ocmod.zip через установщик расширений, установите Paymos в «Расширения → Платежи», откройте настройки и нажмите «Подключить Paymos».

На OpenCart до 4.0.2.0 установка не пройдёт: расширение сразу удалится, а причина появится в журнале ошибок OpenCart.

## 3. Подключение

1. Откройте в дашборде Paymos проект, который хотите подключить. Плагин автоматически использует текущий проект и больше не предлагает выбирать его.
2. Нажмите **Подключить Paymos** в OpenCart.
3. Подтвердите показанные URL магазина и текущий проект в Paymos. Второго выбора проекта нет.
4. Вернитесь в CMS после появления статуса подключения.

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

```text
https://your-store.example/index.php?route=extension/paymos/payment/paymos.callback
```

Авторизация устройства по OAuth нужна только для одноразовой передачи ключей. Короткоживущий токен удаляется; рабочие запросы Merchant API продолжают подписываться HMAC.

## 4. Хранение секретов

Ключи и временное состояние устройства хранятся в настройке OpenCart, зашифрованной AES-256-GCM; ключ шифрования выводится из config_encryption. Сохранённые секреты не возвращаются в страницу администрирования.

## 5. Тест и переход в рабочий режим

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