Открыть бота в MAX

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

Подключение Robokassa к MHUB

Пошаговая инструкция по подключению платёжной системы Robokassa к MHUB: регистрация, получение Merchant Login и паролей, настройка Result URL и приём оплаты в боте MAX.

Обновлено 13 октября 2026 г.

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

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

  • Аккаунт в Robokassa
  • ИП, ООО или самозанятый (НПД) — Robokassa работает со всеми; самозанятым — см. раздел «Самозанятым: чеки в «Мой налог»» ниже
  • Подключённый проект в MHUB с клиентским ботом

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

  1. Перейдите на robokassa.com и нажмите Регистрация.
  2. Заполните данные: email, телефон, название бизнеса.
  3. Подтвердите email.
  4. Создайте магазин в личном кабинете.
  5. Пройдите верификацию — загрузите документы (ИНН, ОГРН/ОГРНИП, паспорт руководителя).

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

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

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

В технических настройках магазина вам понадобятся три параметра:

  1. В личном кабинете Robokassa перейдите в Мои магазины → выберите магазин → Технические настройки.
  2. Скопируйте Идентификатор магазина (Merchant Login) — он указан в верхней части страницы.
  3. Найдите и скопируйте Пароль #1 и Пароль #2.
Параметр Где найти Для чего
Merchant Login Идентификатор магазина Идентификация магазина при создании платежа
Пароль #1 Технические настройки Формирование подписи при создании платежа
Пароль #2 Технические настройки Проверка подписи при получении уведомления об оплате

Важно. Пароли #1 и #2 должны быть разными. Запишите их — они понадобятся на следующем шаге.

Алгоритм хеширования

Убедитесь, что в технических настройках Robokassa выбран алгоритм хеширования MD5 (используется по умолчанию).

Шаг 3. Настройка Result URL в кабинете Robokassa

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

URL для Result URL

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

https://mhub-max.ru/v1/integrations/robokassa/result

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

  1. Перейдите в Технические настройки вашего магазина в Robokassa.
  2. Найдите раздел Result URL.
  3. В поле вставьте:
    https://mhub-max.ru/v1/integrations/robokassa/result
  4. Метод отправки: POST.
  5. Сохраните настройки.

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

