Перейти к содержимому

Плагины

На странице

Плагин WooCommerce

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

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

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

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

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

Скачайте последнюю версию на странице Paymos WooCommerce Releases, затем загрузите и активируйте её через Админка WordPress → Плагины → Добавить новый → Загрузить плагин.

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

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

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

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

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

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

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

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

5. Тест и запуск в продакшн

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

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

Тестирование вебхуков Плагин WHMCS