ЮKassa — один из самых удобных способов принимать онлайн-платежи в России. В этом гиде вы найдете пошаговую инструкцию, как подключить ЮKassa, какие документы и настройки понадобятся на старте, как пройти KYC/KYB-проверку и настроить ККТ по 54‑ФЗ, СБП и SberPay.
![Схема процесса подключения ЮKassa: регистрация → проверка KYC/KYB → интеграция → тесты → запуск]
Подключение ЮKassa позволяет принимать платежи банковскими картами, через СБП, SberPay, электронные кошельки и другие методы. Сервис подходит ИП, ООО, самозанятым и НКО, работающим в соответствии с российским законодательством.
Ключевые преимущества:
Подробнее о том, как проходит платеж, читайте на странице Как проходит оплата в ЮKassa.
Перед тем как подключить ЮKassa, подготовьте:
Если вы пока выбираете эконом-модель, загляните в раздел Тарифы и комиссии.
Процесс регистрации ЮKassa обычно занимает 10–20 минут:
Важно: проверьте, чтобы политика конфиденциальности и оферта на вашем сайте содержали обязательные разделы о платежах и возвратах. Краткий разбор — в FAQ.
После регистрации включается проверка KYC/KYB (Know Your Customer / Know Your Business). В русской переписке это часто пишут как «kyd kyb ЮKassa» — речь об идентификации клиента и бизнеса.
Что проверяют:
Советы, чтобы пройти быстрее:
Срок проверки обычно 1–3 рабочих дня, может варьироваться при сложной структуре владения.
Тарифная сетка зависит от объема и сферы. На старте выбирают базовый тариф, далее условия можно пересмотреть при росте оборота. Детали и примеры расчетов — в разделе Тарифы и комиссии.
После одобрения начните настройку ЮKassa для бизнеса: получите идентификатор магазина, секретный ключ, настройте страницы успеха/ошибки и вебхуки.
Для популярных систем доступны плагины — это самый быстрый путь:
Обычно достаточно установить модуль, указать shopId и секрет, выбрать методы оплаты. Полный обзор способов — на странице Платежные методы.
Если у вас кастомная разработка, используйте API:
Руководство и типовые флоу — в разделе Интеграция по API.
![Скриншот настроек вебхуков в личном кабинете ЮKassa: URL, секрет, список событий]
Лучшие практики:
Чтобы подключить ККТ 54‑ФЗ и отправлять чеки, выберите вариант:
В ЮKassa можно связать платеж и чек: при успешной оплате формируется фискальный документ и отправляется на e‑mail/SMS клиента. Подробно о сценариях, номенклатуре и реквизитах чеков — в материалах 54‑ФЗ и ККТ и Чеки ЮKassa.
Обязательно проверьте корректность ставок НДС, признака расчета и предметов расчета — ошибки ведут к блокировке фискализации.
Список методов зависит от сферы и риска. Базово доступны карты МИР/Visa/Mastercard, затем можно включить дополнительные способы:
Чтобы включить СБП и SberPay (или, как часто спрашивают, «включить СБП СберPay»), откройте настройки методов оплаты в кабинете и активируйте соответствующие опции. Особенности подключения Сбербанка, лимиты и UX-практики собраны на странице SberPay и Сбербанк в ЮKassa. Полный перечень доступных способов — на странице Платежные методы.
Перед переключением на боевые ключи пройдите тест-кейсы:
Проверьте корректность статусов в вашей CRM/ERP, сопоставление платежей и заказов. Подробности тестирования — в Интеграция по API и Оплата с ЮKassa.
Рабочие процессы после запуска не менее важны, чем само подключение ЮKassa:
Настройте регламент: кто инициирует возврат, кто закрывает тикет, как проверяются суммы в отчете. Практики и шаблоны — в разделе Возвраты и чарджбеки. Для контроля финансов пользуйтесь Отчетами и сверкой.
ЮKassa сертифицирована по PCI DSS, однако и ваш проект должен соблюсти базовые требования безопасности:
Больше о требованиях и лучших практиках — в разделе Безопасность и PCI DSS.
Самые частые проблемы при настройке ЮKassa для бизнеса:
Проверьте логи интеграции, сопоставьте shopId/ключи для теста и прода. Если ошибка сохраняется, загляните в раздел Поддержка и troubleshooting и FAQ.
Ниже — ориентировочный перечень для KYC/KYB и настройки. В отдельных кейсах список может расширяться.
| Элемент | Кто готовит | Срок, ориентир |
|---|---|---|
| Карточка компании (ИНН, ОГРН/ОГРНИП, адреса) | Бизнес | 15–30 минут |
| Договор оферта ЮKassa (акцепт) | Бизнес | 5 минут |
| Документы KYC/KYB (паспорт/устав/приказы) | Бизнес | 1 день |
| Модерация сайта и деятельности | ЮKassa | 1–3 рабочих дня |
| Интеграция CMS/API + вебхуки | Разработчик | 1–3 дня |
| Подключить ККТ 54‑ФЗ (ОФД/облачная касса) | Бухгалтер/ИТ | 1–2 дня |
| Включить СБП и SberPay | Маркетинг/ИТ | 30–60 минут |
| Тест-кейсы и go‑live | Команда проекта | 0,5–1 день |
Совет: заведите единый документ с контактами ответственных и контрольными сроками.
Подключение ЮKassa состоит из трех больших блоков: регистрация и акцепт оферты, прохождение KYC/KYB, интеграция и запуск. Чем лучше подготовлены сайт и документы, тем быстрее модерация и выше конверсия оплат благодаря корректной настройке методов и чеков.
Готовы начать? Перейдите к выбору методов оплаты на странице Платежные методы, оцените условия в Тарифах и следуйте гайду по Интеграции API. Если остались вопросы, загляните в FAQ или напишите в Поддержку.