ворд-пресс.рф
Решение

Как подключить ЮKassa к WooCommerce

Подключение оплаты ЮKassa в магазине WordPress: модуль, доступы, уведомления, тестовый заказ и проверка статусов.

Опубликовано: 10.10.2026Обновлено: 11.10.2026

Для подключения ЮKassa к WooCommerce удобнее использовать официальный платёжный модуль, а не вставлять API-ключи в код темы. Сначала нужно иметь подключённый магазин в ЮKassa, затем установить модуль и выполнить тестовую оплату.

Что подготовить перед настройкой

  • Работающий сайт WordPress с WooCommerce и HTTPS.
  • Подключённый личный кабинет ЮKassa и права на управление интеграцией.
  • Резервную копию и, по возможности, тестовую копию магазина.
  • Понимание юридической модели продавца, фискализации и возвратов; эти вопросы не решаются одной установкой плагина.

Установка и соединение магазина

  1. Откройте официальную инструкцию ЮKassa для WooCommerce и перейдите по ссылке на актуальный модуль.
  2. В WordPress выберите Плагины → Добавить новый. Установите модуль из доверенного источника и активируйте его.
  3. Откройте настройки ЮKassa в WooCommerce. Названия пунктов меню могут отличаться между версиями.
  4. В актуальных версиях модуль может предлагать подключение через авторизацию магазина. Если интерфейс вашей версии запрашивает ShopID и секретный ключ, следуйте соответствующей части официальной инструкции и не размещайте секреты в публичных полях сайта.
  5. Настройте способы оплаты, указание статусов и обработку уведомлений в соответствии с доступными настройками модуля.

Проверка оплаты и статусов заказов

Перед боевым запуском пройдите полный тестовый сценарий по официальным условиям тестирования:

  1. Сформируйте заказ с тестовым товаром и правильной суммой.
  2. Перейдите на оплату, проверьте успешный и неуспешный сценарии.
  3. Посмотрите статус заказа в WooCommerce и состояние операции в ЮKassa.
  4. Проверьте работу повторных уведомлений: не должно возникать второго заказа или двойного изменения остатков.
  5. Убедитесь, что при возврате, отмене или незавершённой оплате статус магазина не выдаёт ложное «оплачено».

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

Что делать, если оплата прошла, но заказ не обновился

Проверьте журнал WooCommerce, журналы модуля и доступность обработчика уведомлений. Затем сопоставьте идентификатор платежа с заказом; не запускайте повторное списание «наугад».

Проверьте, не блокирует ли брандмауэр или кеш ответ сервера на уведомление. Временно менять правила защиты допустимо лишь после оценки рисков и на тестовой среде.

Когда нужен собственный интеграционный плагин

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

Связанные материалы: WooCommerce, каталог плагинов WooCommerce и импорт товаров.

Документация: ЮKassa — WooCommerce.

Источник: https://yookassa.ru/docs/support/payments/onboarding/integration/cms-module/woocommerce

Материал был полезен?

Помогите нам сделать материалы точнее и понятнее.