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

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

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

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

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

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

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

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

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

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

## Подключение

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

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

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

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

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

Что означают коды ошибок, которые иногда попадают в такие сообщения, собрано в [справочнике ошибок](/reference/errors/).

## Налоговый режим

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

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

| Что вы увидите                                  | Почему                                                                   |
| ----------------------------------------------- | ------------------------------------------------------------------------ |
| Для выбранного режима доступно только «Без НДС» | На автоматизированной упрощённой и на патенте другая ставка не подходит. |

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

## Фискализация

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

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

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

## Если вы вернулись позже

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