Мастеру · Бизнесу

Онлайн-оплата: ЮKassa своими ключами

Предоплата за запись, абонементы и сертификаты картой и СБП: регистрация в ЮKassa, ключи, чеки, возвраты, где видно оплаты

Онлайн-оплата — это когда клиент платит картой, СБП или SberPay прямо при записи, покупке абонемента или сертификата, а деньги приходят на ваш счёт. Оплату принимает ЮKassa — платёжный сервис Сбера и ЮMoney; ключи от вашего магазина в ЮKassa вы один раз вставляете в кабинет, дальше всё идёт само: платёж, чек, отметка «оплачено» в карточке записи, возврат при отмене. Сервис klientsy комиссию не берёт — только ЮKassa по своему тарифу (обычно 2,8–3,5 % с платежа).

Коротко: ключи и предоплата — Настройки → «Оплата онлайн» (точка: Моя точка → Настройки → «Онлайн-оплата»). Адрес уведомлений ЮKassa даём МЫ, а не ЮKassa: в блоке «Уведомления ЮKassa» — https://klientsy.ru/api/pay/yookassa и кнопка «Скопировать». Этот адрес вставляете в кабинете ЮKassa: Интеграция → HTTP-уведомления, события payment.succeeded, payment.canceled, refund.succeeded. Вернуть предоплату, в том числе частично: карточка клиента → «Оплаты онлайн» → «Вернуть» → сумма.

Где включается: Настройки → Оплата онлайн. Одинаково для мастера и для точки. Без ключей всё работает как раньше — запись без оплаты, абонемент заявкой, сертификат вручную.

Как подключить ЮKassa: пошагово

ЮKassa — сервис приёма онлайн-оплат от Сбера (yookassa.ru). Клиенты платят картой, СБП или SberPay, деньги приходят на ваш счёт. Мы к деньгам доступа не имеем: вы подключаете свой магазин и вставляете его ключи в настройки.

Регистрация. Зайдите на yookassa.ru → «Подключиться». Выберите, кто вы: самозанятый, ИП или ООО. Понадобятся паспорт/ИНН, для ИП и ООО — расчётный счёт.
Договор. Заполните анкету и подпишите договор онлайн. Проверка занимает обычно 1–3 рабочих дня. В поле «сайт» укажите вашу страницу записи: klientsy.ru/ваш-адрес (у точки — адрес страницы салона).
Ключи API. В личном кабинете ЮKassa: «Интеграция» → «Ключи API». Скопируйте shopId (номер магазина) и нажмите «Выпустить секретный ключ» — ключ показывается один раз, сразу скопируйте его.
Вставьте ключи к нам. Мастер: Настройки → «Онлайн-оплата». Точка: Моя точка → Настройки → «Онлайн-оплата». Поля «shopId» и «Секретный ключ» → «Сохранить». Мы сразу проверим, что ключи рабочие.
Адрес уведомлений. В ЮKassa: «Интеграция» → «HTTP-уведомления». Вставьте адрес из наших настроек (кнопка «Скопировать» рядом) и отметьте события: payment.succeeded, payment.canceled, refund.succeeded. Так запись подтверждается сразу после оплаты, даже если клиент закрыл страницу.
Проверка на тестовом магазине. В ЮKassa можно создать тестовый магазин со своими ключами (начинаются с test_). Оплатите свою же запись тестовой картой 5555 5555 5555 4477, срок любой в будущем, CVC 123, код подтверждения 12345. Деньги не списываются.
Боевой режим. Когда проверили — замените ключи тестового магазина на ключи настоящего и включите предоплату.

Комиссия ЮKassa — около 3,5 % с платежа (точный тариф в договоре), её удерживает ЮKassa. Мы комиссию не берём.
Деньги приходят на ваш счёт обычно на следующий рабочий день.
Чеки (54-ФЗ): самозанятому — чек в «Мой налог» по каждой оплате; ИП и ООО — своя онлайн-касса или услуга «Чеки от ЮKassa».

