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

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 — куда перенаправить при неуспешной оплате.

Эти URL можно оставить пустыми — 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 зарегистрирован и верифицирован
• Создан магазин в личном кабинете
• Скопированы Merchant Login, Пароль #1 и Пароль #2
• Алгоритм хеширования — MD5
• В настройках магазина указан Result URL: https://mhub-max.ru/v1/integrations/robokassa/result
• В админ-боте MHUB введены Merchant Login и оба пароля
• Тестовый платёж прошёл, доступ выдан
• Переключено в боевой режим (после тестирования)

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.

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

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

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

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

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

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