Как подключить ЮКассу к WordPress и другим CMS
Сегодня разбираем это подключение пошагово. Плюс разбираем типичные ошибки и как их избежать.
Почему ЮКасса
ЮКасса (бывшая Яндекс.Касса) — это крупнейший платёжный агрегатор России. По последним данным, через неё работает более 100 000 интернет-магазинов и сервисов. Вот три причины, по которым ЮКасса это разумный выбор для малого бизнеса на своей CMS.
Первая — готовые плагины для всех популярных платформ. WordPress, Bitrix, OpenCart, PrestaShop, Joomla — официальные плагины есть для всех. Это значит, что вам не нужно разбираться в API и писать код.
Вторая — нет ежемесячной абонентской платы. Комиссия только с транзакций 2.8–3.5% в зависимости от оборота. Для бизнеса, который только запускается, это важно: вы платите только тогда, когда зарабатываете.
Третья — полная поддержка 54-ФЗ и онлайн-кассы. Фискализация настраивается прямо в плагине без отдельных решений и интеграций.
Рыночный контекст: в 2024–2025 году количество сайтов на WordPress в России, подключивших ЮКассу, выросло значительно, отчасти потому что часть бизнесов переходит с конструкторов (Тильда, Wix) на собственный хостинг.
Причины: снижение затрат, больше контроля над сайтом, отсутствие зависимости от платформы.
Что нужно до начала: чеклист
Прежде чем открывать WordPress убедитесь, что у вас есть всё необходимое.
Первое — зарегистрированный аккаунт в ЮКасса. Регистрация на yookassa.ru, занимает 10–15 минут. Нужны: ИНН, данные организации или ИП (для юрлиц), или данные самозанятого. После регистрации — верификация, которая занимает от нескольких часов до 1–2 рабочих дней.
Второе — shopId и секретный ключ. После верификации в личном кабинете ЮКасса, в разделе «Интеграция» → «Ключи API» вы получите два значения: shopId (публичный идентификатор магазина) и секретный ключ. Они понадобятся при настройке плагина. Запишите их, секретный ключ показывается один раз.
Третье — SSL-сертификат на сайте. ЮКасса работает только с сайтами по HTTPS. Если ваш сайт ещё на HTTP, то сначала установите SSL. В большинстве хостингов это делается в один клик через панель управления (Let’s Encrypt — бесплатно).
Четвёртое — актуальная версия WordPress и WooCommerce. Плагин ЮКассы требует WooCommerce — основной плагин для интернет-магазинов на WordPress. Если у вас сайт-визитка без магазина и вы хотите добавить просто форму оплаты, то это другой сценарий, разберём отдельно.
Инструкция для WordPress + WooCommerce
Установите WooCommerce, если ещё не установлен.
Панель WordPress → Плагины → Добавить новый
Поиск: WooCommerce → Установить → Активировать
Пройдите мастер настройки: валюта (рубль), страна, базовые данные магазина
Установите официальный плагин ЮКассы
Плагины → Добавить новый → поиск: YooKassa
Найдите плагин «YooKassa для WooCommerce» — официальный, от команды ЮКассы
Нажмите Установить, затем Активировать
Введите ключи из личного кабинета ЮКассы
WooCommerce → Настройки → Оплата → YooKassa
Введите shopId из раздела «Интеграция» личного кабинета ЮКассы
Введите Секретный ключ — там же, кнопка «Создать ключ»
shopId: 123456 (пример) Секретный ключ: test_AbCdEf... (тестовый) / live_AbCdEf... (рабочий)
Начните с тестового ключа — он позволяет проверить оплату без реальных денег. Рабочий ключ подключайте после успешного теста.
В настройках плагина включите нужные методы: банковские карты, СБП, ЮMoney, рассрочка
СБП (оплата по QR) — обязательно включите: комиссия 0.4–0.7%, растущий спрос
Рассрочка «Сплит» — включайте если средний чек выше 3 000 ₽, увеличивает конверсию
Настройте название и описание способа оплаты — это видит покупатель при оформлении
Настройте фискализацию (54-ФЗ)
Если вы ИП или ООО — фискализация обязательна по закону
В настройках плагина раздел «Чеки» → включите отправку чеков
Укажите систему налогообложения (УСН, ОСН и т.д.)
Для каждого типа товара настройте НДС и признак предмета расчёта (товар, услуга, цифровой продукт)
Самозанятые не обязаны выдавать кассовые чеки через ЮКассу они формируют чеки в приложении «Мой налог». Уточните свой статус.
Убедитесь, что активен тестовый ключ
Добавьте любой товар в корзину и пройдите оформление до оплаты
Тестовая карта для проверки: 4111 1111 1111 1111, любой CVV, любая дата в будущем
Убедитесь что статус заказа в WooCommerce изменился на «В обработке»
После успешного теста замените тестовый ключ на боевой в настройках плагина. Всё — ваш магазин принимает реальные платежи.
Настройте уведомления и webhook
В личном кабинете ЮКассы → Интеграция → HTTP-уведомления
Укажите URL для уведомлений — плагин показывает его в настройках
https://ваш-сайт.ru/?wc-api=wc_yookassa
Это нужно для автоматического обновления статуса заказа при оплате
Без webhook заказы не будут автоматически переходить в статус «Оплачен». Это обязательный шаг.
Для лендинга без магазина: как принимать оплату без WooCommerce
WooCommerce это решение для полноценного магазина с каталогом, корзиной и оформлением заказа. Но что если у вас лендинг с одним продуктом или услугой, и вам нужна просто кнопка «Оплатить»?
Здесь три подхода в зависимости от ситуации.
Подход первый — плагин формы оплаты
Для WordPress существуют плагины, которые добавляют форму оплаты без полноценного магазина. Один из них YooMoney для WordPress (отличается от WooCommerce-версии). Он добавляет шорткод, который вставляется на любую страницу:
[yoomoney_form sum="1000″ desc="Оплата консультации"]
Покупатель видит форму, вводит данные, оплачивает. Без корзины, без каталога. Подходит для консультаций, курсов, разовых услуг.
Подход второй — ссылка на оплату из личного кабинета
В личном кабинете ЮКассы есть инструмент «Платёжная ссылка». Вы создаёте ссылку с указанием суммы и описания и вставляете её в кнопку на сайте. Никаких плагинов, никакой разработки. Ограничение: ссылка статическая, сумма фиксированная.
Для динамических сумм (когда покупатель сам вводит сумму например, пожертвование или частичная оплата) — нужен либо плагин, либо минимальная разработка.
ЮКасса предоставляет готовый JavaScript-виджет, который встраивается в любую страницу парой строк кода. Не нужен WordPress, не нужен плагин, только хостинг и возможность добавить JS на страницу.
Это чуть сложнее, чем плагин, но даёт максимальную гибкость. Разработчик настраивает это за день.
Подключение к другим CMS: краткий гайд
WordPress — самая популярная платформа, но не единственная. Вот как обстоят дела с другими.
Официальный модуль ЮКассы для Bitrix доступен в Маркетплейсе 1С-Битрикс. Установка аналогична WordPress: скачать, установить, ввести ключи. Особенность Bitrix — более сложная настройка фискализации из-за гибкой системы налогов. Рекомендуется привлечь разработчика для настройки чеков, если работаете с разными категориями товаров.
Официальный модуль есть в каталоге OpenCart и на сайте ЮКассы. Поддерживает OpenCart 2.x и 3.x. Установка через Extension Installer в админке. Настройка ключей — аналогично WordPress. Фискализация поддерживается.
Модуль доступен в официальном магазине PrestaShop Addons. Менее распространён в России, но полностью функционален. Для версий 1.6 и 1.7 отдельные версии модуля, убедитесь, что скачиваете правильную.
Менее популярная связка, но плагин существует. Доступен на GitHub официального репозитория ЮКассы. Установка через менеджер расширений Joomla.
Самописный сайт или нестандартная платформа
Здесь единственный вариант — интеграция через API. ЮКасса имеет REST API с хорошей документацией на developers.yookassa.ru. Базовая интеграция (создание платежа, получение статуса, обработка webhook) — это работа для разработчика на 2-3 дня в зависимости от сложности.
Типичные ошибки при подключении: что идёт не так
За время работы с клиентами я видел одни и те же ошибки. Разберём их, чтобы вы их не повторили.
Ошибка первая — перепутали тестовый и рабочий ключ
Симптом: платежи проходят, но деньги не поступают на счёт. Причина: включён тестовый ключ, который имитирует платежи без реального движения денег.
Решение: в настройках плагина убедитесь, что используется рабочий ключ (начинается с live_, а не test_). И убедитесь, что в личном кабинете ЮКассы магазин верифицирован и переведён в рабочий режим.
Ошибка вторая — не настроен webhook
Симптом: покупатель оплатил, но заказ в WooCommerce остаётся в статусе «Ожидание оплаты».
Причина: ЮКасса не может уведомить ваш сайт об успешной оплате, потому что webhook URL не указан или указан неверно.
Решение: в личном кабинете ЮКассы → Интеграция → HTTP-уведомления укажите правильный URL. Для WooCommerce это https://ваш-сайт.ru/?wc-api=wc_yookassa. Убедитесь, что URL доступен извне (не закрыт файрволом или htpasswd).
Ошибка третья — SSL не настроен или самоподписанный
Симптом: при попытке оплаты ЮКасса выдаёт ошибку или не открывается страница оплаты.
Причина: ЮКасса требует валидный SSL-сертификат. Самоподписанный сертификат или просроченный не принимается.
Решение: установите бесплатный Let’s Encrypt через панель хостинга. Certbot автоматически обновляет его каждые 90 дней.
Ошибка четвёртая — неправильные настройки фискализации
Симптом: платежи проходят, но чеки не отправляются покупателям или отправляются с ошибками.
Причина: неверно указана система налогообложения, тип товара или ставка НДС.
Решение: в настройках плагина раздел «Чеки» — проверьте каждый параметр. Если не уверены в налоговых настройках, то проконсультируйтесь с бухгалтером. Неверная фискализация — это административная ответственность.
Ошибка пятая — конфликт плагинов
Симптом: страница оплаты не загружается, кнопка «Оплатить» не работает, JS-ошибки в консоли браузера.
Причина: другой плагин на сайте конфликтует с плагином ЮКассы, чаще всего это плагины кеширования (WP Rocket, W3 Total Cache) или оптимизации JavaScript.
Решение: временно отключите все плагины кроме WooCommerce и ЮКассы — проверьте, работает ли оплата. Если да, то включайте плагины по одному, пока не найдёте конфликтующий. Для плагинов кеширования добавьте страницы корзины и оформления заказа в список исключений.