Секретный ключ никому не пересылайте. Если он попал в чужие руки — выпустите новый в ЮKassa и замените у нас в настройках.

Как вернуть предоплату

Клиент передумал и просит вернуть деньги — это делается в пару нажатий, в ЮKassa заходить не нужно.

Автоматически: клиент отменил запись раньше срока возврата (настройка «Возврат при отмене») — деньги уходят обратно сами.
Вручную из записи: карточка записи → блок «Предоплата» → «Вернуть».
Вручную из карточки клиента: блок «Оплаты онлайн» — все его платежи; у каждого «Вернуть», можно вернуть всю сумму или часть.
Деньги возвращаются на ту же карту/счёт, обычно за 1–3 дня (зависит от банка). Клиенту приходит сообщение о возврате.

Если ключи ЮKassa удалены или магазин отключён, вернуть через нас не получится — сделайте возврат в личном кабинете ЮKassa («Платежи» → платёж → «Вернуть»).

Кто может вернуть деньги

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

Опоздавшие платежи и перенос

Каждые 5 минут сервис сам сверяет с ЮKassa платежи за последние часы: если клиент оплатил, а отметка не пришла, запись подтвердится сама.
Время на оплату истекло — бронь снимается, клиенту уходит «Предоплата не поступила — время освободилось». Если деньги всё же пришли после этого, они возвращаются автоматически целиком, а клиент видит «Бронь уже отменена — деньги вернутся». Если автовозврат не прошёл, мастеру придёт сообщение — верните вручную.
Перенос не обходит срок возврата: окно «без возврата» считается от первоначального времени визита. Внутри него клиент не может сам перенести оплаченную запись — «Перенести уже нельзя — напишите мастеру».
Отменил мастер или сервис — предоплата возвращается полностью.

Регистрация в ЮKassa

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

Где взять ключи

Войдите в кабинет ЮKassa и откройте магазин (если магазинов несколько — тот, на который должны приходить деньги).
Слева: Интеграция → Ключи API. Здесь виден shopId — число, например 1054321.
Нажмите «Выпустить ключ» — появится секретный ключ вида live_… Скопируйте его сразу: целиком ЮKassa показывает его один раз.
В кабинете klientsy: Настройки → Оплата онлайн → вставьте shopId и секретный ключ, нажмите «Сохранить ключи», затем «Проверить». Если ЮKassa приняла ключи, появится отметка «Подключено · проверено», и можно включить тумблер «Принимать оплату онлайн».

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

Чеки (54-ФЗ)

Чеки клиентам выдаёт ЮKassa: в их кабинете включите «Выдавать чеки» (для самозанятых чек формирует «Мой налог» через ЮKassa, для ИП и ООО — облачная касса ЮKassa или ваша подключённая касса). Мы передаём в платёж состав заказа: название услуги, сумму, ставку НДС из настроек и контакт клиента (почта или телефон) — чек уходит клиенту сам. Самозанятые и УСН работают без НДС — в настройках оставьте «Без НДС». Если чеки не нужны или их выдаёт ваша касса отдельно, выключите тумблер «Чеки выдаёт ЮKassa».

Уведомления от ЮKassa (по желанию)

В настройках оплаты есть блок «Уведомления ЮKassa» с адресом https://klientsy.ru/api/pay/yookassa и кнопкой «Скопировать» — адрес один для всех мастеров и точек. В кабинете ЮKassa: Интеграция → HTTP-уведомления → вставьте адрес → отметьте payment.succeeded, payment.canceled, refund.succeeded → Сохранить. Без уведомлений оплата всё равно подтвердится, когда клиент вернётся на страницу, и сервис сам перепроверяет «зависшие» платежи каждые 5 минут — но с уведомлениями отметка «оплачено» приходит сразу.

Предоплата за запись

