Docs
API ЮKassa
Старые версии API
Помощь
Подключить ЮKassa

Настройка платёжного плагина ЮKassa для сайта на WooCommerce

Установка плагина
Скачайте плагин ЮKassa
Если не получилось скачать по ссылке, найдите плагин «ЮKassa для WooCommerce» в панели управления сайтом: Плагины → Добавить новый
Настройка приёма платежей
В панели управления сайтом нажмите WooCommerce → Настройки ЮKassa.
Вкладка «Авторизация»
Если у вас новая версия модуля (начиная с 2.3.0)
  1. Если магазин ещё не подключён, нажмите на Подключить магазин.
    Если магазин подключён и вы хотите его поменять, нажмите Сменить магазин.
  2. Откроется всплывающее окно. Если не открылось, возможно, браузер его заблокировал — разрешите открывать всплывающие окна на этом сайте.
  3. Разрешите выдать доступ к ЮKassa.
  4. Выберите магазин, который хотите подключить.
  5. Введите код из смс → всплывающее окно закроется, появятся данные по подключённому магазину. Если появилась ошибка, просто закройте её — страница перезагрузится и можно будет начать заново.
Если у вас более поздняя версия модуля (2.2.5 и старше)
  1. Подключите ЮKassa
  2. Для подключения магазина вам нужны параметры:
    • ShopID — появится в личном кабинете ЮKassa сразу после подключения,
    • cекретный ключ — нужно выпустить в личном кабинете ЮKassa в разделе Интеграция → Ключи API → Секретный ключ.
  3. Заполните поля ShopID и Секретный ключ.
  4. Нажмите «Сохранить и продолжить».
Вкладка «Настройки оплаты»
Выбран сценарий оплаты «Умный платёж»
В этом случае покупатель увидит все способы оплаты, которые вы подключили в ЮKassa. При оплате он перенаправится на страницу ЮKassa, где выберет способ оплаты и введет платежные данные.
Выбран сценарий оплаты «Виджет ЮKassa»
В этом случае пользователь выбирает способ оплаты в платёжной форме, которая встроена на ваш сайт. Переходить на страницу ЮKassa для оплаты не нужно.
«Отложенные платежи»
Если включить, платежи будут проходить в два этапа: сначала деньги заблокируются на счёте покупателя, а уже после вашего подтверждения — спишутся.
Подтвердить или отменить платёж нужно за определённое время, которое зависит от способа оплаты — если ничего не сделать, деньги разблокируются и вернутся на счёт покупателя
СберБанк Бизнес Онлайн
Включите, если хотите принимать платежи от юрлиц через СББОЛ.
Покупатель нажмёт кнопку на вашем сайте и перейдёт к оплате счёта. Сразу после оплаты вам придёт сообщение — значит, можно отгружать товары.
Вкладка «Доп.функции»
В поле с описанием платежа отображается текст, который покупатель увидит на странице оплаты. Вы можете изменить это поле или оставить как есть. Список возможных значений для подстановки — в документации WooCommerce
Укажите страницы, которые увидят ваши покупатели при успешной оплате или ошибке. Если подходящих страниц нет, их нужно создать.
Вкладка «54-ФЗ»
Если вы работаете с онлайн-кассой одного из партнёров ЮKassa, включите отправку данных в ЮKassa. Выберите статус (ИП или Самозанятый) и настройте данные для чеков.
Если выбран статус «ИП»
  • «Ставка НДС по умолчанию» будет в чеке у товаров, для которых вы не указывали НДС раньше.
  • Ставки, которые уже есть в вашем магазине, нужно сопоставить со ставками в ЮKassa.
  • Предмет и способ расчета — признаки, которые нужно передавать в чеках. Настройте значения для ваших товаров.
