YooKassa: подключение к сайту, виджет, API, СБП и чеки 54‑ФЗ

Что такое YooKassa и кому подходит

YooKassa (ЮKassa) — один из самых известных провайдеров онлайн‑платежей в РФ. Он позволяет интернет‑магазинам и сервисам принимать оплату банковскими картами, через СБП, кошелёк ЮMoney и другие банковские методы в едином интерфейсе. Для малого бизнеса это быстрый старт без глубоких доработок, для крупного — богатые инструменты API, антифрод и гибкая аналитика.

Ключевые преимущества:

быстрый онбординг и широкая поддержка CMS/конструкторов;
стабильные платежи и понятные статусы операций;
встроенные инструменты фискализации чеков по 54‑ФЗ (через собственные или партнёрские решения);
поддержка СБП, рекуррентов и разовых инвойсов.

Если вам нужен «короткий путь» — подойдёт виджет или готовый модуль. Если важна глубокая кастомизация UX и бизнес‑логики — выбирайте прямую ЮKassa интеграцию через API.

![Схема интеграции YooKassa: поток данных от сайта к провайдеру и ОФД]

Получить CloudPayments бесплатно

Варианты интеграции: виджет, платежная страница или API

Выбор способа влияет на скорость запуска, требования к безопасности и контроль UX. Коротко сравним варианты YooKassa API/виджет.

Способ	Описание	Когда выбрать	Плюсы	Минусы
Виджет (встроенная форма)	Форма оплаты на вашем сайте, данные карты вводятся во встраиваемый элемент от YooKassa	Быстрый старт с «родным» UI провайдера	Быстро, минимальный PCI‑скоуп, меньше редиректов	Меньше контроля над UI, чем при «чистом» API
Платежная страница (redirect)	Пользователь уходит на страницу YooKassa для оплаты	Максимальная простота и безопасность	Минимум работ и рисков, хорошая конверсия для СБП	Есть внешний редирект, ниже контроль над UX
Прямая API‑интеграция	Полноценная работа через REST API, гибкий сценарий	Сложные сценарии, подписки, кастомный checkout	Полный контроль, расширяемость, A/B UX	Выше трудозатраты, требования к безопасности и тестам

Подбор способа — часть общей стратегии подключения платёжной системы к сайту. Если сомневаетесь, начните с виджета/redirect и перейдите на API, когда подтвердите гипотезы конверсии.

Подключение YooKassa к сайту: пошаговый план

Подготовьте сайт к модерации. На домене должны быть контакты, политика возврата, публичная оферта, описание товара/услуг и цены.
Зарегистрируйтесь в YooKassa и создайте магазин. После проверки вы получите идентификаторы (ID магазина) и ключи для доступа к API/виджету.
Включите тестовый режим. Настройте платежный сценарий в «песочнице», проверьте статусы и возвраты. Для отладки удобно воспользоваться рекомендациями по тестированию вебхуков и sandbox.
Настройте вебхуки. Укажите URL‑адрес обработчика, который будет принимать события payment.succeeded/canceled/refund.succeeded. Подробнее — в разделе ниже.
Продумайте фискализацию. Варианты: передача чеков через YooKassa и партнёров или собственная онлайн‑касса. Обязательно сверьтесь с нашим гидом по онлайн‑кассе и 54‑ФЗ.
Проведите E2E‑тесты. Оплата, отмена, возврат, частичная оплата, рекурренты (если нужны), СБП, фискальные чеки.
Переключитесь в боевой режим и мониторьте метрики: конверсию оплаты, долю СБП, время подтверждения, частоту отказов.

Совет: заложите идемпотентность для создания платежей и логируйте все входящие вебхуки — это сильно упрощает поддержку.

СБП в YooKassa

YooKassa СБП — один из самых популярных способов оплаты сегодня. Покупатель платит через банковское приложение по QR или пуш‑ссылке, а магазин получает быстрый и предсказуемый сценарий с низкими издержками.

Чем полезна СБП:

высокая конверсия на мобильных;
оперативное подтверждение платежа и быстрые зачисления;
удобна для крупных чеков и офлайн‑переходов (QR).

На вашем сайте СБП работает из коробки через виджет/redirect и через API. Проверьте, включён ли метод в настройках тарифа и убедитесь, что передаёте корректные суммы и назначение платежа. Больше о методах оплаты — в обзоре карты и СБП: как выбирать и комбинировать.

54‑ФЗ: фискализация чеков

Юкасса фискализация 54-ФЗ требует корректно формировать и отправлять чеки в ОФД. Ошибки здесь приводят к блокировкам и штрафам. Общие правила:

передавайте номенклатуру (каждую позицию), цену, количество, систему налогообложения, НДС и признак предмета расчёта;
соблюдайте сценарии: предоплата, полная оплата, частичная оплата, возврат, коррекция;
чек возврата формируйте на фактически возвращаемую сумму с правильными ставками налогов;
для рекуррентных списаний указывайте признак «интернет‑услуги/подписка», если применимо.

