На странице
Плагин Shopware 6
Установите плагин Paymos для Shopware 6, включите его в канале продаж, проверьте подписанные статусы и смените режим без переустановки.
1. Требования
- Shopware 6.5 или 6.6 и PHP 8.2+
- Аккаунт Paymos и выбранный в дашборде проект
- Официальный пакет со страницы GitHub Releases
Официальный пакет одинаков для всех мерчантов и не содержит API-ключей, API-секретов, ID проекта, секретов вебхуков, OAuth token или device code.
2. Установка
Загрузите и активируйте расширение, обновите Administration assets по правилам вашей установки, откройте «Настройки → Расширения → Paymos» и нажмите «Подключить Paymos».
3. Подключение
- Откройте в дашборде Paymos проект, который хотите подключить. Плагин автоматически использует текущий проект и больше не предлагает выбирать его.
- Нажмите Подключить Paymos в Shopware 6.
- Подтвердите показанные URL магазина и текущий проект в Paymos. Второго выбора проекта нет.
- Вернитесь в CMS после появления статуса подключения.
Для тестового и рабочего режима Paymos использует один активный платёжный ключ мерчанта или создаёт его при первом подключении. Вебхук счетов используется повторно только при полном совпадении адреса и проекта; при отличиях создаётся отдельный вебхук. Существующая конфигурация с тем же адресом не перезаписывается:
https://your-store.example/paymos/webhook
OAuth device authorization используется только для одноразовой доставки ключей. Короткоживущий token удаляется; рабочие запросы Merchant API продолжают подписываться HMAC.
4. Хранение секретов
Ключи и временный device state хранятся в Shopware SystemConfigService в AES-256-GCM envelope от kernel.secret. Сохранённые секреты не возвращаются в страницу администрирования.
5. Тест и запуск в продакшн
Выберите тестовый режим, оформите заказ и проверьте счёт и обновление статуса по вебхуку. Затем включите рабочий режим в той же установке. Повторное подключение требуется только после смены адреса магазина, отзыва платёжного ключа или ротации секрета вебхука.