ЮКасса позволяет принимать онлайн-оплату картами, через СБП и электронными кошельками прямо на сайте вашего магазина. После подключения у покупателя при оформлении заказа появляется способ «🌐 Онлайн-оплата», а деньги поступают на ваш счёт в ЮКассе.
Что понадобится
Аккаунт в ЮКассе с подключённым магазином. Для регистрации потребуется ИП, ООО или самозанятость и договор с ЮКассой. Из личного кабинета ЮКассы вам нужны два значения: Shop ID (идентификатор магазина) и секретный ключ.
Шаг 1. Получите Shop ID
Войдите в личный кабинет ЮКассы. Shop ID находится в разделе «Настройки» → «Магазин» (также он показан в шапке кабинета рядом с названием магазина). Это набор цифр — скопируйте только цифры, без слова «shopId».
Шаг 2. Выпустите секретный ключ
Перейдите в раздел «Интеграция» → «Ключи API» и выпустите секретный ключ. Боевой ключ для приёма реальных платежей начинается с live_ (тестовый — с test_).
⚠️ Секретный ключ показывается только один раз — в момент выпуска. Скопируйте его сразу и сохраните в надёжном месте. Посмотреть ключ повторно в кабинете ЮКассы нельзя — только перевыпустить (старый при этом перестанет работать).
Шаг 3. Введите данные в магазине
- Откройте раздел «💳 Способы оплаты в моём магазине» в админ-панели магазина.
- Найдите блок «ЮКасса» в списке онлайн-эквайринга.
- Введите Shop ID и секретный ключ в соответствующие поля.
- Нажмите «Подключить».
Шаг 4. Настройте HTTP-уведомления
Чтобы магазин узнавал об успешной оплате и переводил заказ в статус «оплачен», в личном кабинете ЮКассы нужно указать адрес для уведомлений. Перейдите в «Интеграция» → «HTTP-уведомления» и укажите URL вида:
https://ваш-магазин.ritrnd.ru/api/payment/webhook
Точный адрес для вашего магазина показан в блоке-подсказке рядом с формой подключения ЮКассы (там есть кнопка «Копировать»). Если у вас подключён собственный домен — используйте его.
Отметьте события «Платёж, ожидающий подтверждения» и «Платёж успешен». Без настроенных уведомлений покупатель сможет оплатить, но заказ может не перейти автоматически в статус «оплачен».
Шаг 5. Проверьте оплату
Включите ЮКассу в списке способов оплаты и сделайте тестовый заказ с онлайн-оплатой. Убедитесь, что оплата проходит, а заказ появляется в разделе «Заказы» со статусом «оплачен».
⚠️ Секретный ключ — как пароль. Не передавайте его посторонним и не публикуйте нигде.
💡 Если оплата проходит, но заказ остаётся неоплаченным — проверьте, что в ЮКассе правильно указан URL уведомлений и отмечены оба события (шаг 4).