Интернет-эквайринг ЮKassa
От кабинета ЮKassa до оплаты в FightCRM: Shop ID, секретный ключ, webhook в ЛК ЮKassa, проверка и способы оплаты.
Зачем это нужно
Модуль «Эквайринг ЮKassa» подключает приём оплаты картой и СБП в FightCRM: личный кабинет клиента (/my), быстрая оплата (/pay), оплата на стойке.
Shop ID и секретный ключ настраиваются один раз в «Модули». В способах оплаты вы только выбираете готовое подключение.
Где в ЮKassa взять Shop ID и секретный ключ
- Войдите в личный кабинет ЮKassa.
- Откройте Настройки → Магазин (или раздел API для вашего магазина).
- Скопируйте shopId (Shop ID) и секретный ключ API.
- Для тестов используйте тестовый магазин и тестовые ключи из раздела тестирования ЮKassa.
Что из ЮKassa — в какое поле FightCRM
Откройте «Модули» → «Эквайринг ЮKassa» (/club/modules/acquiring-yookassa) → «Добавить подключение».
- Shop ID (FightCRM) ← идентификатор магазина в ЮKassa.
- Секретный ключ (FightCRM) ← secret key API.
- API URL — оставьте `https://api.yookassa.ru/v3` (по умолчанию).
- Notification URL в форме FightCRM — справочное поле. Webhook обязательно настройте в личном кабинете ЮKassa.
Webhook в личном кабинете ЮKassa
В ЛК ЮKassa укажите URL уведомлений:
`https://ваш-клуб.fightcrm.ru/api/payments/webhook?provider=yookassa&tenantId=...`
Точный URL с `tenantId` показан в поле Notification URL на странице подключения в FightCRM — скопируйте его в ЮKassa.
ЮKassa не принимает webhook URL в теле запроса при создании платежа — только через ЛК.
Шаг 1. Модуль в тарифе
В «Тариф» → «Модули» подключите «Эквайринг ЮKassa».
Шаг 2. Включить модуль для клуба
«Модули» → «Эквайринг ЮKassa» → включите переключатель модуля.
Шаг 3. Создать подключение
Введите Shop ID и секретный ключ → Сохранить → Проверить подключение.
Шаг 4. Привязать к способам оплаты
В «Баланс клуба» → «Счета» включите интернет-эквайринг у способа оплаты и выберите подключение ЮKassa.
Частые вопросы
- Оплата прошла, статус не обновился — проверьте webhook URL в ЛК ЮKassa и что в URL есть `tenantId`.
- Проверка не проходит — перепроверьте Shop ID и секретный ключ; для теста используйте тестовый магазин.