Юкасса остаётся самым предсказуемым способом принять оплату в WooCommerce без прямых переговоров с эквайрингом банка: карта, СБП, рассрочка и кошелёк ЮMoney работают через одну интеграцию. Подключаю Юкассу в WooCommerce почти на каждом магазине, который делаю на WordPress, и в статье показываю весь путь: от получения shopId в личном кабинете до тестового режима и чеков по 54-ФЗ, а также разбираю ошибки, из-за которых заказы зависают в статусе «Ожидает оплаты» даже после успешного списания денег.
Что нужно для подключения Юкассы к WooCommerce
Прежде чем идти в личный кабинет Юкассы, проверяю три вещи на самом сайте. Первое: рабочий WooCommerce с настроенным каталогом, валютой и хотя бы одним способом доставки, иначе тестировать оплату не на чем. Второе: SSL-сертификат. Юкасса отправляет уведомления об оплате на сайт по https, и без действующего сертификата вебхук просто не пройдёт, поэтому это не тот пункт, который можно отложить на потом. Третье: юридический статус. Подключить эквайринг может ИП, ООО или самозанятый с расчётным счётом, физлицо без такого статуса подключить не получится.
Заявку на подключение подаю в личном кабинете Юкассы на yookassa.ru. Юкасса проверяет документы бизнеса, и на практике эта проверка занимает от одного до трёх рабочих дней. После одобрения в кабинете появляются shopId и секретный ключ магазина, без них плагин работать не будет.
Установка и настройка плагина Юкассы для WooCommerce
В личном кабинете Юкассы в разделе интеграций есть готовый плагин для WooCommerce, его можно скачать оттуда либо найти в каталоге плагинов WordPress по названию магазина. Ставлю его как обычный плагин: «Плагины» → «Добавить новый» → «Загрузить архив» либо через поиск, если он уже опубликован в каталоге вашей версии WordPress. После активации способ оплаты появляется в WooCommerce → «Настройки» → «Платежи», включаю его и перехожу в настройки.
Где взять shopId и секретный ключ
shopId и секретный ключ хранятся в личном кабинете Юкассы, в разделе с настройками магазина. Пар ключей две: тестовая и боевая, у каждой свой набор значений. Копирую нужную пару в соответствующие поля плагина и не путаю их местами, иначе оплата будет падать с ошибкой авторизации.
Способы оплаты и валюта
В настройках плагина отмечаю, какие способы оплаты показывать покупателю: банковские карты, СБП, ЮMoney, SberPay, рассрочку, набор зависит от того, что подключено в личном кабинете Юкассы. Валюта заказа в WooCommerce должна совпадать с валютой, указанной при регистрации магазина, иначе платёж отклоняется ещё на уровне API, до формы оплаты дело не доходит.
Отдельно прохожу в мастере настройки модуля вкладку «Уведомления». Переносить адрес в личный кабинет Юкассы руками не нужно, в инструкции этот шаг описан одной строкой: «Вкладка «Уведомления». Ссылка для уведомления появится здесь автоматически. Нажмите «Сохранить и продолжить»». Именно по этому адресу Юкасса сообщает сайту об оплате, и если шаг не сохранён, заказ останется в статусе «Ожидает оплаты», даже если деньги с карты покупателя уже списались.
Бесплатный материал
🎁 Полезный скрипт в подарок
Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.
Без спама. Отписка в 1 клик.
Тестовый режим Юкассы: как проверить оплату без реальных денег
В настройках плагина есть переключатель тестового режима, он использует отдельную пару shopId и секретного ключа от тестового магазина в личном кабинете. В этом режиме оформляю заказ и оплачиваю его тестовой картой из документации Юкассы, такие карты не списывают реальные деньги и позволяют прогнать весь сценарий целиком: от оформления заказа до смены статуса на «Оплачен».
После тестовой оплаты проверяю три вещи. Пришло ли уведомление на сайт: в WooCommerce → «Статус» → «Журналы» должна появиться запись от Юкассы. Сменился ли статус заказа автоматически, без ручного вмешательства. Пришло ли письмо покупателю о принятой оплате. Если любой из этих пунктов не срабатывает в тестовом режиме, в боевом магазине будет то же самое, только уже с реальными деньгами клиентов.
Типичная ошибка на этом этапе, забыть переключить магазин обратно в боевой режим перед запуском. Перед тем как объявить магазин готовым к приёму денег, сверяю shopId в настройках плагина с тем, что в личном кабинете помечен как боевой, а не тестовый.
Чеки по 54-ФЗ: как Юкасса печатает чек за заказ WooCommerce
Юкасса работает по 54-ФЗ по одной из двух схем. Агентская: Юкасса сама пробивает чек через свою онлайн-кассу за отдельную комиссию, и вам не нужно покупать и обслуживать собственную кассу. Своя касса: вы подключаете отдельную онлайн-кассу, а Юкасса передаёт ей данные заказа для формирования чека. Какая схема доступна, зависит от тарифа, который вам согласовали при подключении, это видно в личном кабинете.
Налоговые параметры настраиваются там же: система налогообложения и ставка НДС по умолчанию. Для корректного чека у каждого товара в WooCommerce должно быть читаемое название и правильная ставка НДС в настройках налогов WooCommerce, плагин передаёт эти данные построчно вместе с заказом. Если чек не формируется, чаще всего причина в том, что у товара не указана ставка НДС или доставка добавлена в заказ без отдельной строки, которую можно превратить в позицию чека.
Частые ошибки при подключении эквайринга Юкассы к WooCommerce
SSL-сертификат просрочен или выпущен неправильно, из-за чего Юкасса не может достучаться до сайта по https, а WooCommerce молча остаётся в статусе ожидания. Хостинг блокирует входящие запросы от незнакомых IP: на части бюджетных тарифов такое встречается, и тогда стоит уточнить у поддержки хостинга, не попадают ли запросы от серверов Юкассы под ограничения файрвола. Перепутаны тестовые и боевые ключи в настройках плагина, тогда боевая оплата падает с ошибкой авторизации, хотя тестовая до этого работала без проблем. Валюта заказа не совпадает с валютой, указанной при регистрации магазина в Юкассе.
Если по итогу выясняется, что дело не в паре настроек, а логику заказов, доставки и оплаты нужно перестраивать целиком, проще сразу заказать разработку интернет-магазина под ключ, где приём платежей, чеки и статусы заказов настраиваются как одна согласованная система, а не набор точечных патчей поверх старой структуры.
Юкасса и другие способы приёма платежей в WooCommerce
Юкасса не единственный вариант подключить эквайринг к WooCommerce, и при выборе я обычно сравниваю его с банковским эквайрингом и с ручным приёмом оплаты по реквизитам.
| Способ приёма оплаты | СБП | Нужна отдельная касса | Кому подходит |
|---|---|---|---|
| Юкасса | есть | опционально, можно по агентской схеме | большинству интернет-магазинов на WooCommerce |
| Эквайринг банка (например, T‑Bank для WooCommerce) | есть | нет, касса банка входит в тариф эквайринга | тем, у кого уже открыт счёт и эквайринг именно в этом банке |
| Оплата по реквизитам вручную | нет | нужна касса и ручное закрытие чеков | разовым продажам, для регулярного магазина не подходит |
Комиссия за приём платежей в обоих случаях зависит от тарифа, который вам согласует банк или Юкасса при подключении, поэтому за точной цифрой смотрю в личный кабинет конкретного проекта, а не в общие обзоры в интернете.
Условия и возможности ЮKassa меняются, поэтому перед запуском я уточняю их у самого сервиса.
Частые вопросы
Можно ли подключить Юкассу к WooCommerce без регистрации ИП или ООО?
Нет. Юкасса проверяет документы бизнеса перед подключением, нужен статус ИП, ООО или самозанятого с расчётным счётом или доступным для приёма платежей счётом. Для физлица без такого статуса подключение эквайринга недоступно.
Почему WooCommerce не меняет статус заказа после успешной оплаты?
Чаще всего причина в том, что уведомление от Юкассы не доходит до сайта: проверяю, что вкладка «Уведомления» в настройках модуля сохранена и ссылка в ней подставилась, действительность SSL-сертификата и логи WooCommerce в разделе «Статус» → «Журналы», там видно, приходил ли запрос вообще и с какой ошибкой.
Нужна ли отдельная онлайн-касса, если уже подключена Юкасса?
Зависит от схемы. По агентской схеме Юкасса пробивает чек через свою кассу сама, отдельная касса не нужна. По схеме со своей кассой Юкасса только передаёт данные заказа, а печатает чек уже подключённая вами касса, и её нужно покупать и обслуживать отдельно.
Сколько занимает подключение Юкассы к WooCommerce на практике?
Сама установка и настройка плагина занимает один-два часа при уже готовом SSL-сертификате. Проверка документов в личном кабинете Юкассы обычно идёт от одного до трёх рабочих дней, так что на весь процесс закладываю минимум три-четыре дня, а не один вечер.