Включается в том же разделе. Варианты: «Вся сумма» (100 %), «Часть» (процент от стоимости, но не меньше минимума — например, 30 %, минимум 500 ₽), «Фикс» (одна сумма для всех, например 1 000 ₽). «Только для новых клиентов» — постоянные записываются без предоплаты, как сейчас. «Держим окно» — сколько минут время остаётся за клиентом, пока он платит (по умолчанию 20): не оплатил — окно освобождается, клиенту уходит сообщение «время освободилось».

Как это выглядит у клиента: на странице, в виджете и в боте после выбора времени появляется шаг «Проверьте и оплатите» — услуга, сумма предоплаты, остаток на месте и кнопка «Оплатить». Оплата проходит на странице ЮKassa (карта, СБП, SberPay), после чего клиент видит «Оплачено, вы записаны», а вам приходит уведомление о записи с пометкой «предоплата получена». Запись сразу подтверждена — спрашивать «Придёте?» не нужно.

Что видит клиент до оплаты

На странице записи и в личном кабинете /me — «ждёт предоплаты до HH:MM», сумма и кнопка «Оплатить». Время удержания вышло, но окно свободно — оплатить ещё можно.
Если при записи ЮKassa не ответила, запись не теряется: окно держим, а «Оплатить» на странице записи выпустит платёж заново.
В окне отмены клиент заранее видит, вернётся ли предоплата: «вернётся на карту», «не вернётся — до визита меньше N ч» или «вернётся часть».
Строка «Чек придёт на почту» показывается, только если у вас включены чеки через ЮKassa.
Предоплата получена — мастеру и администраторам точки приходит запись в колокольчик (выключается в настройках уведомлений).

Абонементы и сертификаты

Абонементы: с включённой оплатой «Хочу абонемент» на странице и в боте ведёт сразу к оплате, после неё абонемент активен — без заявки и звонка. В карточке клиента такой абонемент помечен «оплачен онлайн», в «Финансах» — доход с пометкой ЮKassa. Сертификаты: покупка со страницы и из бота, после оплаты сертификат активен и приходит клиенту сразу. Оба тумблера можно выключить отдельно, оставив только предоплату.

Возвраты

«Возврат при отмене раньше чем за N часов»: клиент отменил запись сам за это время или раньше — предоплата возвращается на его карту автоматически; отменил позже или не пришёл — деньги остаются вам. 0 — автоматических возвратов нет. В любой момент вернуть предоплату можно вручную: в карточке записи кнопка «Вернуть предоплату», в карточке брони проживания — «Вернуть предоплату» и «Отменить · возврат по правилам» (там возвращается процент по вашей шкале отмены). Возврат идёт через ЮKassa на ту же карту и занимает от одного до семи дней; в «Финансах» он виден отдельной строкой.

Где видно оплаты

Карточка записи: плашка «Предоплата N ₽ · оплачено онлайн дата · карта •• 1234», ссылка на чек, остаток к оплате на месте; кнопка «Оплатил(а) остаток» проводит остаток как обычную оплату, «Вернуть предоплату» — возврат.
Карточка брони (режим «Проживание»): предоплата «оплачено онлайн · ЮKassa», кнопки возврата.
Карточка клиента → Абонементы: пометка «оплачен онлайн».
Финансы → «Деньги вперёд»: строка «Онлайн через ЮKassa» за период; Финансы → Онлайн-оплаты: список платежей по одному — дата, клиент, за что, сумма, способ, статус, возврат, ссылки на чек и в карточку.

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

Нужен ли расчётный счёт? Самозанятому — нет, ЮKassa выплачивает на карту. ИП и ООО — да, по реквизитам.
Куда приходят деньги и когда? На ваш счёт в ЮKassa, выплаты по расписанию ЮKassa (обычно на следующий рабочий день) за вычетом их комиссии. Сервис klientsy к деньгам не прикасается.
Клиент оплатил, а запись не отметилась? Откройте Финансы → Онлайн-оплаты: если платёж «ждём» — обновите через минуту, мы перепроверяем в ЮKassa; если «не прошло» — деньги не списаны, клиент может попробовать снова по той же ссылке.
Как проверить, что всё работает? Кнопка «Проверить» в настройках подтверждает ключи. Дальше запишитесь к себе с предоплатой 1–2 ₽ (временно «Фикс» = 1 ₽) и оплатите — платёж появится в Финансах, потом верните его из карточки записи.
Можно ли включить оплату только для новых клиентов? Да, тумблер «Только для новых клиентов» в блоке предоплаты.
Что с тестовым магазином ЮKassa? Тестовые ключи (test…) работают так же, но деньги не списываются — удобно для проверки. Не забудьте заменить на боевые (live…).

