Подключение ЮKassa (СБП QR)
Что делает. Магазин ЮKassa (машинный код yookassa_sbp): счёт по СБП, автоматическое получение оплаты, возврат из карточки. Можно подключить несколько магазинов (на разные юрлица) отдельными терминалами.
Как настроить.
- Возьмите в ЛК ЮKassa два реквизита: shopId (идентификатор магазина, раздел Настройки → Магазин) и секретный ключ (API-ключ из Настройки → API-ключи, начинается с
live_илиtest_). - В виджете: Настройки интеграции → Эквайринг → «+ Подключить терминал» → «ЮKassa (СБП QR)». Заполните shopId, секретный ключ, название, «Активен», склады BazON (хотя бы один обязателен), кому разрешён возврат. Нажмите «Протестировать подключение» (виджет проверит реквизиты без создания платежа) → «Сохранить».
- Пропишите адрес уведомлений в ЛК ЮKassa (важный отдельный шаг — ЮKassa не получает адрес автоматически): после сохранения виджет покажет адрес для уведомлений с кнопкой «Копировать». Скопируйте → в ЛК ЮKassa Настройки → Уведомления (HTTP-уведомления) вставьте адрес и включите события
payment.succeededиrefund.succeeded→ сохраните. Один адрес обслуживает все ваши магазины ЮKassa этого аккаунта и оба типа событий.
Выставление счёта и возврат — как у других банков.
Ограничения и частые вопросы.
- «Неверные реквизиты» — проверьте shopId и ключ без пробелов, ключ должен начинаться с
live_/test_. - Оплатил, статус не сменился — прописан ли адрес уведомлений в ЛК и включено ли
payment.succeeded; найдите платёж в таблице, «Обновить». - Несколько магазинов — отдельный терминал на каждый (свои shopId + ключ), адрес уведомлений общий, прописывается один раз.
- Возврат сделали напрямую в ЛК ЮKassa мимо виджета — платёж останется «Оплачен», в аудит-журнале появится «возврат сделан вне виджета — нужна ручная сверка» (деньги клиенту при этом возвращаются).
- Безопасность: shopId и ключ шифруются AES-GCM, ключ не логируется. ЮKassa не подписывает уведомления, поэтому на каждое виджет перезапрашивает статус напрямую у ЮKassa и доверяет только этому ответу — подделать оплату нельзя. Возврат защищён ACL + капчей.