Ищете крутые кейсы в digital? Посмотрите на номинантов Workspace Digital Awards 2026!
Веб-разработка

Как подключить ЮКассу к WordPress и другим CMS

5 
 
Как подключить ЮКассу к WordPress и другим CMS

Большинство людей думают, что подключить платёжную систему к сайту это задача для разработчика, которая стоит денег и занимает недели. На самом деле для 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


Разместите
тендер бесплатно

Наша система сама подберет вам исполнителей на услуги, связанные с разработкой сайта или приложения, поисковой оптимизацией, контекстной рекламой, маркетингом, SMM и PR.

Заполнить заявку 13470 тендеров
проведено за восемь лет работы нашего сайта.


Это нужно для автоматического обновления статуса заказа при оплате

Без webhook заказы не будут автоматически переходить в статус «Оплачен». Это обязательный шаг.

Для лендинга без магазина: как принимать оплату без WooCommerce

WooCommerce это решение для полноценного магазина с каталогом, корзиной и оформлением заказа. Но что если у вас лендинг с одним продуктом или услугой, и вам нужна просто кнопка «Оплатить»?

Здесь три подхода в зависимости от ситуации.

Подход первый - плагин формы оплаты

Для WordPress существуют плагины, которые добавляют форму оплаты без полноценного магазина. Один из них YooMoney для WordPress (отличается от WooCommerce-версии). Он добавляет шорткод, который вставляется на любую страницу:

[yoomoney_form sum="1000" desc="Оплата консультации"]

Покупатель видит форму, вводит данные, оплачивает. Без корзины, без каталога. Подходит для консультаций, курсов, разовых услуг.

Подход второй - ссылка на оплату из личного кабинета

В личном кабинете ЮКассы есть инструмент «Платёжная ссылка». Вы создаёте ссылку с указанием суммы и описания и вставляете её в кнопку на сайте. Никаких плагинов, никакой разработки. Ограничение: ссылка статическая, сумма фиксированная.

Для динамических сумм (когда покупатель сам вводит сумму например, пожертвование или частичная оплата) - нужен либо плагин, либо минимальная разработка.

Подход третий - виджет ЮКассы

ЮКасса предоставляет готовый JavaScript-виджет, который встраивается в любую страницу парой строк кода. Не нужен WordPress, не нужен плагин, только хостинг и возможность добавить JS на страницу.

html

<script src="https://yookassa.ru/checkout-widget/v1/checkout-widget.js"></script>

Это чуть сложнее, чем плагин, но даёт максимальную гибкость. Разработчик настраивает это за день.

Подключение к другим CMS: краткий гайд

WordPress - самая популярная платформа, но не единственная. Вот как обстоят дела с другими.

Bitrix и Bitrix24

Официальный модуль ЮКассы для Bitrix доступен в Маркетплейсе 1С-Битрикс. Установка аналогична WordPress: скачать, установить, ввести ключи. Особенность Bitrix - более сложная настройка фискализации из-за гибкой системы налогов. Рекомендуется привлечь разработчика для настройки чеков, если работаете с разными категориями товаров.

OpenCart

Официальный модуль есть в каталоге OpenCart и на сайте ЮКассы. Поддерживает OpenCart 2.x и 3.x. Установка через Extension Installer в админке. Настройка ключей - аналогично WordPress. Фискализация поддерживается.

PrestaShop

Модуль доступен в официальном магазине PrestaShop Addons. Менее распространён в России, но полностью функционален. Для версий 1.6 и 1.7 отдельные версии модуля, убедитесь, что скачиваете правильную.

Joomla + VirtueMart

Менее популярная связка, но плагин существует. Доступен на 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 и ЮКассы - проверьте, работает ли оплата. Если да, то включайте плагины по одному, пока не найдёте конфликтующий. Для плагинов кеширования добавьте страницы корзины и оформления заказа в список исключений.

Итог

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

Выскажите мнение
Авторизуйтесь, чтобы добавить свой комментарий.




5

Лучшие статьи

Поделиться: 0 0 0
Лайки за кейсы:  0 Подписчики:  0

Оцените статью
Спасибо за оценку