Что такое «Предмет и способ расчёта»
Чтобы фискальные документы соответствовали ФФД 1.05, настройте Предмет расчёта и Способ расчёта. Предмет расчёта — это категория товаров и услуг, которые вы продаете (товар, услуга, ставка в игре и т.д.).
Способ расчёта — это категория способа, которым вы принимаете оплату (оплата в кредит, предоплата, полный расчёт и т.д.).
Значения этих параметров берутся из атрибутов товара «Признак предмета расчёта» и «Признак способа расчёта».
Для товаров, у которых значения этих атрибутов не заданы, подставляются значения из блока «Предмет расчёта и способ расчёта (ФФД 1.05)». Если потребуется, значения можно задать отдельно для каждого товара (в карточке товара).
Маркировка товара
Чтобы указать маркировку товара, включите эту опцию в настройках модуля ЮKassa (вкладка «Чеки»). Так как маркировка товара передаётся во втором чеке, опция «Формировать второй чек» автоматически станет активна. После сохранения настроек можно переходить к добавлению маркировки.
Как добавить товар с маркировкой
  1. Откройте вкладку Товары → Добавить товар. Введите название товара.
  2. Прокрутите страницу вниз до раздела Данные товара и перейдите во вкладку Маркировка.
  3. Выберите категорию товара и единицу измерения. Если вы продаёте товары упаковками, укажите количество единиц в одной упаковке. Тогда при маркировке вы сможете просто отсканировать один товар несколько раз, вместо того чтобы сканировать каждую единицу по отдельности (например, вместо сканирования 30 пробников духов вы сможете провести 1 пробник 30 раз).
  4. Справа на странице нажмите Опубликовать.
Теперь когда покупатель оформит заказ, в карточке заказа будет доступен специальный раздел для ввода маркировки.
На всякий случай: если вы добавляли товары до того, как появилась опция маркировки, просто отредактируйте их — добавлять заново не нужно.
Как указать маркировку товара в заказе
  1. Зайдите в раздел Заказы и выберите заказ со статусом Обработка.
  2. Откроется страница с перечнем товаров. Найдите товары, которые нужно промаркировать — они отображаются со значком +.
  3. Кликните по значку + — откроется карточка маркировки. Теперь нажмите на поле для ввода маркировки.
  4. Отсканируйте маркировку с упаковки товара. Перед этим убедитесь, что на вашем устройстве включена английская раскладка клавиатуры — иначе сканер может распознать код с ошибками.
  5. Нажмите Сохранить. Если все данные в карточке маркировки заполнены правильно, вместо значка + появится зелёный логотип «Честного знака».
  6. Готово — «Честный знак» выведет товар из оборота после отправки второго чека.
