Раздел YooKassa Integration в конструкторе Gridbox описывает процесс подключения и конфигурирования сервиса интернет-эквайринга ЮKassa (ранее Яндекс.Касса) в интернет-магазине (Store App). Интеграция с ЮKassa обеспечивает безопасный прием онлайн-платежей по банковским картам МИР, Visa, MasterCard, через Систему быстрых платежей (СБП), SberPay, T-Pay, Mir Pay, электронные кошельки ЮMoney и поддерживает автоматическую фискализацию чеков по 54-ФЗ.
1. Получение учетных данных API ЮKassa (Getting YooKassa API Credentials)
Для подключения интернет-магазина к платежному шлюзу ЮKassa вам понадобятся два параметра: Shop ID (идентификатор магазина) и Secret Key (секретный ключ API):
- Войдите в личный кабинет мерчанта на портале Личный кабинет ЮKassa (общая информация об эквайринге и тарифах доступна на официальном сайте YooKassa.ru, а документация API — на портале YooKassa API Docs).
- В верхнем левом углу или в шапке личного кабинета найдите и скопируйте ваш Shop ID (Идентификатор магазина) — это уникальный номер вашего договора (например:
123456). - В боковом меню перейдите в раздел Интеграция ➝ Ключи API (или Настройки ➝ Ключи API).
- Нажмите кнопку Выпустить ключ (или сгенерируйте новый секретный ключ API).
- Скопируйте сгенерированный Секретный ключ (Secret Key) — токен начинается с префикса
live_...для боевого режима илиtest_...для тестовой среды. Обязательно сохраните ключ в надежном месте, так как после закрытия страницы он повторно не отображается в целях безопасности.
2. Настройка HTTP-уведомлений об оплате (Setting up Webhooks)
Чтобы сайт мгновенно получал статус успешного списания средств и переводил заказ в статус «Оплачен»:
- В личном кабинете ЮKassa перейдите в подраздел Интеграция ➝ HTTP-уведомления.
- В поле URL для уведомлений вставьте системный URL обработчика платежей Gridbox Store (указанный в панели настроек метода оплаты ЮKassa на вашем сайте).
- В блоке События отметьте чекбоксами события:
payment.succeeded— успешное завершение платежа;payment.canceled— отмена или ошибка оплаты;payment.waiting_for_capture— ожидание списания средств при двухстадийной оплате;refund.succeeded— успешный возврат средств.
- Нажмите кнопку Сохранить внизу страницы личного кабинета ЮKassa.
3. Настройка ЮKassa в панели Gridbox Store (Configuring YooKassa in Gridbox)
После генерации ключей и настройки уведомлений привяжите платежный метод в панели управления Joomla:
- В панели управления Gridbox перейдите по пути: Store App ➝ Settings ➝ Payment Methods.
- Нажмите кнопку Add New Item и выберите в списке шлюзов YooKassa.
- В поле Title задайте публичный заголовок для покупателей (например, ЮKassa: Карты (МИР / Visa / MasterCard), СБП, SberPay).
- Вставьте скопированный Shop ID в соответствующее поле настроек.
- Вставьте скопированный Secret Key в поле секретного ключа API.
- Активируйте переключатель Published для отображения метода оплаты на этапе оформления заказа (Checkout).
- Нажмите кнопку Save для сохранения конфигурации.
4. Сводная таблица параметров YooKassa Integration
Полный перечень параметров конфигурации платежного шлюза ЮKassa в Gridbox:
| Параметр / Поле | Описание и функциональное назначение | Формат / Источник |
|---|---|---|
| Title | Название способа оплаты, отображаемое покупателям в корзине и при чекауте. | Текстовая строка |
| Shop ID | Уникальный цифровой идентификатор магазина (shopId) в системе ЮKassa. | Числовой ID |
| Secret Key | Секретный API-ключ аутентификации магазина (начинается с live_... или test_...). | live_... / test_... |
| Webhook URL | Системный адрес обработчика входящих HTTP-уведомлений от ЮKassa для смены статуса заказов. | Системный URL |
| Published | Статус публикации и доступности метода оплаты в интернет-магазине. | Переключатель (Yes/No) |
| Save | Сохранение параметров интеграции платежного шлюза в базе данных сайта. | Кнопка действия |
ЮKassa автоматически определяет устройство пользователя. На смартфонах покупателю сразу предлагается быстрая оплата через QR-код / ссылку СБП, SberPay или T-Pay с мгновенным переходом в банковское приложение без необходимости вводить реквизиты карты вручную.
У ЮKassa переключение между боевым и тестовым режимами происходит за счет типа выпущенного ключа. Если в поле Secret Key вставлен тестовый ключ (test_...), платежи будут проходить в тестовом режиме песочницы. Перед сдачей проекта клиенту обязательно выпусти боевой ключ (live_...) в верифицированном аккаунте ЮKassa и не забудь прописать Webhook URL в кабинете для автоматической смены статусов заказов на боевом домене.