Все статьи
Инструкции

Как подключить онлайн-оплату через ЮKassa: от договора до первого платежа

11 мин чтения

Пока у студии нет онлайн-оплаты, каждый абонемент продаётся в три касания: клиент написал, администратор ответил, продиктовал номер карты или реквизиты, дождался перевода, вручную отметил оплату. На один платёж уходит 10–15 минут переписки, а часть клиентов по дороге просто «остывает» и не доходит до перевода. С подключённой онлайн-оплатой клиент нажимает кнопку «Купить онлайн» на сайте студии, платит картой или по СБП за минуту — и абонемент сразу появляется у него в личном кабинете, а платёж — у вас в разделе «Деньги».

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

Как это устроено: деньги идут напрямую вам

Важно понимать схему с самого начала. Studio Admin — не посредник в расчётах:

  • договор на приём платежей вы заключаете напрямую с ЮKassa;
  • у вашей студии — собственный магазин в кабинете ЮKassa со своим идентификатором (shopId);
  • деньги от клиентов поступают на ваш расчётный счёт по договору с ЮKassa, минуя платформу;
  • платформа не берёт комиссию за эквайринг и вообще не участвует в движении денег — комиссию удерживает только сама ЮKassa по вашему тарифу;
  • чеки по 54-ФЗ, налоги и возвраты — ваша зона ответственности в рамках договора с ЮKassa.

Такая схема подходит самозанятым, ИП и ООО — ЮKassa работает со всеми тремя формами. Для самозанятых это особенно удобно: не нужна онлайн-касса, чек формируется в приложении «Мой налог».

✅ Полностью бесплатно

Сама интеграция ЮKassa в Studio Admin бесплатна, как и всё остальное на платформе: сайт студии, онлайн-запись, абонементы, боты и личный кабинет клиента. Вы платите только комиссию ЮKassa с каждого платежа по своему тарифу — платформе не достаётся ни процента.

Что понадобится перед стартом

Проверьте по списку — с ним подключение пройдёт без пауз:

  • Статус самозанятого, ИП или ООО. Принимать оплату «на личную карту физлица» через эквайринг нельзя — это требование закона, а не платформы.
  • Опубликованный сайт студии. Если сайта ещё нет — зайдите в раздел «Сайт» и нажмите «Создать сайт». Без сайта клиентам просто негде оплачивать, а модерация ЮKassa проверяет, что на сайте есть цены, услуги и оферта. Как собрать сайт за вечер — отдельная инструкция.
  • Заполненные цены. Абонементы и разовые в разделе «Цены» — модератор ЮKassa должен видеть, что именно вы продаёте.
  • Полчаса времени на регистрацию в ЮKassa и заполнение анкеты.

Шаг 1. Заключите договор с ЮKassa

1

Зарегистрируйтесь на yookassa.ru

Откройте страницу подключения yookassa.ru/joining и заполните анкету: форма деятельности (самозанятый, ИП или ООО), реквизиты, вид деятельности. В качестве сайта укажите адрес сайта вашей студии — он в формате вашслаг.studio-admin.ru, точный адрес показан в настройках онлайн-оплаты с кнопкой «Копировать».

2

Подпишите договор

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

На этом этапе ЮKassa может задать вопросы о деятельности и попросить дополнить сайт. Типичные требования модерации — наименование юрлица, ИНН и оферта на сайте. Хорошая новость: Studio Admin закрывает это автоматически, что мы и сделаем в шаге 3.

Шаг 2. Откройте доступ к API и СБП

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

3

Напишите в чат поддержки ЮKassa

В кабинете ЮKassa откройте чат поддержки и напишите: «включите доступ к API и приём по СБП для моего магазина». Обычно включают в тот же день. Без этого интеграция по ключу и оплата по СБП не заработают — даже с правильными ключами.

Почему СБП стоит просить сразу: комиссия по СБП заметно ниже эквайринга картами, а клиенты платят через привычное банковское приложение по QR-коду или ссылке. Подробнее о выгоде СБП — в статье про оплату абонементов через СБП.

Шаг 3. Реквизиты и оферта на сайте студии

