# Плагин WooCommerce

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

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

- WordPress 6.5 или новее
- WooCommerce 8.0 или новее
- PHP 7.4 или новее с OpenSSL
- Аккаунт Paymos и выбранный в дашборде проект

Paymos PHP SDK уже включён в пакет; Composer на сервере магазина не нужен.

## 2. Установите официальный релиз

Скачайте последнюю версию на странице [Paymos WooCommerce Releases](https://github.com/paymos-labs/woocommerce/releases/latest), затем загрузите и активируйте её через **Админка WordPress → Плагины → Добавить новый → Загрузить плагин**.

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

## 3. Подключите магазин

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

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

```text
https://shop.example.com/wp-json/paymos/v1/webhook
```

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

## 4. Хранение ключей

Ключи тестового и рабочего режима проверяются и сохраняются в параметре WordPress без автоматической загрузки, с шифрованием AES-256-GCM. Ключ шифрования выводится из security salts конкретной установки WordPress. Сохранённые секреты никогда не возвращаются в браузер, их нельзя вводить или редактировать вручную. После отзыва или ротации ключа либо секрета вебхука подключите магазин заново.

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

1. Выберите **тестовый режим**, включите Paymos и оформите заказ.
2. Проверьте, что инвойс появился в выбранном проекте Paymos, а вебхук обновил заказ.
3. После проверки включите **рабочий режим**. Переустанавливать плагин не нужно.

Если статус заказа не обновляется, проверьте **WooCommerce → Статус → Логи**, публичную доступность сайта и соответствие окружения заказа выбранному режиму плагина.