Нямбот
НЯМБОТРуководство

ЮКасса

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

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

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

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

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

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

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

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

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

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

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

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

  1. Перейди на страницу создания OAuth-приложений
  2. Создай новое приложение
  3. Нажми «Редактирование приложения» — внутри увидишь Client ID и Client Secret
  4. Скопируй оба значения

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

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

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

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

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

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

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

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

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

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

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

Шаг 5: Настройка чеков (54-ФЗ)

По закону при онлайн-оплате покупатель должен получить электронный чек. ЮКасса умеет отправлять чеки автоматически — нужно только включить эту функцию.

  1. Войди в личный кабинет ЮКассы
  2. Перейди в Настройки → раздел «Чеки от ЮKassa»
  3. Нажми «Подключить Чеки от ЮKassa»
  4. Укажи систему налогообложения (УСН, АУСН, ОСН, патент — в зависимости от твоей формы)
  5. Задай ставку НДС по умолчанию:
    • Без НДС — для самозанятых, ИП на УСН/АУСН/патенте
    • НДС 20% — для ООО и ИП на ОСН
  6. Сохрани настройки

После подключения ЮKassa будет автоматически формировать и отправлять чеки покупателям при каждой оплате и возврате. Тебе не нужна отдельная онлайн-касса — всё работает через облачную кассу ЮKassa.

Важно: Без подключённых чеков ты нарушаешь 54-ФЗ. Подключи чеки сразу после настройки OAuth

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

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

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

Выплаты

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

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

ПроблемаРешение
«Оплата недоступна» в мини-приложенииПроверь, что OAuth-статус «Подключено» в СРМ на табе Онлайн-оплата
Платёж «завис» в статусе «Ожидает»Проверь webhook-настройки в ЮКассе или обратись в поддержку Нямбота
Магазин на модерацииДождись одобрения, обычно 1–3 рабочих дня
OAuth-статус «Истёк»Повтори авторизацию: запроси код подтверждения и введи новый код в СРМ

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