Теперь переходим в админку Studio Admin: раздел «Настройки», блок «Онлайн-оплата · ЮKassa». Блок свёрнут — нажмите на заголовок, он развернётся. Справа виден статус: пока «Выключено».

Настройки студии: блок «Онлайн-оплата · ЮKassa» разворачивается по клику
Настройки студии: блок «Онлайн-оплата · ЮKassa» разворачивается по клику

Первый пункт внутри блока — «Реквизиты на сайте студии». Заполните три поля:

  • Наименование — например, ИП Иванова А.А., ООО «Ромашка» или Самозанятая Иванова А.А.;
  • ИНН — только цифры, поле само отбрасывает лишнее;
  • ОГРН/ОГРНИП — для ИП и ООО; самозанятым это поле заполнять не нужно.

Нажмите «Сохранить реквизиты» — они сразу появятся в подвале сайта студии. Оферта генерируется автоматически и доступна по адресу /offer на вашем сайте — ссылку на неё модерация ЮKassa тоже проверяет, и она уже на месте.

ℹ️ Обратите внимание

После включения приёма оплаты реквизиты фиксируются и становятся недоступны для правки — это защита от случайных изменений на работающих платежах. Если реквизиты всё же нужно поменять, сначала нажмите «Выключить приём» внизу блока, исправьте данные и включите приём заново.

Шаг 4. Вебхук: мгновенное зачисление оплат

Второй пункт блока — «Магазин в ЮKassa». Здесь показан адрес вашего сайта (он может понадобиться в анкете ЮKassa) и адрес вебхука — HTTP-уведомления, через которое ЮKassa сообщает платформе о результате платежа.

4

Добавьте HTTP-уведомление в кабинете ЮKassa

В кабинете ЮKassa откройте Настройки, затем HTTP-уведомления. Вставьте адрес вебхука из админки — там есть кнопка «Копировать» — и отметьте два события: payment.succeeded и payment.canceled. Сохраните.

Строго говоря, вебхук не обязателен: после оплаты клиент возвращается на страницу результата, и платформа сама перепроверяет статус платежа прямым запросом к ЮKassa. Но с вебхуком оплата зачисляется мгновенно даже в неудобных сценариях — например, клиент оплатил по СБП и закрыл вкладку, не дождавшись возврата на сайт. Разница выглядит так:

Сценарий Без вебхука С вебхуком
Клиент вернулся на сайт после оплаты Зачислится на странице результата Уже зачислено
Клиент закрыл вкладку сразу после оплаты Зачислится с задержкой Зачислено мгновенно
Оплата по СБП из банковского приложения Зависит от возврата на сайт Зачислено мгновенно

Вывод простой: потратьте две минуты на вебхук — и забудьте о вопросе «я оплатила, а где мой абонемент?».

Шаг 5. shopId и секретный ключ — и всё заработает

Финальный пункт — «Данные магазина». Оба значения берутся в кабинете ЮKassa: Настройки, затем API-ключи.

5

Введите shopId

shopId — числовой идентификатор магазина, например 1407171. Скопируйте его из кабинета ЮKassa и вставьте в поле. Обратите внимание: поля станут доступны только после сохранения реквизитов из шага 3 — админка подскажет, если порядок нарушен.

6

Введите секретный ключ

Секретный ключ начинается с live_ и выпускается в том же разделе API-ключи. Вставьте его в поле и нажмите «Сохранить — включить приём». Ключ хранится на сервере и никому не показывается — в интерфейсе он больше не появится, только пометка «сохранён».

При сохранении платформа не просто записывает данные, а делает живой проверочный запрос к ЮKassa. Если ключи верны и доступ к API открыт — появится зелёное сообщение «Данные проверены в ЮKassa — приём оплаты включён», статус блока сменится на «Включено», а рядом с данными магазина появится пометка «Проверено». Если проверка не прошла — вы сразу увидите причину, а приём останется выключенным: клиенты не наткнутся на неработающую оплату.

💡 Совет

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

Первый платёж: проверяем всю цепочку

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

Страница цен на сайте студии: после подключения ЮKassa у карточек появились кнопки покупки
Страница цен на сайте студии: после подключения ЮKassa у карточек появились кнопки покупки

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