Как работает Result URL

  1. Пользователь нажимает кнопку оплаты в боте.
  2. MHUB формирует ссылку на оплату через Robokassa с параметрами: сумма, номер заказа, подпись.
  3. Пользователь оплачивает.
  4. Robokassa отправляет POST-запрос с данными об оплате на Result URL.
  5. MHUB проверяет подпись (через Пароль #2), находит заказ и активирует подписку.
  6. Бот добавляет пользователя в закрытый канал.

Success URL и Fail URL — возврат покупателя после оплаты

Success URL и Fail URL — это адреса, куда Robokassa вернёт покупателя после оплаты (успешной и неуспешной). Укажите в обоих полях ссылку на вашего бота в MAX, в котором подписчики покупают доступ:

https://max.ru/имя_вашего_бота
  1. В Технических настройках магазина найдите поля Success URL и Fail URL.
  2. В оба поля вставьте ссылку на вашего бота.
  3. Метод отправки для обоих полей: GET.
  4. Сохраните настройки.

После оплаты покупатель вернётся в бота, где его уже ждёт сообщение со ссылкой на канал.

Внимание. Не вставляйте в Success URL и Fail URL адрес https://mhub-max.ru/v1/integrations/robokassa/result — он нужен только в поле Result URL. Оплата при этом засчитается, но каждый покупатель после оплаты увидит страницу с ошибкой.

И наоборот: в поле Result URL должен быть только адрес MHUB, без ссылок на канал или бота. Если к нему что-то приписано, Robokassa не сможет сообщить об оплате и доступ не будет выдан.

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

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

  1. Откройте админ-бота MHUB в MAX.
  2. Перейдите в Проекты → выберите ваш проект → Продажи → Платёжные системы → Robokassa.
  3. Нажмите Подключить магазин.
  4. Бот попросит ввести Merchant Login — отправьте идентификатор вашего магазина.
  5. Далее бот попросит ввести два пароля через пробел — отправьте сообщение в формате:
    ПарольОдин ПарольДва
    Где ПарольОдин — Пароль #1, ПарольДва — Пароль #2 из кабинета Robokassa.
  6. После сохранения бот покажет статус подключения и меню настроек.

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

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

  • Текст кнопки оплаты — текст, который увидит пользователь на кнопке (например, "Оплатить", "Перейти к оплате"). До 64 символов.
  • Комиссия — процент, который будет добавлен к цене тарифа (0–100%). Например, при комиссии 5% и тарифе 1000₽ пользователь заплатит 1050₽.
  • Запрос телефона — если включено, при оплате у пользователя будет запрошен номер телефона.
  • Фискализация — передача в чек названия тарифа и ставки НДС. Нужна подключённая фискализация в кабинете Robokassa: онлайн-касса для ИП и ООО или «Робочеки СМЗ» для самозанятых.
  • Форма оплаты — выбор между открытием в браузере или во всплывающем окне.
  • Тестовый режим — переключение между тестовым и боевым режимом.
  • Пауза — временная приостановка приёма платежей без удаления конфигурации.
  • Отключение — полное удаление конфигурации Robokassa из проекта.

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

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

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

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

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

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

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

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

Самозанятым: чеки в «Мой налог»

Самозанятые принимают оплату через Robokassa так же, как ИП и ООО. Отличаются только чеки: доход в «Мой налог» регистрирует сама Robokassa через сервис «Робочеки СМЗ» и отправляет чек покупателю. Подключить его нужно один раз:

  1. В кабинете Robokassa откройте раздел Фискализация.
  2. Выберите решение Самозанятые ФНС, нажмите Перейти с текущего и отправьте заявку.
  3. Подтвердите запрос в приложении «Мой налог». В разделе Партнёры Robokassa должна появиться среди подключённых.
  4. В админ-боте MHUB в меню Robokassa включите Фискализация. «НДС» и «Налог. режим» не меняйте, оставьте «по умолчанию». Тогда в чек попадёт название тарифа.
  5. Сделайте тестовую оплату и проверьте, что чек появился в «Мой налог».

Если после оплаты от Robokassa пришло письмо «Не удалось сформировать чек по операции», проверьте пункты 1–4. Чек за эту оплату оформите вручную в «Мой налог».

Подробнее — в инструкции Robokassa и на странице «Робочеки СМЗ».

Чек-лист

  • Аккаунт Robokassa зарегистрирован и верифицирован
  • Создан магазин в личном кабинете
  • Скопированы Merchant Login, Пароль #1 и Пароль #2
  • Алгоритм хеширования — MD5
  • В настройках магазина указан Result URL: https://mhub-max.ru/v1/integrations/robokassa/result
  • В Success URL и Fail URL указана ссылка на вашего бота https://max.ru/имя_вашего_бота, метод GET
  • В админ-боте MHUB введены Merchant Login и оба пароля
  • Самозанятым: подключены «Робочеки СМЗ», партнёр Robokassa подтверждён в «Мой налог», в MHUB включена фискализация
  • Тестовый платёж прошёл, доступ выдан
  • Переключено в боевой режим (после тестирования)

FAQ

Можно ли использовать Robokassa и Prodamus одновременно?

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

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

Да, комиссия зависит от тарифа Robokassa и способа оплаты. Подробности на robokassa.com.

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

  1. Проверьте, что Result URL указан правильно: https://mhub-max.ru/v1/integrations/robokassa/result
  2. Убедитесь, что Пароль #2 в MHUB совпадает с паролем в Robokassa.
  3. Проверьте, что Robokassa не приостановлена в настройках MHUB (нет статуса «Приостановлено»).
  4. Если проблема сохраняется — напишите в поддержку MHUB.

После оплаты открывается страница с ошибкой invalid_robokassa_signature

В поле Success URL (или Fail URL) указан адрес Result URL. Сама оплата при этом засчитывается и доступ выдаётся — ошибку видит только покупатель на странице возврата. Замените Success URL и Fail URL на ссылку на вашего бота https://max.ru/имя_вашего_бота (метод GET) — см. шаг 3.

Как изменить пароли?

В меню Robokassa в админ-боте нажмите Сменить пароли и отправьте два новых пароля через пробел.

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

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

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

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

← К документацииОткрыть бота в MAX