Подключение приёма оплат (ЮKassa)

Брать предоплату за брони: свой магазин ЮKassa, реквизиты, чеки 54-ФЗ.

Что это даёт

Гость платит за бронь сразу, на месте выбора ПК или стола. Деньги приходят вам напрямую — в ваш магазин ЮKassa, по вашему договору с ней. Мы деньги не держим, не переводим и комиссию с них не берём: наша роль — создать платёж и показать гостю результат.

Что это меняет в работе: место держится за гостем только до оплаты, неоплаченные брони снимаются сами, а «не пришёл и не предупредил» перестаёт быть бесплатным.

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

• Магазин в ЮKassa на ваше юрлицо или ИП. Если его ещё нет — заводится на yookassa.ru. Отдельный сайт для этого не нужен: в заявке как адрес можно указать вашу страницу заведения axleapp.ru/o/… — она публичная, работает по HTTPS и у каждого заведения своя.
• Тариф «Про» — приём предоплаты входит в него.

Шаг 1. Возьмите реквизиты магазина

В личном кабинете ЮKassa: Интеграция → Ключи API. Там два значения:

• shopId — номер магазина;
• секретный ключ — длинная строка, начинается с test_ (тестовый режим) или live_ (боевой).

Тестовым ключом можно всё проверить, не двигая настоящие деньги: ЮKassa покажет гостю пометку «это тестовый платёж».

Шаг 2. Введите их в кабинете

Интеграции → Приём оплат → впишите shopId и секретный ключ → Сохранить и проверить.

Мы сразу спросим у ЮKassa, живые ли реквизиты, и скажем прямо: подключён магазин или ключ не принят. Секретный ключ после сохранения показывается только маской (•••• 4821) — назад его прочитать нельзя, в том числе нам.

Чтобы поменять ключ, введите новый. Чтобы оставить прежний — оставьте поле пустым.

Шаг 3. Решите, кто пробивает чек

Предоплата — это аванс, и чек по нему обязателен по 54-ФЗ. Варианты:

• Пробиваю сам — вы фискализируете аванс на своей кассе. Мы чек не отправляем.
• Пробивает ЮKassa — укажите систему налогообложения и ставку НДС. Чек уйдёт автоматически в момент оплаты; зачёт аванса (когда гость пришёл и всё оплатил) пробиваете уже на своей кассе — это ваша сторона.

Шаг 4. Включите предоплату

Брони → Настройки → Предоплата: сколько берём вперёд (вся сумма, залог, процент), сколько минут держим место без оплаты, правило возврата при отмене.

Пока магазин не подключён, тумблер не включается — и честно объясняет почему.

Как проверить, что всё работает

1. Оставьте тестовый ключ (test_…).
2. Откройте бронь глазами гостя, дойдите до оплаты.
3. ЮKassa покажет страницу с пометкой «тестовый платёж» — заплатите тестовой картой из их документации.
4. Вернувшись, вы увидите бронь со статусом «Оплачено», а в списке броней — сумму в колонке «Оплата».
5. Убедились — замените ключ на боевой (live_…) и нажмите Сохранить и проверить ещё раз.

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

Гость закрыл окно оплаты. Бронь остаётся, место держится до конца таймера, у гостя есть кнопка Оплатить. Не оплатил — бронь снимается сама, место возвращается в продажу.

Деньги списались, а бронь не отметилась. Мы перепроверяем статус платежа у ЮKassa при возврате гостя и раз в несколько минут кроном, так что отметка придёт сама. Если этого не произошло — напишите нам, в журнале обмена видно каждый шаг.

Как вернуть деньги. В списке броней кнопка Возврат: сумма по умолчанию — вся оплаченная, больше вернуть нельзя. Возврат уходит в ЮKassa; если она откажет (например, не хватает средств на счёте магазина), придёт уведомление в колокольчик, и вернуть можно вручную в личном кабинете ЮKassa.

Гость платит на месте. Кнопка ₽ на месте в списке броней снимает таймер и помечает бронь оплаченной. ЮKassa при этом не трогается — деньги прошли мимо неё.