Теперь посмотрите со стороны студии. В разделе «Деньги» платёж уже на месте — с суммой, назначением и способом оплаты (карта или СБП). Клиент создан в базе автоматически, абонемент выдан и виден в его карточке. Если хотите вернуть тестовый платёж — сделайте возврат в кабинете ЮKassa.

Раздел «Деньги»: онлайн-платёж появился автоматически с указанием способа оплаты
Раздел «Деньги»: онлайн-платёж появился автоматически с указанием способа оплаты

«Подключала ЮKassa с ощущением, что впереди неделя бюрократии. По факту: вечером заполнила анкету, утром написала в чат про API и СБП, после обеда вставила два ключа — и в тот же день пришла первая оплата абонемента, пока я вела занятие. Раньше я бы полчаса переписывалась с этой клиенткой про перевод на карту» — владелица студии растяжки, Казань.

Чеки 54-ФЗ: кто их пробивает

Онлайн-платёж — это расчёт, по которому нужен чек. Есть три рабочих варианта:

  • Самозанятые — формируют чек в приложении «Мой налог» на каждую оплату, онлайн-касса не нужна;
  • «Чеки от ЮKassa» — ЮKassa сама формирует и отправляет чеки, если вы подключили эту услугу в её кабинете;
  • Своя онлайн-касса — вы пробиваете чеки на своей стороне.

Чтобы ни один чек не потерялся, в блоке настроек есть переключатель «Напоминать пробивать чек после оплаты». С ним в разделе «Деньги» появляется список «Чеки к пробитию» — все онлайн-оплаты, по которым чек ещё не отмечен. Пробили — отметили — список чист. Если чеки формирует сама ЮKassa, напоминание можно отключить, чтобы не дублировать работу.

Что открывается после подключения

Онлайн-оплата — это не только кнопка на странице цен. После включения приёма у студии появляются новые механики:

  • Запись только по оплате. В блоке настроек появляется переключатель «Запись только по оплате — на все занятия»: клиент без активного абонемента не запишется, пока не оплатит. Тот же режим можно включать точечно у отдельных видов занятий — с полной оплатой или предоплатой-депозитом. Как это работает на записи — в инструкции про продажу разовых занятий.
  • Продажа абонементов без администратора. Клиент покупает ночью, в выходной, из другого города — абонемент выдаётся сам. Про настройку абонементов — отдельная статья.
  • Ссылки на оплату. Администратор может отправить клиенту прямую ссылку на оплату в переписке.
  • Подписка на бота после оплаты. Страница результата сама предлагает клиенту подключить бота в Telegram или MAX — туда придут напоминания о занятиях и вход в личный кабинет.

И всё это одинаково работает с телефона: страница цен, платёжная форма и СБП рассчитаны на мобильный сценарий — большинство оплат приходит именно со смартфонов.

Мобильная версия страницы цен: клиент выбирает абонемент и оплачивает прямо с телефона
Мобильная версия страницы цен: клиент выбирает абонемент и оплачивает прямо с телефона

Частые вопросы

Сколько времени занимает подключение целиком?

Обычно один-два дня: день на договор с ЮKassa, ещё несколько часов на включение API и СБП поддержкой. Действия в админке Studio Admin занимают минут десять.

Можно ли принимать оплату без сайта?

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

Что если я введу неверные ключи?

Ничего страшного не произойдёт: проверка живым запросом не пройдёт, приём не включится, а вы увидите причину ошибки. Клиенты не пострадают — кнопки оплаты не появятся на сайте, пока данные не проверены.

Как временно выключить онлайн-оплату?

Кнопка «Выключить приём» внизу блока. Кнопки покупки исчезнут с сайта, все настройки и история платежей сохранятся — включите обратно, когда будете готовы.

Подключите оплату один раз — и продажи перестанут зависеть от того, успел ли администратор ответить в мессенджере. А если студия ещё не зарегистрирована в Studio Admin — начните с бесплатной регистрации: сайт, цены и онлайн-запись соберёте за один вечер.

Зарегистрировать студию бесплатно

Попробуйте бесплатно

Зарегистрируйте студию прямо сейчас

Никаких договоров, никакой предоплаты. Все функции бесплатны — расписание, CRM, абонементы, онлайн-запись и приложение на телефон.

Зарегистрировать студию →