ОКНА
Секундочку…
ОКНА/Справка
Вся справка

Подключение ЮKassa

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

Валюта — только рубли (RUB).

Что понадобится

  1. Магазин в ЮKassa — подключается по договору (нужны ИП или юрлицо; для приёма на личный кошелёк без договора есть ЮMoney).
  2. Shop ID (идентификатор магазина) и Секретный ключ — оба берутся в личном кабинете ЮKassa: Интеграция → Ключи API. Секретный ключ показывается один раз при выпуске — сохраните его сразу.

Шаг 1. Введите ключи в ОКНА

  1. Откройте Настройки → Приём оплаты.
  2. В блоке «Россия» выберите YooKassa.
  3. Заполните поля:
    • Shop ID — номер магазина из кабинета ЮKassa;
    • Secret Key — секретный ключ того же магазина.
  4. Нажмите Сохранить и включить — ЮKassa сразу появится в списке способов оплаты со статусом «Активен».

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

Шаг 2. Чеки 54-ФЗ (если у вас есть касса)

В той же карточке — переключатель «Онлайн-касса подключена»:

  • выключен (по умолчанию) — чек уходит как раньше, со ставкой «Без НДС», без указания системы налогообложения;
  • включён — выберите Систему налогообложения (ОСН, УСН «доходы», УСН «доходы минус расходы», ЕНВД, ЕСХН или патент) и Ставку НДС — справочник совпадает с тем, что в настройках самой кассы ЮKassa, включая ставки 22% и расчётную 22/122, обязательные с 1 января 2026 года.

Настройка нужна, если к вашему магазину в ЮKassa подключена реальная онлайн-касса и вы обязаны пробивать чек по 54-ФЗ с правильной ставкой: без неё чек всегда уходил «без НДС», что для магазина на УСН с НДС или на другой ставке было неверно. Если кассы нет — ничего включать не нужно, поведение не меняется.

Шаг 3. Укажите адрес уведомлений в кабинете ЮKassa

Под формой в ОКНАх показан блок «Webhook URL для кабинета провайдера» — скопируйте этот адрес:

https://okna.one/api/public/payments/webhook?provider=yookassa

В личном кабинете ЮKassa откройте Интеграция → HTTP-уведомления, вставьте адрес и включите событие payment.succeeded («Платёж успешно завершён»). Именно по этому уведомлению запись помечается оплаченной.

Подсказка под полем в ОКНАх говорит то же самое: «Укажите этот URL в HTTP-уведомлениях ЮKassa (событие payment.succeeded)».

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

Шаг 4. Проверьте оплатой

  1. Создайте тестовую запись с недорогой услугой (например, 50 ₽) на себя или тестового клиента.
  2. Откройте страницу оплаты этой записи, выберите ЮKassa и оплатите картой.
  3. Через несколько секунд запись в календаре станет «Оплачено», а вам придёт уведомление «клиент оплатил».

Если всё сработало — подключение готово.

Как это видит клиент

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

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

Какая сумма подставляется в оплату? Персональный тариф клиента на услугу, если он задан; иначе — цена услуги. Если счёт выставлен платёжной ссылкой — сумма из ссылки.

Что с чеками 54-ФЗ? ОКНА передают в ЮKassa одну позицию чека — название услуги, имя клиента, его почту и телефон. Ставка НДС и система налогообложения задаются переключателем «Онлайн-касса подключена» в карточке ЮKassa (см. «Шаг 2» выше). Пока он выключен, ставка — «Без НДС», как и раньше.

Можно ли принимать евро или доллары? Через ЮKassa — нет, только рубли. Для валютных клиентов подключите Stripe или PayPal либо укажите валютную ссылку в разделе Настройки → Приём оплаты → «Моя ссылка на оплату». Оплату по такой ссылке вы отмечаете вручную.

Клиент оплатил меньше, чем нужно. Что будет? Оплата не засчитается: запись останется «Не оплачено», а сам платёж будет виден в кабинете ЮKassa.

Как сделать возврат? Возврат делается в кабинете ЮKassa. В ОКНАх статус оплаты при этом не меняется — снимите отметку «Оплачено» в карточке записи вручную.

Если не работает

  • Сменили Shop ID, а платежи идут по-старому. Проверьте, что новый Shop ID сохранился (поле не откатилось после «Сохранить»). Secret Key при этом перевводить не нужно — он меняется, только если вы сами вписали новый ключ; пустое поле сохраняет прежний.
  • «Не получилось открыть оплату». Обычно это неверная пара Shop ID + секретный ключ или отключённый магазин в ЮKassa. Выпустите ключ заново в кабинете ЮKassa и введите оба поля в ОКНАх.
  • Оплата прошла, но запись «Не оплачено». Проверьте в кабинете ЮKassa, что адрес уведомлений указан точь-в-точь как в блоке «Webhook URL» и включено событие payment.succeeded. Уведомления должны приходить прямо от ЮKassa — не перенаправляйте их через сторонние сервисы, такие запросы отклоняются. Оплату всегда можно отметить вручную в карточке записи.
  • Заменили ключи в кабинете ЮKassa, но не в ОКНАх. Оплата пройдёт, а отметиться не сможет: подтверждение платежа запрашивается вашими ключами. Введите новые ключи в ОКНАх.
  • На странице оплаты нет ЮKassa. Проверьте статус карточки («Активен») и валюту записи: ЮKassa показывается только у рублёвых записей.
  • Не помогло — напишите нам через Обратную связь на Главной, приложите время оплаты и номер записи.

См. также

Не нашли ответ? Напишите нам через «Обратную связь» на Главной.