Нямбот
НЯМБОТРуководство
О продуктеОткрыть СРМ

ЮКасса

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

Зарегистрировать магазин в ЮKassa →

Что потребуется#

  • ИП, ООО или самозанятый (ЮКасса поддерживает все формы)
  • Расчётный счёт в банке (для получения выплат)
  • Примерно 1–3 рабочих дня на прохождение модерации

Шаг 1: Регистрация в ЮКассе#

Зарегистрировать магазин в ЮKassa →

  1. Перейди по ссылке выше и нажми «Подключить ЮКассу» или «Зарегистрироваться»
  2. Заполни форму: электронная почта, телефон, форма собственности (ИП / ООО / самозанятый)
  3. Подтверди почту и телефон
  4. Загрузи необходимые документы (ИНН, ОГРН, паспорт)
  5. Дождись прохождения модерации — обычно 1–3 рабочих дня

Если модерация просит скриншоты «из бота, а не из mini app»#

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

  1. Каталог — карточки блюд с ценами
  2. Карточка блюда
  3. Корзина
  4. Страница оформления заказа
  5. Экран бота, где видно его название и кнопку «Меню»

И дай ссылку на бота в формате https://t.me/имя_бота — меню в нём открывается без регистрации и телефона.

Шаг 2: Получение Shop ID#

После одобрения аккаунта:

  1. Войди в личный кабинет ЮКассы
  2. Найди Shop ID — числовой идентификатор магазина (отображается в настройках или в шапке личного кабинета)
  3. Скопируй его — он понадобится на следующих шагах

Шаг 3: Получение Client ID и Client Secret#

Для приёма онлайн-оплаты нужно создать OAuth-приложение в ЮКассе.

Приложение у каждого ресторана своё: заходи под учётной записью того магазина, чей Shop ID будешь вводить в СРМ.

  1. Перейди на страницу создания OAuth-приложений и нажми «Зарегистрировать»
  2. Название — любое, например «Нямбот». Описание и ссылку на сайт можно не заполнять
  3. Код подтверждения — выбери «Показывать на странице». Код ты скопируешь с сайта ЮKassa и введёшь в СРМ руками (шаг 4.3)
  4. Доступы — только в блоке «API ЮKassa»:
    • Платежи: создание, просмотр, подтверждение, отмена
    • Способы оплаты: сохранение и использование
    • Возвраты: создание, просмотр
    • Счета: только просмотр
  5. Блоки «Кошелёк ЮMoney» и «Профиль ЮMoney» не отмечай — это права на личный кошелёк, а не на магазин. С ними ЮKassa не выдаст доступ: «Не получилось выдать доступ. Попробуйте ещё раз»
  6. Сохрани приложение и открой его — внутри Client ID и Client Secret. Копируй их иконкой копирования справа: секрет длинный и переносится на вторую строку, выделением легко захватить не всё

Поменял доступы у уже созданного приложения — нажми «Сгенерировать новый Client Secret» и внеси новый секрет в СРМ (карандаш в строке записи), а потом заново запроси код подтверждения

Подробнее об OAuth-авторизации: документация ЮКассы

Важно: Client Secret используется для приёма реальных платежей. Храни его в безопасности и не передавай третьим лицам

Шаг 4: Настройка в СРМ#

Теперь у тебя есть Shop ID, Client ID и Client Secret. Переходим в СРМ:

4.1. Добавление записи#

  1. Открой раздел Интеграции → таб «Оплата» → карточка ЮKassa
  2. Нажми «Добавить»
  3. В модальном окне введи:
    • Shop ID — идентификатор магазина из ЮКассы
    • Client ID — из OAuth-приложения
    • Client Secret — из OAuth-приложения
    • Ставка НДС — попадёт в чек каждой оплаты, подробнее в шаге 5
    • Метка — произвольное название для удобства (например, «Для ТТ Петроградская»)
    • Торговые точки — мультиселект: выбери одну или несколько точек (можно «выбрать все свободные»). На каждой точке работает один эквайринг — точки, уже занятые другим (ЮKassa или Яндекс.Пэй), в списке недоступны
  4. Нажми «Добавить»

4.2. OAuth-авторизация#

  1. В таблице в колонке «Действия» нажми иконку цепочки (Запросить код подтверждения) — откроется сайт ЮКассы
  2. На сайте ЮКассы выдай разрешения для приложения
  3. Скопируй полученный код подтверждения (7-значное число)

4.3. Ввод кода подтверждения#

  1. Вернись в СРМ
  2. В колонке «Действия» нажми следующую иконку (Ввести код подтверждения)
  3. Введи 7-значный код в поле ввода
  4. Нажми «Сохранить код»

Если всё сделано правильно, в колонке «OAuth» статус сменится на «Подключено» — онлайн-оплата и возвраты по заказам готовы к работе.

Шаг 5: Чеки (54-ФЗ)#

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

5.1. Включи «Чеки от ЮKassa»#

  1. Войди в личный кабинет ЮKassa
  2. Настройки → раздел «Чеки от ЮKassa» → «Подключить Чеки от ЮKassa»
  3. Укажи систему налогообложения (УСН, АУСН, ОСН, патент) и ставку НДС по умолчанию
  4. Сохрани

