MHUBDocs

Платёжные системы / Настройка

Подключение ЮKassa к MHUB

Пошаговая инструкция по подключению платёжной системы ЮKassa к MHUB: регистрация, получение Shop ID и секретного ключа, настройка Webhook URL и приём оплаты в боте MAX.

Обновлено 6 апреля 2026 г.Адрес: /payments/yookassa

ЮKassa — платёжный сервис для приёма онлайн-оплаты от Сбербанка. MHUB поддерживает интеграцию с ЮKassa: после настройки пользователи вашего бота в MAX смогут оплачивать подписку прямо из чата, а MHUB автоматически выдаст доступ к закрытому каналу.

Что потребуется

  • Аккаунт в ЮKassa
  • ИП или ООО (ЮKassa работает только с юрлицами и ИП)
  • Подключённый проект в MHUB с клиентским ботом

Шаг 1. Регистрация в ЮKassa

  1. Перейдите на yookassa.ru и нажмите Подключить.
  2. Заполните анкету: email, телефон, данные организации.
  3. Подтвердите email.
  4. Загрузите документы для верификации (ИНН, ОГРН/ОГРНИП, устав или свидетельство о регистрации ИП).
  5. Подпишите договор — ЮKassa предложит электронный договор-оферту.

После проверки документов (обычно 1–3 рабочих дня) вам откроется полный функционал.

Примечание. Для тестирования можно использовать тестовый режим без прохождения полной верификации.

Шаг 2. Получение данных магазина

В личном кабинете ЮKassa вам понадобятся два параметра:

  1. Перейдите в Настройки → Ключи API (или раздел Интеграция).
  2. Скопируйте shopId — идентификатор вашего магазина (числовой).
  3. Выпустите и скопируйте Секретный ключ — он отображается один раз при создании.
Параметр Где найти Для чего
Shop ID Настройки → Ключи API Идентификация магазина при создании платежа
Секретный ключ Настройки → Ключи API Аутентификация API-запросов к ЮKassa

Важно. Секретный ключ отображается только один раз. Сохраните его сразу — при утере потребуется выпустить новый.

Шаг 3. Настройка Webhook URL в кабинете ЮKassa

Это критически важный шаг. Webhook URL — это адрес, на который ЮKassa отправляет уведомление после успешной оплаты. MHUB обрабатывает это уведомление и автоматически выдаёт доступ пользователю.

URL для Webhook

Укажите в настройках ЮKassa следующий адрес:

https://mhub-max.ru/v1/integrations/yookassa/webhook

Где прописать

  1. В личном кабинете ЮKassa перейдите в Настройки → Уведомления (или HTTP-уведомления).
  2. Нажмите Добавить URL.
  3. В поле URL вставьте:
    https://mhub-max.ru/v1/integrations/yookassa/webhook
  4. Выберите событие: payment.succeeded (успешная оплата).
  5. Сохраните настройки.

Внимание. Без Webhook URL оплата пройдёт на стороне ЮKassa, но подписка НЕ будет активирована автоматически в MHUB.

Как работает Webhook

  1. Пользователь нажимает кнопку оплаты в боте.
  2. MHUB создаёт платёж через API ЮKassa с параметрами: сумма, описание, данные заказа.
  3. Пользователь оплачивает на странице ЮKassa.
  4. ЮKassa отправляет POST-запрос с данными об оплате на Webhook URL.
  5. MHUB проверяет статус платежа, находит заказ и активирует подписку.
  6. Бот добавляет пользователя в закрытый канал.

Альтернатива: автоматическая настройка

В админ-боте MHUB в меню ЮKassa есть пункт Webhook URL — бот покажет точный адрес, который нужно указать в кабинете ЮKassa.

Шаг 4. Подключение в MHUB через админ-бота

Теперь нужно ввести данные ЮKassa в MHUB.

  1. Откройте админ-бота MHUB в MAX.
  2. Перейдите в Проекты → выберите ваш проект → Настройки → Платёжные системы → ЮKassa.
  3. Нажмите Подключить магазин.
  4. Бот попросит ввести Shop ID — отправьте идентификатор вашего магазина.
  5. Далее бот попросит ввести Секретный ключ — отправьте его отдельным сообщением.
  6. После сохранения бот покажет статус подключения и меню настроек.

Что можно настроить

