BazON · Оплаты и эквайринг

Подключение ЮKassa (СБП QR)

3 мин чтения

Подключение ЮKassa (СБП QR)

Что делает

Магазин ЮKassa (машинный код yookassa_sbp): счёт по СБП, автоматическое получение оплаты, возврат из карточки. Можно подключить несколько магазинов (на разные юрлица) отдельными терминалами.

Как настроить

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

Выставление счёта и возврат — как у других банков.

Ограничения и частые вопросы

  • «Неверные реквизиты» — проверьте shopId и ключ без пробелов, ключ должен начинаться с live_/test_.
  • Оплатил, статус не сменился — прописан ли адрес уведомлений в ЛК и включено ли payment.succeeded; найдите платёж в таблице, «Обновить».
  • Несколько магазинов — отдельный терминал на каждый (свои shopId + ключ), адрес уведомлений общий, прописывается один раз.
  • Возврат сделали напрямую в ЛК ЮKassa мимо виджета — платёж останется «Оплачен», в аудит-журнале появится «возврат сделан вне виджета — нужна ручная сверка» (деньги клиенту при этом возвращаются).
  • Безопасность: shopId и ключ шифруются AES-GCM, ключ не логируется. ЮKassa не подписывает уведомления, поэтому на каждое виджет перезапрашивает статус напрямую у ЮKassa и доверяет только этому ответу — подделать оплату нельзя. Возврат защищён ACL + капчей.

Связанные разделы

Остались вопросы?Ответим в мессенджере и допишем статью, если чего-то не хватает.
WhatsApp Telegram