5.2. Выбери ту же ставку НДС в СРМ#

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

СтавкаКому обычно подходит
Без НДСсамозанятые, ИП и ООО на УСН без НДС, АУСН, патент
НДС 5% или 7%УСН с доходом выше порога, если выбраны пониженные ставки
НДС 10%отдельные категории товаров по закону
НДС 22%общая система (ОСН) и УСН на общей ставке

Ставка в СРМ должна совпадать с той, что указана в «Чеках от ЮKassa». Не уверен — спроси бухгалтера.

Нямбот сам узнаёт у ЮKassa, включены ли у магазина чеки, — это видно в колонке «Чеки» таблицы. Если там «Включены» с восклицательным знаком, ставка не выбрана: пока её нет, онлайн-оплата не пройдёт.

5.3. Что видит гость#

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

Поле «Почта для чека» есть не всегда. Гость видит его, только если у магазина включены «Чеки от ЮKassa» (в СРМ в колонке «Чеки» — «Включены») и выбрана оплата «Онлайн». Чеки выключены — поля нет, оплата идёт без чека от ЮKassa. При оплате наличными или картой при получении почту не спрашиваем никогда.

Что в чеке. Блюда, доставка и приборы. Доставка и приборы — по той цене, которую видел гость; скидки и бонусы разложены по блюдам так, что итог чека равен сумме оплаты до копейки. Строки по 0 ₽ в чек не попадают: подарки по акции, бесплатная доставка и приборы на точке с кассой (там они для гостя бесплатные). Если к оплате не ноль, а в заказе одни подарки, в чеке будет одна строка «Заказ». Те же строки Нямбот передаёт и Яндекс.Пэй — правило чека одно на оба эквайринга.

Чек возврата. К возврату Нямбот прикладывает тот же состав, что был в чеке оплаты, и ЮKassa пробивает чек возврата. Если оплата прошла без чека (чеки включили позже), возврат тоже уйдёт без чека.

5.4. Касса iiko: не пробей чек второй раз#

Если у тебя iiko, проверь тип оплаты «Онлайн» в iikoOffice (Розничные продажи → Типы оплат → «Онлайн»): галка «Является фискальным» должна быть снята. Иначе касса при закрытии заказа пробьёт второй чек на те же деньги. Подробнее — Частые проблемы iiko.

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

Тестирование оплаты#

Для проверки работы оплаты:

  • Создай тестовую позицию с минимальной ценой (например, 1 р.)
  • Оформи заказ и оплати реальной картой
  • Убедись, что оплата прошла и заказ появился в СРМ
  • После проверки оформи возврат через СРМ или просто удали тестовую позицию

Выплаты#

Деньги от покупателей поступают на счёт ЮКассы и выплачиваются на расчётный счёт по расписанию (ежедневно или по запросу, зависит от договора). Настраивается в личном кабинете ЮКассы.

Часто встречающиеся проблемы#

ПроблемаРешение
«Оплата недоступна» в мини-приложенииПроверь, что OAuth-статус «Подключено» в СРМ на табе Онлайн-оплата
Платёж «завис» в статусе «Ожидает»Обратись в поддержку Нямбота. Настройки уведомлений в личном кабинете ЮКассы тут не помогут: по платежам, созданным через Нямбот, ЮКасса шлёт уведомления по подпискам, которые Нямбот заводит сам
Магазин на модерацииДождись одобрения, обычно 1–3 рабочих дня
OAuth-статус «Истёк»Повтори авторизацию: запроси код подтверждения и введи новый код в СРМ
«Не получилось выдать доступ» на сайте ЮKassaВ OAuth-приложении отмечены блоки «Кошелёк ЮMoney» или «Профиль ЮMoney». Сними их (шаг 3), перевыпусти Client Secret, внеси его в СРМ и запроси код заново
«Не удалось завершить подключение ЮKassa» при вводе кодаКод одноразовый и живёт недолго — запроси новый. Не помогло: перевыпусти Client Secret в приложении ЮKassa, внеси его в СРМ через карандаш и повтори
Гость не может оплатить онлайн, в колонке «Чеки» восклицательный знакУ магазина включены «Чеки от ЮKassa», а ставка НДС в СРМ не выбрана — выбери её (шаг 5.2)
Гость не видит поле «Почта для чека»Так и должно быть, если у магазина не включены «Чеки от ЮKassa» — проверь колонку «Чеки» в СРМ. Включил чеки уже после подключения — Нямбот заметит это сам на ближайшей онлайн-оплате: гость увидит «Заведение только что обновило настройки оплаты — попробуй оплатить ещё раз», поле почты появится сразу, и повторная оплата пройдёт. Тебе придёт уведомление, а если ставка НДС не выбрана — выбери её (шаг 5.2). Чтобы гость не встретил этот повтор, после включения чеков заново запроси и введи код подтверждения (шаг 4.2)
Гостю не пришёл чекЧек уходит на почту, которую гость указал при оплате, — попроси проверить папку «Спам». Все чеки видны в личном кабинете ЮKassa

Связь с другими разделами#