ЮKassa — платёжный сервис от Сбера. Через неё клиенты оплачивают ваши услуги банковской картой, через СБП, SberPay и другими способами из вашего договора. Деньги зачисляются на ваш расчётный счёт, а оплата автоматически появляется в Master Clients.
Что понадобится: ИНН и данные компании (ИП, ООО или самозанятого), расчётный счёт в любом банке, доступ администратора в Master Clients. Займёт около 15 минут вашего времени и 1–3 рабочих дня на проверку в ЮKassa.
Шаг 1. Подготовьте страницу компании#
При подключении ЮKassa проверяет сайт, на котором будут приниматься платежи. Укажите свою страницу в Master Clients. Её адрес есть в Настройки → Основные → Страница компании, например https://masterclients.pro/ваш-адрес.
Перед подачей заявки проверьте, что на странице есть:
- описание услуг и цены в рублях (раздел «Услуги» с включённым показом цен в онлайн-записи);
- контакты: телефон, email и адрес;
- название компании или ФИО предпринимателя и ИНН — заполните Настройки → Реквизиты и счета, они появятся в блоке «Продавец»;
- условия оплаты, отмены записи и возврата предоплаты. Они уже есть: Master Clients создаёт для вас страницу
https://masterclients.pro/ваш-адрес/terms— проверьте и при необходимости измените её в Настройки → Онлайн-запись → Условия отмены и возврата. Там же видно, заполнены ли реквизиты для блока «Продавец».
Чем полнее страница, тем быстрее модерация. Чаще всего заявку возвращают из-за отсутствия цен, контактов или условий возврата.
Шаг 2. Заключите договор с ЮKassa#
- ЗарегистрируйтесьОткройте yookassa.ru и нажмите «Подключиться». Войдите через Сбер ID или создайте аккаунт.
- Заполните анкетуУкажите ИНН — данные компании подтянутся сами. Выберите сферу «Услуги» и в поле сайта укажите адрес вашей страницы из шага 1.
- Подпишите договорДоговор подписывается онлайн, без визита в офис. После проверки ЮKassa пришлёт письмо, что магазин активирован.
Шаг 3. Скопируйте shopId и секретный ключ#
- Откройте ключи APIВ личном кабинете ЮKassa выберите ваш магазин и откройте Интеграция → Ключи API.
- shopIdЭто номер магазина из цифр, например
123456. Скопируйте его. - Секретный ключНажмите «Выпустить секретный ключ» и скопируйте его. Боевой ключ начинается с
live_, ключ тестового магазина — сtest_.
Секретный ключ даёт доступ к платежам магазина. Не отправляйте его в мессенджерах и не публикуйте. Полностью ключ обычно показывается один раз — если потеряли, выпустите новый и замените его в Master Clients. В Master Clients ключ хранится в зашифрованном виде.
Шаг 4. Подключите ЮKassa в Master Clients#
- Откройте интеграциюВойдите в Master Clients и откройте Настройки → Интеграция. В блоке «Онлайн-оплата» нажмите на плитку ЮKassa — справа откроется панель настройки.
- Вставьте ключиВставьте shopId и секретный ключ.
- Чеки 54-ФЗЕсли вы подключили чеки в ЮKassa (шаг 6), включите «Отправлять чеки через ЮKassa». Если ещё нет, оставьте выключенным и вернитесь позже.
- Нажмите «Подключить»Master Clients сразу проверит ключи в ЮKassa. Если всё верно, плитка станет «Подключено». Для тестового магазина будет написано «Подключено · тестовый режим».
Если подключены и ЮKassa, и Т-Банк, отметьте галочку «Основная касса для ссылок на оплату и онлайн-записи» у той кассы, через которую клиенты будут платить.
Шаг 5. Включите HTTP-уведомления#
Уведомления — это сообщения от ЮKassa о том, что клиент оплатил. С ними оплата появляется в Master Clients через несколько секунд.
- Скопируйте адресВ панели ЮKassa в Master Clients, в шаге «HTTP-уведомления», нажмите кнопку копирования рядом с адресом. Он выглядит так:
https://masterclients.pro/pay/hook/yookassa/123, где 123 — номер вашей компании. - Вставьте в ЮKassaВ кабинете ЮKassa откройте Интеграция → HTTP-уведомления и вставьте адрес в поле «URL для уведомлений».
- Отметьте событияОтметьте
payment.succeeded,payment.canceledиrefund.succeededи сохраните.
Даже если уведомление не дойдёт, Master Clients сам проверит оплату у ЮKassa в течение 15 минут, и платёж всё равно появится. Без уведомлений просто дольше. При каждом уведомлении Master Clients перепроверяет платёж запросом к ЮKassa с вашим ключом, поэтому поддельное уведомление не засчитает оплату.
Шаг 6. Чеки 54-ФЗ#
При онлайн-оплате нужно выдать клиенту электронный чек. ЮKassa предлагает два варианта:
| Вариант | Как подключить | Кому подходит |
|---|---|---|
| Чеки от ЮKassa | В кабинете ЮKassa откройте раздел про чеки и подключите облачную кассу ЮKassa. Понадобится договор с оператором фискальных данных (ОФД) — ЮKassa подскажет шаги. | Нет своей онлайн-кассы для интернет-продаж |
| Своя онлайн-касса | Подключите в кабинете ЮKassa вашу облачную кассу (например, АТОЛ Онлайн или другую из списка ЮKassa). | Уже есть облачная касса |
После этого в Master Clients:
- Откройте Настройки → Реквизиты и счета и укажите систему налогообложения и НДС. Эти данные попадут в чек.
- В панели ЮKassa включите «Отправлять чеки через ЮKassa» и сохраните.
Чек уходит на телефон или email клиента из его карточки, поэтому у клиента должен быть указан хотя бы один из них. Предоплата за будущую услугу пробивается с признаком «полная предоплата», товары — «полный расчёт», пополнение депозита — «аванс».
Самозанятым чек через онлайн-кассу не нужен: вы формируете его в приложении «Мой налог». Если в реквизитах указан НПД, Master Clients не отправляет чек в ЮKassa, даже если галочка включена.
Шаг 7. Проверьте тестовой оплатой#
- Нажмите «Тестовая оплата 10 ₽»Кнопка в панели ЮKassa в Master Clients. Откроется страница оплаты на 10 ₽.
- ОплатитеНа боевом магазине оплатите своей картой (потом можно сделать возврат). В тестовом магазине используйте тестовую карту из документации ЮKassa.
- Проверьте Master ClientsЧерез несколько секунд в разделе Платежи появится входящий платёж на 10 ₽ «Проверка подключения онлайн-оплаты».
Тестовый платёж можно отменить в Платежи, а на боевом магазине — сделать возврат в кабинете ЮKassa.
Переход с тестового магазина на боевой#
Если вы начинали с тестового магазина:
- В кабинете ЮKassa откройте боевой магазин и выпустите ключ
live_…. - В Master Clients откройте панель ЮKassa, вставьте shopId боевого магазина и новый ключ, нажмите «Сохранить».
- Настройте HTTP-уведомления в боевом магазине (шаг 5). Адрес тот же, но настраивается в каждом магазине отдельно.
Отключение#
В панели ЮKassa нажмите «Отключить». Новые ссылки создаваться не будут, а уже оплаченные платежи и история останутся. Если клиент откроет старую неоплаченную ссылку, он увидит, что онлайн-оплата выключена.