ЮKassa для WooCommerce — полная настройка приёма платежей
Если у вас WooCommerce и вы в России — Stripe и PayPal вам больше недоступны. Принимать деньги с карт, через СБП, SberPay или ЮMoney можно через ЮKassa (бывшая Яндекс.Касса). Это самый популярный платёжный агрегатор для WooCommerce в РФ: низкий порог входа, работа с самозанятыми и ИП, быстрая интеграция через штатный плагин. Настройка занимает час, включая регистрацию.
Почему ЮKassa — стандарт для WooCommerce в РФ
Альтернатив на российском рынке немного: Robokassa, CloudPayments, PayMaster. ЮKassa выигрывает за счёт:
- Готовый плагин — YooKassa для WooCommerce в официальном репозитории, обновляется
- Способы оплаты — карты Visa/Mastercard/Мир, SberPay, СБП (Система быстрых платежей), ЮMoney, наличные через терминалы
- Комиссия — от 2.8% за приём карт, 0.7% за СБП
- Юридическая простота — ИП и самозанятые подключаются без расчётного счёта
- Выплаты — на следующий день для оборота до 600 тыс., раз в неделю для больших сумм
На хостингах вроде Beget и Timeweb никаких дополнительных прав для работы ЮKassa не нужно — стандартный PHP с cURL и OpenSSL справляется.
Шаг 1. Регистрация в ЮKassa и получение ключей
Без этого шага плагин просто не запустится. Порядок действий:
- Зарегистрироваться в ЮKassa как ИП, самозанятый или юрлицо
- Дождаться проверки документов (обычно 1-2 рабочих дня)
- Зайти в личный кабинет → Настройки → Интеграция
- Скопировать
shopId(числовой идентификатор магазина) - Выпустить и скопировать секретный ключ (он показывается один раз
wp-config.php или в .env, не в открытом коде темы. Если ключ утек — отозвать его можно в том же разделе личного кабинета.
Шаг 2. Установка плагина YooKassa для WooCommerce
Плагин официальный, от самого ЮKassa. Устанавливается как любой другой:
- В админке WordPress: Плагины → Добавить новый → поиск «YooKassa для WooCommerce»
- Автор: YooMoney
- Установить → Активировать
Либо скачать с wordress.org/plugins/yookassa/ и загрузить вручную через Плагины → Загрузить.
После активации в WooCommerce → Настройки → Платежи появится новый способ оплаты «ЮKassa».
Шаг 3. Базовая настройка платёжного шлюза
Переходим: WooCommerce → Настройки → Платежи → ЮKassa → Управление.
- Включить — поставить галочку
- Заголовок — как будет отображаться в корзине: «Оплата картой онлайн» или «ЮKassa (карты, СБП, SberPay)»
- shopId — вставить из личного кабинета ЮKassa
- Секретный ключ — вставить (не перепутайте: ключ для API, не пароль от кабинета)
- Способы оплаты — отметить нужные: банковские карты, SberPay, СБП, ЮMoney, наличные
- Тестовый режим — включить для отладки (выключить перед запуском)
На сервере должен работать cURL и OpenSSL — проверьте через WooCommerce → Статус → Сервер. На Beget эти модули включены по умолчанию, на Timeweb тоже.
Шаг 4. Настройка уведомлений (webhook)
ЮKassa должна знать, что заказ оплачен. Это происходит через HTTP-уведомления (webhook).
- В личном кабинете ЮKassa: Настройки → Уведомления → HTTP-уведомления
- URL уведомления:
https://вашсайт.ru/?wc-api=wc_yookassa - Обязательно HTTPS — ЮKassa не отправляет данные на HTTP
- Используйте секретный ключ (тот же, что в плагине) для проверки подписей
Плагин YooKassa регистрирует свой обработчик автоматически, но URL в личном кабинете нужно указать руками. Если ошибиться в URL — заказы будут висеть в статусе «Ожидание оплаты» вечно.
Шаг 5. Тестовый заказ
Перед приёмом реальных денег — прогоните тест. Включите тестовый режим в настройках плагина и сделайте заказ на 1 рубль через карту. Тестовые карты ЮKassa:
- Успешная оплата: 5555 5555 5555 5555, любой срок/код
- Отказ: 5555 5555 5555 5556
- Ошибка проверки 3D Secure: 5555 5555 5555 5557
Проверьте, что после оплаты заказ переходит в статус «Обрабатывается» или «Завершён». Если статус не меняется — проблема в webhook: проверьте URL и доступность сайта извне (не заблокирован ли доступ к /?wc-api=wc_yookassa).
Шаг 6. Выключение тестового режима и боевой запуск
Когда тест пройден:
- В настройках плагина выключить тестовый режим
- Проверить, что в статусе магазина ЮKassa всё зелёное
- Сделать реальный заказ на 10 рублей на свою же карту
- Убедиться, что деньги пришли на счёт в ЮKassa (баланс в личном кабинете)
api.yookassa.ru. На Beget и Timeweb таких проблем нет.
Когда настройка не сработает
- Не отображается в корзине — плагин не активирован или конфликтует с кэшем. Очистите кэш и проверьте WooCommerce → Статус.
- Ошибка «Неверный ключ» — перевыпустите секретный ключ в личном кабинете ЮKassa и обновите в настройках плагина.
- Статус заказа не меняется после оплаты — webhook не доходит. Проверьте URL в личном кабинете, включите логгирование WooCommerce: Логи →
wp-content/uploads/wc-logs/yookassa-*.log. - SSL-сертификат — если сайт на HTTP, ЮKassa не отправит уведомление. Бесплатный Let's Encrypt решает проблему, но на Reg.ru иногда нужен платный сертификат для проверки домена (см. статью про SSL-сертификаты в России).
Частые вопросы
Вывод
ЮKassa — самый простой способ принимать платежи на WooCommerce в России. Регистрация, плагин, ключи — и через час у вас работающий приём карт, СБП и SberPay. Если что-то пошло не так — проверьте webhook и тестовый режим, логи WooCommerce обычно сразу показывают проблему.
Не забудьте отключить тестовый режим перед запуском — были случаи, когда магазин неделю работал в тесте, а клиенты не могли оплатить.
Нужно настроить ЮKassa или другой платёжный шлюз?
Подключу приём платежей под ключ — от регистрации до тестовой оплаты.
