Перейти к содержимому
RWP Shop Docs

Платежные системы

Настройка YooKassa

Настройте YooKassa для платежей банковской картой

YooKassa (Яндекс.Касса) — платежный процессор, поддерживающий банковские карты и другие методы в России и странах СНГ.

  • Регистрация бизнеса (ИП/ООО или самозанятость)
  • Торговый аккаунт YooKassa
  • API учетные данные (ID магазина и секретный ключ)
  • Публичный HTTPS-домен бота для приема вебхуков
  1. Пользователь выбирает тариф и оплату картой — бот создает платеж через API YooKassa и выдает ссылку на оплату.
  2. После оплаты YooKassa отправляет вебхук (payment.succeeded или payment.canceled) на адрес YOOKASA_WEBHOOK_URL.
  3. Бот повторно проверяет статус платежа через API YooKassa и активирует подписку через Remnawave.
  • Посетите yookassa.ru
  • Зарегистрируйтесь как торговец
  • Подтвердите информацию о бизнесе
  • Дождитесь одобрения
  • Войдите в панель управления
  • Перейдите в раздел «Интеграция» → «Ключи API»
  • Создайте секретный ключ
  • Запишите ваш ID магазина (shopId)
YOOKASA_ENABLED=true
YOOKASA_URL=https://api.yookassa.ru/v3
YOOKASA_SHOP_ID=123456
YOOKASA_SECRET_KEY=ваш_секретный_ключ
YOOKASA_EMAIL=contact@example.com
YOOKASA_WEBHOOK_URL=/webhook/yookassa/СЛУЧАЙНЫЙ_СЕКРЕТ

Случайный секрет для пути вебхука сгенерируйте командой:

openssl rand -hex 32

В панели YooKassa («Интеграция» → «HTTP-уведомления») укажите URL:

https://ваш-домен.com/webhook/yookassa/СЛУЧАЙНЫЙ_СЕКРЕТ

Включите события payment.succeeded и payment.canceled.

docker compose down && docker compose up -d
  • Отправьте /start боту
  • Выберите подписку
  • Выберите платеж YooKassa
  • Используйте тестовую карту: 4111 1111 1111 1111
Переменная Обязательна Описание
YOOKASA_ENABLED да Включить/отключить YooKassa (true/false)
YOOKASA_URL да Endpoint API: https://api.yookassa.ru/v3
YOOKASA_SHOP_ID да Идентификатор магазина (shopId)
YOOKASA_SECRET_KEY да Секретный ключ API
YOOKASA_EMAIL да Email для чеков покупателя
YOOKASA_WEBHOOK_URL да Путь вебхука, например /webhook/yookassa/секрет

При включенной интеграции с Мой Налог (MOYNALOG_ENABLED=true) чеки по платежам YooKassa автоматически отправляются в ФНС — см. Мой налог.

Карта Статус
4111 1111 1111 1111 Успех
4000 0000 0000 0002 Отклонение

Срок действия: Любая будущая дата CVC: Любые 3 цифры

  • Проверьте, что YOOKASA_WEBHOOK_URL задан и URL зарегистрирован в панели YooKassa
  • Проверьте, что домен бота доступен извне по HTTPS
  • Просмотрите логи бота: docker compose logs -f remnawave-telegram-shop-bot
  • Проверьте правильность YOOKASA_SHOP_ID и YOOKASA_SECRET_KEY
  • Пересгенерируйте секретный ключ, если не уверены
  • Проверьте соединение с api.yookassa.ru из контейнера
  • Проверьте логи бота на ошибки