ЮKassa: магазин вашей организации

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

Подключение нужно ровно для одного — принимать деньги клиентов за визиты. Ваша собственная подписка на IZZI CRM оплачивается отдельно и от этих реквизитов не зависит: это разные счета и разные магазины.

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

Реквизиты магазина сохраняются без проверки связи — и это не недосмотр. У терминала Т-Кассы есть безопасная проба, которая ничего не создаёт, и там кабинет не даст сохранить непроверенную пару; у ЮKassa такой пробы нет, а кнопка, которая ничего не проверяет, хуже её отсутствия. Поэтому первую оплату сделайте пробной: ошибку в паре shopId/секрет покажет именно она.

1. Возьмите реквизиты в кабинете ЮKassa

Откройте личный кабинет ЮKassa → «Интеграция» → «Ключи API».
Скопируйте идентификатор магазина (shopId) — это цифры, обычно 5–6.
Выпустите секретный ключ и скопируйте его целиком. ЮKassa показывает ключ один раз — сохраните его до того, как закроете окно.

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

2. Впишите их в кабинет

Откройте Настройки → Приём платежей → ЮKassa и заполните два поля. Настройка доступна владельцу и администратору (право tenant:write) — это реквизиты организации, на чей счёт приходят деньги.

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

3. Основная система — та, через которую пойдут деньги

Платёжных систем можно подключить несколько (ЮKassa и Т-Банк). Принимает деньги одна — основная, и она отмечена на экране «Приём платежей» бейджем ★ Основная.

Одна подключённая система — сама себе основная. Выбирать ничего не нужно.
Две и больше — выбор обязателен. Пока он не сделан, онлайн-оплата не работает вовсе: кабинет не угадывает получателя денег. Каталог интеграций покажет обе плитки жёлтыми и назовёт причину.
Смена основной — действие с подтверждением: новые оплаты сразу пойдут в другую систему, уже принятые досверяются там, где были созданы.

4. Тумблер «Принимать новые онлайн-оплаты»

Снятая галочка означает «новых оплат не принимаем»: клиент не получит ссылку на оплату, а администратору кабинет скажет об этом словами. Уже принятые оплаты досверяются в любом случае — иначе тумблер терял бы деньги, уже списанные у клиентов.

5. Что подключение ЮKassa умеет и чего НЕ делает

Точный список — прямо на карточке системы, в блоке «Доступные способы приёма». Он не написан от руки: кабинет показывает то, что реально умеет подключение, и если там «нет», то соответствующая кнопка откажет словами, а не попробует и промолчит.

Возврат из кабинета работает. Вернуть оплату визита — полностью или частично — можно прямо из карточки визита, как и по Т-Банку: деньги уходят плательщику обратно через ЮKassa, а визит и график пересчитываются сами. Возврат необратим и не «примеряется»: если ЮKassa не подтвердила его, кабинет так и скажет, а оплата останется на месте.
Чек 54-ФЗ выдаётся, если к магазину подключена онлайн-касса ЮKassa. Это отдельная услуга в её кабинете (раздел «Онлайн-касса»), и включить её за вас мы не можем — но, когда она у вас есть, чек уходит клиенту автоматически с каждой оплаты и с каждого возврата, от имени вашей организации и по вашей СНО. Настройка — в блоке «Чек 54-ФЗ» на этой же странице, см. раздел 5а ниже. У Т-Банка то же самое делает сам терминал — карточка терминала.
Кнопки «Проверить связь» нет. У Т-Банка проба существует потому, что у него есть безопасный запрос, который ничего не создаёт; у ЮKassa такого в подключении не реализовано. Кнопка, которая ничего не проверяет, хуже её отсутствия: зелёная галочка над непроверенными реквизитами — обещание, за которое платит первый живой клиент.
Автоплатёж и рассрочка («Подели») не подключаются — ни у ЮKassa, ни у Т-Банка: в оплате визитов клиент подтверждает каждый платёж сам. СБП включается на стороне ЮKassa, в её личном кабинете, — отдельного тумблера в CRM для него нет.

5а. Чек 54-ФЗ: включается вашим объявлением

Блок «Чек 54-ФЗ» на карточке ЮKassa — это ваше объявление, а не автоопределение. Подключена ли к магазину онлайн-касса, ЮKassa нам не сообщает: это видно только в её личном кабинете. Поэтому галочку ставите вы.

Ошибка в галочке ломает приём оплат в обе стороны, и одинаково молча. Поставили, а кассы нет — ЮKassa отклонит платёж с чеком. Не поставили, а касса есть — отклонит платёж без чека. Клиент в обоих случаях увидит «оплата недоступна» и не поймёт почему. Сверьтесь с разделом «Онлайн-касса» в кабинете ЮKassa, прежде чем менять положение.

СНО и ставка НДС — ваши. Чужая система налогообложения в чеке делает чек недействительным, поэтому берите их из своих документов, а не из примера. На УСН и патенте ставка НДС — «Без НДС».
Версия ФФД указана в настройках вашей кассы у ОФД. Если не знаете — 1.2 — действующая.
Чек уходит на контакт КЛИЕНТА — e-mail или телефон из его карточки. Если ни того ни другого нет, оплата не создастся вовсе, и кабинет скажет об этом словами: чек нельзя «догнать» после платежа, а непроведённую оплату клиент повторит. Поле «E-mail организации по эквайрингу» в чек НЕ подставляется — это адрес для писем платёжной системы вам.
Возврат тоже с чеком. Когда касса объявлена, вместе с возвратом уходит «возврат прихода» — иначе в ОФД получилось бы расхождение.

6. Как отключить систему

Кнопка «Отключить» внизу карточки удаляет реквизиты магазина. Кабинет перед этим говорит, что именно произойдёт, — и это не формальность:

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

7. Как понять, что всё работает

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

8. Частые вопросы

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