На всякий случай: пожалуйста, заполняйте все поля в карточке маркировки — за продажу товара без маркировки можно получить штраф.
Если что-то не получается, напишите нам на cms@yoomoney.ru — мы поможем во всём разобраться.
Что такое «Второй чек»
Нужно формировать два чека, если клиент вносит предоплату и только потом получает товар или услугу. Первый чек — когда деньги поступают вам на счёт, второй — при отгрузке товаров или выполнении услуг. В первом чеке в «признаке способа расчёта» передаётся «полная предоплата». Во втором — указывается «полный расчёт».
Когда вы настроили всё в блоке 54-ФЗ, можно перейти ко второму чеку. Если включить эту опцию, модуль будет формировать второй (закрывающий) чек. Это произойдет автоматически, если в заказе есть позиции с полной предоплатой, и этот заказ перешел в выбранный статус. Например, «завершён».
В истории заказа появится запись об отправке второго чека.
Если выбран статус «Самозанятый»
Вкладка «Настройка уведомлений»
Ссылка для уведомления появится здесь автоматически. Нажмите «Сохранить и продолжить».
Вкладка «Готово»
Если все все остальные параметры настроены, появится сообщение об успехе.
Включение способов оплаты в WooCommerce
По умолчанию у вас будут включены базовые способы оплаты, которые доступны в WooCommerce: банковские карты, ЮMoney, SberPay и наличные через терминалы. Чтобы включить или отключить некоторые способы, нажмите WooCommerce → Настройки → Платежи.
На этой странице можно поменять порядок отображения способов оплаты: просто перетаскивайте их в таблице. Или выключить ненужные способы.
Использование виджета
Виджет позволяет принимать платежи прямо на вашем сайте — без отправки покупателя на страницу ЮKassa. В виджете можно принимать платежи банковской картой, кошельком ЮMoney и через SberPay.
Чтобы использовать виджет, зайдите в «WooCommerce — Настройки — Платежи» и выберите метод оплаты «Платежный виджет ЮKassa».
Использование отложенной оплаты (предавторизации)
Если включить, платежи будут проходить в два этапа: сначала деньги заблокируются на счёте покупателя, а уже после вашего подтверждения — спишутся.
Подтвердить или отменить платёж нужно за определённое время, которое зависит от способа оплаты — если ничего не сделать, деньги разблокируются и вернутся на счёт покупателя.
Как включить отложенную оплату
Перейдите в WooCommerce → Настройки ЮKassa → Способы оплаты. В блоке «Отложенные платежи» нажмите Вкл → Сохранить и продолжить.
Когда включите опцию, все заказы, оплаченные картой или кошельком, по умолчанию переходят в статус «На удержании» (on-hold) и остаются в нём до подтверждения/отмены платежа или пока не закончится срок удержания. В истории заказа при поступлении платежа появляется запись: «Поступил новый платёж. Он ожидает подтверждения до {дата и время}, после чего автоматически отменится».
Как подтвердить платёж
Перейдите в карточку заказа, в выпадающем меню «Статус» выберите статус «Обработка» («Processing») и нажмите кнопку «Обновить».
Перед подтверждением платежа вы можете отредактировать содержимое заказа: удалить позиции или изменить их количество. Когда вы подтверждаете платёж частично, оставшаяся часть денег возвращается покупателю.
Как отменить платеж
Зайдите в карточку заказа, в выпадающем меню «Статус» выберите «Отменен» (Canceled) и нажмите кнопку «Обновить». Результат запишется в историю заказа. Если отменить не получилось, попробуйте ещё раз.
Сохранение платёжных данных
Покупатели могут сохранять данные банковских карт и кошельков на вашем сайте. При следующей оплате они смогут выбрать сохраненный метод оплаты и не вводить данные заново.
Как подключить опцию:
  1. Напишите своему менеджеру в ЮKassa, что хотите подключить эту опцию.
  2. Дождитесь ответа менеджера и включите опцию в настройках модуля. В панели управления сайтом нажмите WooCommerce → Настройки → Платежи.
  3. В списке методов оплаты зайдите в Банковские карты или Кошелёк ЮMoney и поставьте галочку «Сохранять платёжный метод».
Как сохранение платёжных данных работает для покупателя
  1. Чтобы сохранить карту или кошелек, покупатель должен быть зарегистрирован на сайте.
  2. Есть два способа сохранить данные: ввести в личном кабинете или запомнить при оплате.
  3. При следующей оплате сайт предложит использовать новую карту, выбрать из сохраненных или сохранить метод оплаты.
  4. Сохраненные карты и кошельки покупатель может удалить в личном кабинете. (Это будет выглядеть примерно так:)
Использование B2B-платежей
Решение позволяет принимать онлайн-платежи от юридических лиц, у которых есть счёт в СберБанке.
  1. Чтобы B2B-платежи заработали, включите эту опцию в настройках модуля.
  2. После каждой оплаты через B2B-платежи ЮKassa формирует платежное поручение, в котором указано назначение платежа. Если нужно, вы можете изменить шаблон.
  3. Укажите налоговую ставку по умолчанию: она будет передаваться в Сбербанк Бизнес Онлайн, если в карточке товара не указана другая ставка.

    При оплате через Сбербанк Бизнес Онлайн есть ограничение: в одном заказе могут быть только товары с одинаковой ставкой НДС. Если клиент положит в корзину товары с разными ставками, мы покажем ему сообщение, что оплатить их одним чеком не получится.

  4. Сопоставьте ставки НДС в вашем магазине со ставками, которые будут передаваться в Сбербанк Бизнес Онлайн.
  5. Не забудьте сохранить изменения.
    При оплате через Сбербанк Бизнес Онлайн информация о плательщике записывается в историю заказа.
