Перейти к содержимому

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

Что подготовить до начала, как пройти шаги мастера подключения и что делать, если подключение не завершилось.

Подключение проходят в мастере. Он открывается с карточки ЮKassa в настройках платежей, а ещё из блока запуска на главной странице личного кабинета. Шагов три, а если чеки по 54-ФЗ у провайдера не настроены — четыре.

Мастер открывается поверх той страницы, с которой вы пришли; если его закрыть, вы вернётесь туда же. Выйти можно и кнопкой Отмена, но она стоит только на первом шаге. На остальных вторая кнопка — Назад, и она ведёт на шаг назад, а не наружу. Пройденное не пропадёт: в следующий раз мастер откроется на том шаге, где вы остановились.

На первом шаге ничего не сохраняется — на нём перечислено, что нужно иметь до начала.

  • Аккаунт в ЮKassa с активированным магазином. Если аккаунта нет, на шаге есть ссылка на регистрацию.
  • Настроенные чеки по 54-ФЗ — у самой ЮKassa или у стороннего оператора. Ссылка на инструкцию тоже стоит на этом шаге.

Там же сказано, чем покупатели смогут платить — картой, через СБП и кошельком. Рядом указано, что деньги приходят на расчётный счёт за 1–3 рабочих дня, а само подключение занимает около пяти минут.

Отдельной строкой на шаге сказано про тестовый режим.

Что написано на шагеЧто это значит
В тестовом режиме витрину можно проверить целиком, включая оплату. Первый реальный платёж пройдёт только после переключения на рабочий режим.Отрепетировать можно всё, кроме одного — перехода в рабочий режим. Режим переключают в личном кабинете ЮKassa, в настройках платежей такой кнопки нет.

На втором шаге вы переходите на страницу ЮKassa, где нужно подтвердить доступ к магазину. Кнопка для этого на шаге одна, и нажать её может только владелец магазина.

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

Что может пойти не так:

  • подключение отклонено на стороне ЮKassa — в том числе когда доступ не подтвердили вы сами;
  • ссылка возврата устарела или относится к другому аккаунту — подключение придётся начать заново;
  • подключилось не всё — появится предупреждение и кнопка, чтобы повторить.

В первых двух случаях вы останетесь на этом же шаге и увидите сообщение о причине.

Что означают коды ошибок, которые иногда попадают в такие сообщения, собрано в справочнике ошибок.

Третий шаг — налоги. Выбранная система налогообложения указывается в каждом чеке, поэтому без неё подключение не считается завершённым.

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

На шаге стоит предупреждение: выбранный режим должен совпадать с настройками вашей онлайн-кассы в ЮKassa, иначе чек может не пробиться. Там же ссылка на личный кабинет ЮKassa, чтобы это проверить.

Четвёртый шаг появляется только тогда, когда кассы нет ни у самой ЮKassa, ни у стороннего оператора. Если чеки формирует сторонний оператор, этого шага не будет. На шаге сказано, что чеки по 54-ФЗ формироваться не будут — ни платформой, ни ЮKassa, — и что включить фискализацию можно в личном кабинете ЮKassa.

Чтобы закрыть шаг, отметьте флажок о том, что чеки вы формируете сами, вне платформы, и подтвердите. Без отметки шаг не закроется.

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

Мастер открывается на том шаге, где вы остановились: не указан налоговый режим — сразу на налогах, не подтверждена фискализация — на ней. Когда подключение уже завершено, мастер не откроется, и вы окажетесь там, откуда его открыли. Из настроек платежей это страница провайдера, из блока запуска — главная страница личного кабинета.