Подключение приёма оплат (ЮKassa)
Брать предоплату за брони: свой магазин ЮKassa, реквизиты, чеки 54-ФЗ.
Что это даёт
Гость платит за бронь сразу, на месте выбора ПК или стола. Деньги приходят вам напрямую — в ваш магазин ЮKassa, по вашему договору с ней. Мы деньги не держим, не переводим и комиссию с них не берём: наша роль — создать платёж и показать гостю результат.
Что это меняет в работе: место держится за гостем только до оплаты, неоплаченные брони снимаются сами, а «не пришёл и не предупредил» перестаёт быть бесплатным.
Что понадобится
- Магазин в ЮKassa на ваше юрлицо или ИП. Если его ещё нет — зарегистрируйтесь в ЮKassa. Отдельный сайт для этого не нужен: в анкете как адрес сайта укажите вашу страницу заведения
axleapp.ru/o/…— она публичная, работает по HTTPS и у каждого заведения своя. Ссылка на неё с кнопкой «Скопировать» лежит прямо в Интеграции → Приём оплат. - Тариф с предоплатой брони тариф «Старт» — магазин подключить можно на любом, а брать деньги вперёд — на тарифе с ней.
Что ЮKassa проверяет на странице
Прежде чем открыть магазин, ЮKassa открывает указанный сайт и смотрит, что на нём есть. Требования у них такие — и вот как они закрыты у нас:
| Что требуется | Как это на вашей странице |
|---|---|
| Настоящие товары или услуги с ценами | Меню и прайс — из вашей кассы, с ценами |
| Описания, а не заглушки | Название, описание, фотографии заведения |
| Как получают услугу | Адрес, часы работы и способ брони у каждой точки |
| Оферта или пользовательское соглашение | Оферта на бронь и предоплату — ссылка в подвале страницы |
| Политика обработки персональных данных | Ссылка в подвале страницы и в «Профиле» приложения |
| Контакты и реквизиты компании | Телефон, почта, юрлицо, ИНН, ОГРН и адрес — в блоке «О компании» |
Сначала — юрлицо в точке. Точки → точка → Юрлицо: введите ИНН, наименование, ОГРН и адрес подставятся из реестра налоговой. Из него мы собираем оферту и политику обработки персональных данных: исполнитель и оператор в них — вы, наш сервис назван обработчиком по вашему поручению. Это ваши документы — прочитайте их; свои условия (сколько держите бронь, сроки отмены, возраст 18+) допишите в Профиль → Организация → Правила заведения, они встанут в оферту отдельным разделом. Там же укажите телефон и почту для гостей.
Пока юрлица или контактов нет, кнопки регистрации в ЮKassa и подключения магазина не будет: страница вместо этого скажет, чего не хватает. Магазин ЮKassa заключается с одним юрлицом — если точки работают на разных ИП или ООО, напишите нам, подключим вручную. Если ЮKassa сообщает ИНН магазина, а такого юрлица нет в точках, магазин не подключится: деньги гостей ушли бы не тому, кто указан исполнителем в оферте.
Шаг 1. Возьмите реквизиты магазина
В личном кабинете ЮKassa: Интеграция → Ключи API. Там два значения:
shopId— номер магазина;- секретный ключ — длинная строка, начинается с
test_(тестовый режим) илиlive_(боевой).
Тестовым ключом можно всё проверить, не двигая настоящие деньги: ЮKassa покажет гостю пометку «это тестовый платёж».
Шаг 2. Введите их в кабинете
Интеграции → Приём оплат · ЮKassa → впишите shopId и секретный ключ → Сохранить и проверить.
Мы сразу спросим у ЮKassa, живые ли реквизиты, и скажем прямо: подключён магазин или ключ не принят. Магазин с тестовым ключом отмечен «тестовый режим»: настоящие карты гостей он не примет. Секретный ключ после сохранения показывается только маской (•••• 4821) — назад его прочитать нельзя, в том числе нам.
Блок «Что принимаем» на той же странице показывает, за что гость может заплатить онлайн и включено ли это, со ссылкой туда, где это настраивается.
Чтобы поменять ключ, введите новый. Чтобы оставить прежний — оставьте поле пустым.
Шаг 3. Решите, кто пробивает чек
Предоплата — это аванс, и чек по нему обязателен по 54-ФЗ. Варианты:
- Пробиваю сам — вы фискализируете аванс на своей кассе. Мы чек не отправляем.
- Пробивает ЮKassa — укажите систему налогообложения и ставку НДС. Чек уйдёт автоматически в момент оплаты; зачёт аванса (когда гость пришёл и всё оплатил) пробиваете уже на своей кассе — это ваша сторона.
Онлайн-оплаты можно проводить и в кассе — на депозит гостя, без второго чека (так умеет, например, касса компьютерного клуба: тумблер «Проводить онлайн-оплаты в кассе» на её странице в «Интеграциях»). Для этого чек должен пробивать ЮKassa: касса кладёт деньги без своего чека. Пока онлайн-оплаты уходят в кассу, переключить на «Пробиваю сам» нельзя — сначала выключите тумблер на странице кассы.
Шаг 4. Включите предоплату
Брони → Настройки → Предоплата: сколько берём вперёд (вся сумма, залог, процент), сколько минут держим место без оплаты, правило возврата при отмене.
Пока магазин не подключён, тумблер не включается — и честно объясняет почему.
Как проверить, что всё работает
- Оставьте тестовый ключ (
test_…). - Откройте бронь глазами гостя, дойдите до оплаты.
- ЮKassa покажет страницу с пометкой «тестовый платёж» — заплатите тестовой картой из их документации.
- Вернувшись, вы увидите бронь со статусом «Оплачено», а в списке броней — сумму в колонке «Оплата».
- Убедились — замените ключ на боевой (
live_…) и нажмите Сохранить и проверить ещё раз.
Платежи: сверка за день
Вкладка Платежи на странице «Приём оплат» — все онлайн-оплаты, возвраты и оплаты на месте за период: сегодня, вчера, 7 дней или свой период. День считается по часам вашей точки.
- Итог периода над таблицей: сколько оплачено онлайн и возвращено; если онлайн-оплаты уходят в кассу — сколько из них в кассе и сколько не доехало. «На месте» в итог не входит.
- Фильтры — назначение (например, предоплата брони), статус (оплачено, ждёт оплаты, не оплачено, возврат) и касса (в кассе, не доехало, не нужно).
- Строка открывает шторку: гость и бронь ссылками, номер платежа в ЮKassa, другие попытки оплаты, возвраты и что с деньгами в кассе. Здесь же — Возврат и, если касса не ответила, Уже в кассе / Отправить в кассу ещё раз. Номер брони открывает шторку заказа в карточке гостя: там рядом с оплатой видны документ кассы по этому визиту и итог — сходится ли оплата с кассой, не заплатил ли гость дважды.
Касса считает онлайн-деньги отдельным способом оплаты, поэтому сверяйте её отчёт по этому способу за тот же день, а не по смене: сервис проводит деньги без смены оператора. Не сошлось — поставьте фильтр «Касса: не доехало» и разберите строки в шторке.
Частые вопросы
Гость закрыл окно оплаты. Бронь остаётся, место держится до конца таймера, у гостя есть кнопка Оплатить. Не оплатил — бронь снимается сама, место возвращается в продажу.
Деньги списались, а бронь не отметилась. Мы перепроверяем статус платежа у ЮKassa при возврате гостя и раз в несколько минут кроном, так что отметка придёт сама. Если этого не произошло — напишите нам, в журнале обмена видно каждый шаг.
Как вернуть деньги. В списке броней кнопка Возврат: сумма по умолчанию — вся оплаченная, больше вернуть нельзя. Возврат уходит в ЮKassa; если она откажет (например, не хватает средств на счёте магазина), придёт уведомление в колокольчик, и вернуть можно вручную в личном кабинете ЮKassa.
Гость платит на месте. Кнопка ₽ на месте в списке броней снимает таймер и помечает бронь оплаченной. ЮKassa при этом не трогается — деньги прошли мимо неё.