Предоплата в точке (салоне)

У точки свои ключи ЮKassa и свои правила предоплаты: Настройки точки → «Онлайн-оплата». Деньги клиентов приходят сразу на счёт точки. По умолчанию выключено — запись в точку идёт как раньше. Страницу открывают владелец и управляющий; ключи ЮKassa меняет только владелец (или человек с «Полным доступом») — на этот магазин приходят деньги.

Сколько брать: «Вся сумма», «Часть» (процент + «Но не меньше, ₽») или «Фикс».
«Держим окно, минут» (5–120): не оплатил за это время — запись снимается, абонемент, места сертификата и баллы возвращаются.
«Только новым клиентам» — кто уже был в этой точке хотя бы раз, записывается без предоплаты.
«Предоплата только для услуг дороже, ₽» — 0 — для всех услуг; например 3000 — дешёвые услуги без предоплаты.
«Для каких мастеров» — «Все мастера точки» или «Выбрать…». В списке только мастера в пуле; нового мастера при «Выбрать…» отметьте вручную.
«Возврат при отмене раньше чем за, часов» — раньше срока деньги возвращаются сами, позже — остаются у точки (клиент видит это заранее). 0 — только вручную.
«НДС в чеке» и «Чеки выдаёт ЮKassa» — для чеков по 54-ФЗ.

Абонементы и сертификаты на странице салона пока оплачиваются через ЮKassa владельца (его личные настройки «Оплата онлайн»), и эти оплаты видны в личных «Финансах» владельца, а не в «Онлайн-оплатах точки». На странице оплаты точки об этом говорит блок «Абонементы и сертификаты».

Предоплата работает везде, где записываются в точку: страница салона, бот салона, ИИ-помощница в диалогах и запись мастером в точку. После оплаты клиенту приходит «Предоплата получена — вы записаны», мастеру и администраторам — «внесла предоплату». Все платежи точки — Финансы → «Онлайн-оплаты точки →» (право «Видит онлайн-оплаты и предоплаты»). Личные записи мастера на его странице оплачиваются по его личным настройкам.

Предоплата и ИИ-помощница

Помощница знает правила предоплаты для каждого клиента (ваши или точки, «только новым», выбранные мастера). Если предоплата нужна — она называет точную сумму в рублях для выбранной услуги («Для записи нужна предоплата 900 ₽ — ссылку на оплату пришлю сразу после подтверждения»), а не процент. Если предоплата выключена или не нужна этому клиенту — о предоплате не говорит вообще.

Точные названия кнопок у мастера

1
Откройте раздел
Настройки → Все настройки → плитка «Оплата онлайн».
2
Вставьте ключи
Блок «ЮKassa — ваш магазин»: поля «shopId» и «Секретный ключ» → «Сохранить ключи».
3
Проверьте
Кнопка «Проверить». Появится «Подключено · проверено …».
4
Включите
Тумблер «Принимать оплату онлайн» — кнопка «Оплатить» появится на странице, в виджете и в боте.
5
Уведомления
Блок «Уведомления ЮKassa» → «Скопировать» адрес и вставить его в ЮKassa: Интеграция → HTTP-уведомления.
6
Правила
«Предоплата за запись», «Абонементы и сертификаты», «Возврат при отмене и чеки» — у каждого блока своя кнопка «Сохранить» (тумблеры абонементов и сертификатов сохраняются сразу).