Wiki · Интеграции

ЮKassa

5 мин чтенияАвтор: Дмитрий КолесниковСоавторы: Евгений Баев

ЮKassa – это сервис приёма онлайн-платежей для бизнеса, который работает через небанковскую кредитную организацию ООО НКО «ЮМани». Сайт передаёт ЮKassa сумму заказа, покупатель платит на её странице, а деньги и статус оплаты возвращаются магазину.

До 2020 года сервис назывался Яндекс.Касса. В 2020 году компания вышла из группы Яндекса, кошелёк переименовали в ЮMoney, кассу в ЮKassa, и по данным самой компании она стала частью экосистемы Сбера. Поэтому в старых модулях и инструкциях до сих пор встречается «Яндекс.Касса»: это тот же сервис.

Какие способы оплаты получает покупатель

На октябрь 2026 года ЮKassa на главной странице называет банковские карты, SberPay, СБП и T-Pay. Есть и другие способы, вплоть до покупки в кредит и оплаты частями от Сбера: их полный список и условия смотрите в документации. Важно другое: все способы подключаются одним договором и одной интеграцией. Магазину не нужно отдельно договариваться с каждым банком, как при прямом интернет-эквайринге.

Без сайта тоже можно: ЮKassa умеет выставлять счета и платёжные ссылки, которые отправляют клиенту в мессенджер или по почте.

Путь платежа от кнопки «Оплатить» до статуса заказа

Если интеграцию делают через API, сервер сайта создаёт платёж: передаёт сумму, адрес возврата и данные для чека. Запросы подписываются идентификатором магазина (shopId) и секретным ключом, поэтому отправлять их можно только с сервера, не из браузера.

Схема онлайн-платежа через ЮKassa: сервер сайта создаёт платёж, покупатель платит на странице ЮKassa, вебхук меняет статус заказа — Путь платежа через ЮKassa

ЮKassa отвечает платежом в статусе pending и ссылкой на страницу подтверждения.
Покупатель переходит туда, выбирает способ и платит. Данные карты вводятся на стороне ЮKassa, а не на вашем сайте.
Платёж переходит в статус succeeded или canceled. Сайт узнаёт об этом из HTTP-уведомления (вебхука) или запросом статуса по id платежа.
Покупатель возвращается на сайт по адресу возврата, а заказ в админке меняет статус.

Есть двухстадийная оплата: деньги сначала замораживают на счёте покупателя и списывают позже, когда товар собран. Это удобно, если наличие подтверждают вручную. Как вообще устроен обмен данными между сервисами, разобрано в статье API.

Чеки по 54-ФЗ: своя касса или сервис ЮKassa

При оплате онлайн покупатель должен получить кассовый чек. Вариантов три.

Вариант	Как работает	Кому подходит
«Чеки от ЮKassa»	ЮKassa сама регистрирует кассу, оплачивает фискальный накопитель и ОФД. Платите только за пробитые чеки.	Тем, у кого нет своей кассы
Облачная касса партнёра	Подключаете кассу партнёра, например КИТ Инвест, и прописываете её настройки в ЮKassa	Тем, кто уже работает с облачной кассой
Своя онлайн-касса	Чек пробивает касса магазина по данным заказа	Магазинам с наладженным учётом

По словам ЮKassa, её сервис чеков работает и с маркированными и подакцизными товарами. Для самозанятых есть отдельная схема: чеки формируются автоматически и уходят в «Мой налог», для подключения нужны статус самозанятого, кошелёк ЮMoney, паспорт и ИНН.

Как подключают ЮKassa к 1С-Битрикс, Tilda и WordPress

В модуле «Интернет-магазин» 1С-Битрикс обработчик ЮKassa встроен, его выбирают среди платёжных систем и вписывают данные магазина. Если нужны чеки по ФФД 1.2, передача маркировки или автоплатежи, ставят модули сторонних разработчиков из Маркетплейса Битрикс: ЮKassa сама перечисляет такие на странице интеграции, у каждого свой набор функций.