YooKassa может брать фискализацию на себя или работать в связке с вашей кассой. Выбор пути — в нашем гайде по 54‑ФЗ и онлайн‑кассам. Главное — синхронизация статусов: чек выдаётся в момент оплаты (payment.succeeded), а при возврате — формируется чек возврата (refund.succeeded).

Вебхуки YooKassa и обработка статусов

Вебхуки YooKassa — обязательная часть надёжной интеграции. Они уведомляют ваш бэкенд о результатах операций и позволяют не зависеть от закрытия вкладки или сетевых сбоев у пользователя.

Рекомендации:

принимайте и валидируйте события payment.succeeded, payment.canceled, refund.succeeded;
проверяйте, что сумма и заказ соответствуют вашему заказу (reconciliation);
используйте идемпотентность: повторные нотификации не должны дублировать операции;
логируйте payload и заголовки для аудита и отладки;
обрабатывайте timeouts и повторные попытки доставки.

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

Рекуррентные платежи и подписки

Рекуррентные платежи YooKassa позволяют списывать средства по сохранённому платежному методу. Это удобно для подписок, SaaS и регулярных сервисов.

Что важно учесть:

явное согласие пользователя и понятные условия списаний (оферта/галочка);
токенизация карты и хранение токена на вашей стороне (без данных карты);
уведомления перед списанием, прозрачная отмена подписки;
фискализация каждого списания по 54‑ФЗ.

Архитектурные паттерны и чек‑лист настройки — в материале о рекуррентных платежах и подписках.

Готовые плагины для CMS

Чаще всего YooKassa подключение к сайту ускоряют готовые модули. Они закрывают базовый функционал без глубокого кода.

YooKassa Tilda — быстрый старт на конструкторе с базовой логикой оплаты и вебхуков: подключение платежей на Tilda
YooKassa WooCommerce — стабильный модуль для WordPress‑магазинов, поддержка СБП и возвратов: платежи WooCommerce
1C‑Bitrix — корпоративный сегмент, масштабируемые магазины: платежи 1C‑Bitrix
Shopify, Wix, Webflow — запуск MVP или D2C‑витрин: Shopify, Wix, Webflow
OpenCart/PrestaShop — классические e‑commerce движки: OpenCart и PrestaShop

Если стандартный модуль не покрывает сценарии (несколько витрин, кастомная фискализация, сложные статусы), стоит перейти на API‑интеграцию.

Безопасность: PCI DSS и 3‑D Secure

Безопасность — фундамент доверия. При использовании виджета или redirect‑схемы данные карты обрабатываются средой YooKassa, а у вас снижается зона ответственности по PCI DSS. При глубокой API‑интеграции убедитесь, что вы не принимаете «сырые» PAN на свой сервер — так вы избежите жёстких требований SAQ D.

3‑D Secure (включая механизмы аутентификации держателей) — ключ к снижению чарджбеков. Мы собрали практические рекомендации в статье PCI DSS, антифрод и 3‑D Secure.

Сравнение с альтернативами

Чтобы выбрать оптимальный провайдер, сравните комиссии, набор методов оплаты, SLA и SDK. Полезные материалы:

Сравнение платёжных провайдеров в РФ
Альтернативы и интеграции: CloudPayments, Тинькофф Касса

Во многих проектах стоит подключать 2 провайдера и включать авто‑переключение при сбоях — так вы повышаете аптайм и конверсию.

Частые ошибки и чек‑лист запуска

Типичные проблемы при интеграции YooKassa:

нет валидации статусов: заказ помечается «оплачен» по редиректу, а не по вебхуку;
отсутствует идемпотентность: повтор платежа создаёт дубликат заказа;
не передаётся номенклатура в чеки (нарушение 54‑ФЗ);
неверно настроены права/ключи в тестовом и боевом окружении;
игнорируются события refund.succeeded (статус в CMS не синхронизирован);
неверная обработка частичных оплат/возвратов;
не закрыт сценарий таймаутов оплаты (pending «висит» без авто‑отмены);
забыли включить СБП или скрыли метод для мобильных устройств.

Чек‑лист:

выбрали способ интеграции (виджет/redirect/API);
завели магазин, получили ключи, включили песочницу;
настроили вебхуки и логирование (prod и sandbox);
протестировали разовые платежи, СБП, возвраты, отмены;
подключили фискализацию по 54‑ФЗ;
добавили подписки при необходимости и уведомления пользователям;
оформили политику возврата, оферту и контакты на сайте;
включили мониторинг конверсии и ошибок.

![Пример пользовательского пути: выбор метода оплаты, СБП/карта, подтверждение, чек]

Итоги и что дальше

YooKassa подключение к сайту можно сделать быстро через виджет/redirect или глубоко кастомизировать через API. Добавьте СБП для лучшей конверсии, корректно настройте вебхуки и фискализацию — и получите надёжные онлайн‑платежи без ручной рутины. Нужна помощь с ЮKassa интеграцией, CMS‑модулями или миграцией с другого провайдера? Обратитесь к нам — возьмём на себя аудит, настройку и релиз. Начните со страницы как подключить платёжную систему к сайту и оставьте заявку.

Получить CloudPayments бесплатно