После подключения в меню ЮKassa доступны дополнительные опции:

  • Текст кнопки оплаты — текст, который увидит пользователь на кнопке (например, «Оплатить», «Перейти к оплате»). До 64 символов.
  • Фискализация — отправка электронных чеков через ЮKassa (требуется подключение онлайн-кассы в кабинете ЮKassa).
  • Webhook URL — отображение URL для настройки уведомлений.
  • Тестовый режим — переключение между тестовым и боевым режимом.
  • Пауза — временная приостановка приёма платежей без удаления конфигурации.
  • Отключение — полное удаление конфигурации ЮKassa из проекта.

Шаг 5. Тестовый платёж

По умолчанию подключение создаётся в тестовом режиме — деньги не списываются.

  1. Убедитесь, что создан хотя бы один тариф (Создать RUB-тариф в админ-боте).
  2. Откройте вашего клиентского бота в MAX (не админ-бота).
  3. Нажмите /start или «Старт».
  4. Выберите тариф и нажмите кнопку оплаты.
  5. Оплатите через тестовую форму ЮKassa.
  6. Проверьте:
    • Вы получили доступ к закрытому каналу.
    • В админ-боте в статистике проекта отобразился платёж.

Если после оплаты доступ не выдан — проверьте, что Webhook URL указан верно и секретный ключ совпадает с тем, что в кабинете ЮKassa.

Шаг 6. Переключение в боевой режим

После успешного тестирования:

  1. В админ-боте перейдите в меню ЮKassa.
  2. Нажмите Тестовый режим — бот переключит на боевой режим.
  3. Убедитесь, что статус показывает: «Тестовый режим: выкл».

Важно. Для боевого режима магазин в ЮKassa должен пройти верификацию. Тестовый и боевой Shop ID и ключи могут различаться — проверьте это в кабинете ЮKassa.

Чек-лист

  • Аккаунт ЮKassa зарегистрирован и верифицирован
  • Магазин создан, договор подписан
  • Скопированы Shop ID и Секретный ключ
  • В настройках ЮKassa указан Webhook URL: https://mhub-max.ru/v1/integrations/yookassa/webhook
  • Событие payment.succeeded включено для Webhook
  • В админ-боте MHUB введены Shop ID и Секретный ключ
  • Тестовый платёж прошёл, доступ выдан
  • Переключено в боевой режим (после тестирования)

FAQ

Можно ли использовать ЮKassa и другие платёжные системы одновременно?

Да. MHUB поддерживает несколько платёжных систем для одного проекта. При оплате пользователь увидит кнопки для каждой подключённой системы.

ЮKassa берёт комиссию?

Да, комиссия зависит от тарифа ЮKassa и способа оплаты. Подробности на yookassa.ru.

Что делать, если оплата прошла, но доступ не выдан?

  1. Проверьте, что Webhook URL указан правильно: https://mhub-max.ru/v1/integrations/yookassa/webhook
  2. Убедитесь, что для Webhook выбрано событие payment.succeeded.
  3. Убедитесь, что секретный ключ в MHUB совпадает с ключом в кабинете ЮKassa.
  4. Проверьте, что ЮKassa не приостановлена в настройках MHUB (нет статуса «Приостановлено»).
  5. Если проблема сохраняется — напишите в поддержку MHUB.

Как изменить секретный ключ?

В меню ЮKassa в админ-боте нажмите Сменить ключ и отправьте новый секретный ключ.

Как работают промокоды с ЮKassa?

Если для проекта настроены промокоды, скидка автоматически применяется к сумме платежа. Пользователь вводит промокод в клиентском боте перед оплатой.

Можно ли использовать один магазин ЮKassa для нескольких проектов?

Технически да — каждый проект может иметь свою конфигурацию с одним и тем же Shop ID. Но для прозрачности отчётности рекомендуется использовать отдельные магазины для разных проектов.

Чем ЮKassa отличается от Robokassa при подключении к MHUB?

Основные отличия:

  • ЮKassa использует Shop ID + Секретный ключ (два параметра), Robokassa — Merchant Login + два пароля (три параметра).
  • В ЮKassa настраивается Webhook URL, в Robokassa — Result URL.
  • Данные вводятся в админ-боте по отдельности (сначала Shop ID, затем ключ), а не через пробел.
  • ЮKassa принадлежит Сбербанку и предлагает широкий набор способов оплаты, включая SberPay.
Назад к документацииОткрыть админ-бот MHUB