«Покупки в кредит» от СберБанка
В этот способ оплаты входит кредит и рассрочка. Если покупатель платит в рассрочку, в модуле может отображаться неверная сумма покупки (верная будет в личном кабинете ЮKassa). На покупателя это никак не повлияет — он всегда оплатит верную сумму. Чтобы суммы не расходились, настройте модуль по инструкции ниже.
Почему сумма в модуле отображается неправильно
Это значит, что вы настроили один или несколько параметров так:
  • Для одной из налоговых ставок указано значение Сложение.
  • В налоге указано, что он действует на доставку, но для самой доставки не выбран статус налога Налогооблагаемый.
  • На товар или доставку действует больше одного налога.
Как настроить модуль, чтобы сумма отображалась правильно
  1. В панели управления сайтом перейдите в раздел WooCommerce → Настройки → Основные. Поставьте галочку напротив Включить налоговые ставки и расчёты.
  2. Зайдите в раздел WooCommerce → Настройки → Налог. Настройте, как будут применяться налоги.
  3. Откройте раздел WooCommerce → Настройки ЮKassa. Настройте модуль ЮKassa для WooCommerce в зависимости от ваших параметров:
    • Если указаны свои налоговые ставки — перейдите в раздел Чеки → Сопоставьте ставки. Затем напротив каждой ставки укажите правильную.
    • Если налоговые ставки не указаны вообще — перейдите в раздел Чеки → Ставка НДС по умолчанию. Затем настройте модуль в соответствии с налоговой политикой.
  4. В разделе WooCommerce → Настройки → Налог создайте налоги, которые вам нужны.
  5. Для каждого товара укажите статус налога Налогооблагаемый и налоговый класс Стандарт. Ставки Reduced Rate и Zero Rate работают как обычные налоги — они различаются в дальнейших выгрузках отчётности, но на суммы не влияют.
  6. Если вы указали, что налог действует и на доставку — перейдите в раздел WooCommerce → Настройки → Доставка. Затем укажите статус налога Налогооблагаемый.
  7. Готово, теперь сумма покупки в модуле и в личном кабинете ЮKassa должна совпадать.
Если нужно сделать возврат
Сделать полноценный возврат из модуля не получится. Если сделать возврат из личного кабинета ЮKassa, статус в модуле также автоматически не изменится.
Чтобы после возврата из личного кабинета ЮKassa сумма покупки в модуле отображалась правильно, оформите возврат вручную — нажмите на кнопку Refund и укажите сумму возврата.
Важно: если в модуле изменить статус на Refunded, то скидка посчитается дважды и суммы будут разные.
Если отменить платёж в статусе «На удержании» (on-hold)
Сумма покупки в модуле не пересчитается — и всегда будет отличаться от суммы в личном кабинете ЮKassa.
Платежи по подписке (через WooCommerce Subscription)
Вы можете подключить платежи по подписке (рекуррентные платежи): заданная сумма будет списываться с банковской карты или кошелька ЮMoney вашего клиента с определённой периодичностью, например, 1-го числа каждого месяца. Для этого установите плагин WooCommerce Subscriptions; ЮKassa поддерживает работу с ним. Подробнее о платежах по подписке на сайте ЮKassa
О том, как создать и настроить подписку, можно прочитать в руководстве от разработчиков WooCommerce Subscriptions (текст на английском языке).
Важно: не забудьте добавить на свой сайт инструкцию по отмене подписки. Моменты, которые нужно учесть, описаны в документации WooCommerce Subscription (текст на английском языке).
© 2025, ООО НКО «ЮМани»