Подключение оплаты ЮKassa в ClientRec
ClientRec принимает онлайн-оплату услуг от ваших клиентов через ЮKassa (банковские карты, СБП, ЮMoney, SberPay). Ниже — как подключить за несколько минут. Интеграция выполнена напрямую по API ЮKassa (Smart Payment): встроенная форма или перенаправление, чеки 54-ФЗ, обработка HTTP-уведомлений, возвраты.
Что нужно заранее — Действующий магазин в ЮKassa (yookassa.ru). Если магазина нет — зарегистрируйте его и дождитесь активации. — Из личного кабинета ЮKassa понадобятся shopId и секретный ключ (раздел Интеграция → Ключи API).
Шаг 1. Получить ключи в ЮKassa Войдите в личный кабинет ЮKassa → Интеграция → Ключи API → скопируйте shopId и выпустите секретный ключ (live_… — для боевого приёма, test_… — для проверки в тестовом режиме).
Шаг 2. Ввести ключи в ClientRec Откройте Настройки → Оплата → блок «Онлайн-оплата клиентами — ЮKassa». 1) Вставьте shopId и секретный ключ. 2) Выберите «Место оплаты»: «Встроенная форма на сайте» — клиент платит, не покидая ClientRec (рекомендуется); либо «Перенаправление на ЮKassa». 3) «Чеки 54-ФЗ» — включите, если к магазину подключена онлайн-касса (для чека нужен email или телефон клиента). Если онлайн-кассы нет — выключите. 4) Нажмите «Сохранить» — появится статус «Подключено».
Шаг 3. Настроить уведомления (webhook) в ЮKassa Чтобы оплата автоматически отмечалась в ClientRec: 1) Скопируйте «URL для уведомлений» из того же экрана (кнопка копирования рядом с полем). 2) В ЛК ЮKassa: Интеграция → HTTP-уведомления → вставьте URL → включите событие payment.succeeded (можно также refund.succeeded).
Шаг 4. Включить способы оплаты в ЮKassa В ЛК ЮKassa: Настройки → Способы оплаты — убедитесь, что включены нужные методы (карты, СБП, ЮMoney, SberPay). Встроенная форма ClientRec автоматически покажет клиенту все включённые методы.
Как принять оплату — В карточке клиента → «Принять оплату» → способ «Онлайн» → откроется форма ЮKassa. — Либо «Запросить оплату» — клиенту уйдёт ссылка/QR на оплату. — После оплаты платёж в истории станет «успешно» (по уведомлению от ЮKassa).
Возврат В истории оплат клиента у онлайн-платежа есть действие «Вернуть» — деньги возвращаются клиенту через ЮKassa, формируется чек возврата (если включены чеки 54-ФЗ).
Тестовый режим Перед боевым приёмом настройки можно проверить: в ЮKassa создайте тестовый магазин и используйте ключ test_… (оплата тест-картами, тот же интерфейс).
Если что-то не работает — Платёж создаётся, но не отмечается оплаченным → проверьте webhook (Шаг 3). — Ошибка про чек (54-ФЗ) → добавьте клиенту email или телефон, либо выключите передачу чеков, если онлайн-кассы нет. — Прочие вопросы по магазину/способам оплаты — поддержка ЮKassa: 8 800 350-46-56.