Для Tilda, WordPress, Wix и amoCRM есть готовые модули. Самописный сайт подключают через API, для серверной части у ЮKassa есть готовые SDK.

Чек-лист запуска ЮKassa на сайте: тестовая оплата, отказ, вебхук по HTTPS, чек покупателю, боевые ключи, проверка возврата — Что проверить перед запуском оплаты

Перед запуском прогоните оплату в тестовом магазине тестовыми картами. Проверьте успешный платёж и отдельно отказ: заказ не должен стать «оплаченным», если покупатель закрыл страницу. Сайт должен работать по HTTPS, иначе уведомления о платежах до него не дойдут.

Возвраты и выплаты

Возврат делают из личного кабинета или через API, целиком или частями. Частичный возврат должен быть не меньше 1 рубля, и его поддерживает не каждый способ оплаты. Деньги возвращаются только на то средство, которым платили. Срок зависит от способа: по картам эквайер может отказать в возврате платежа старше 15 месяцев. Комиссию ЮKassa за сам платёж при возврате не возвращают.

Выплаты работают в обратную сторону: сервис массовых выплат отправляет деньги людям, например оплату фрилансерам или призы в акциях.

Комиссию и тарифы смотрите на странице тарифов ЮKassa: ставка зависит от способа оплаты и выбранного решения для чеков.

Чеки, модули и возвраты при подключении

Как работает ЮKassa, когда покупатель платит на сайте?

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

Чем ЮKassa отличается от эквайринга в своём банке?

ЮKassa работает как агрегатор: одна интеграция сразу даёт карты, СБП, SberPay и другие способы, а расчётный счёт может быть в любом банке. Банковский эквайринг обычно требует счёт в этом банке, зато условия обсуждают напрямую с банком.

Сколько ЮKassa берёт за платёж?

Комиссия ЮKassa зависит от способа оплаты и решения для чеков и берётся только с успешных платежей. Ставки смотрите на странице тарифов сервиса.

Где взять shopId и секретный ключ ЮKassa для сайта?

Идентификатор магазина и секретный ключ выдаются в личном кабинете ЮKassa после подключения. Ключ вписывают только в серверные настройки модуля или кода. Если он попал в чужие руки, ключ перевыпускают, а старый отключают.

Что нужно самозанятому для приёма оплаты через ЮKassa?

Самозанятому ЮKassa предлагает отдельное подключение: понадобятся статус НПД, кошелёк ЮMoney, паспорт и ИНН. Чеки для налоговой формируются автоматически, вручную в «Мой налог» их вносить не надо.

Почему заказ на Битриксе не меняет статус после оплаты в ЮKassa?

Обычно до сайта не доходит уведомление об оплате. Проверьте адрес для уведомлений в кабинете ЮKassa, работу сайта по HTTPS, защиту от ботов, которая режет входящие запросы, и логи модуля. Ещё одна частая причина: в настройках модуля перепутаны боевой и тестовый магазин, и уведомления уходят не туда. Пока причина не найдена, сверяйте оплаты с кабинетом ЮKassa вручную, чтобы не отгрузить неоплаченный заказ.

Как сделать частичный возврат в ЮKassa?

Частичный возврат оформляют в личном кабинете или запросом к API с нужной суммой. Таких возвратов по одному платежу может быть несколько, пока их сумма не превысит платёж. Не все способы оплаты поддерживают частичный возврат.

Что изменилось для магазинов после переименования Яндекс.Кассы в ЮKassa?

Сменились название, адрес сайта и оформление страницы оплаты, а сам сервис остался тем же. Если на сайте стоит старый модуль с надписью «Яндекс.Касса», его стоит обновить: свежие версии поддерживают новые способы оплаты и форматы чеков.

Подключаем ЮKassa к сайтам на 1С-Битрикс и другим CMS: при разработке интернет-магазина и создании сайта на Аспро. Если оплата на работающем сайте сломалась, это задача для доработки сайта.

Источники