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

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

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

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

---

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

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

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

Шаг 2. Создание платёжной страницы

Платёжная страница — это точка входа для оплаты. MHUB формирует ссылку на неё с параметрами заказа.

1. В личном кабинете Prodamus перейдите в раздел Платёжные страницы.
2. Нажмите Создать страницу.
3. Укажите:
   • Название — произвольное, для вашего удобства (например, "Подписка на клуб").
   • Тип — выберите Динамическая (MHUB будет передавать сумму и описание автоматически).
4. Сохраните страницу.

После создания вы увидите URL платёжной страницы — он понадобится на следующем шаге. Выглядит примерно так:

https://yourshop.payform.ru/

Шаг 3. Получение секретного ключа

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

1. В личном кабинете Prodamus перейдите в Настройки → Ключи API (или настройки конкретной платёжной страницы).
2. Скопируйте Секретный ключ (Secret Key).

Важно. Не путайте секретный ключ с токеном API. Для интеграции с MHUB нужен именно секретный ключ, который используется для подписи.

Шаг 4. Настройка callback-уведомлений (webhook)

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

URL для callback

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

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

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

1. Перейдите в настройки вашей платёжной страницы в Prodamus.

2. Найдите раздел Уведомления (или Webhook / HTTP-уведомления).

3. В поле URL для уведомлений об оплате вставьте:

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

4. Формат уведомлений: выберите JSON (если есть выбор).

5. Сохраните настройки.

Примечание. MHUB автоматически прописывает этот URL в каждую платёжную ссылку (параметр urlNotification), но рекомендуется также указать его в настройках платёжной страницы как резервный. Это гарантирует, что уведомление придёт даже если параметр в ссылке будет потерян.

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

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

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

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

1. Откройте админ-бота MHUB в MAX.
2. Перейдите в Проекты → выберите ваш проект → Настройки → Платежные системы → Prodamus.
3. Нажмите Указать URL и отправьте URL вашей платёжной страницы (например, https://yourshop.payform.ru/).
4. Бот попросит ввести секретный ключ — отправьте его в чат.
5. После сохранения бот покажет статус подключения и адрес webhook для Prodamus.

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

• Текст кнопки оплаты — по умолчанию "Оплатить через Prodamus", можно изменить на произвольный (например, "Оплатить", "Перейти к оплате").
• Пауза — можно временно приостановить приём платежей через Prodamus, не удаляя конфигурацию.
• Удаление — полностью отключить Prodamus от проекта.

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

После настройки обязательно сделайте тестовый платёж:

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

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

Чек-лист

• Аккаунт Prodamus верифицирован
• Создана динамическая платёжная страница
• Скопирован URL платёжной страницы
• Скопирован секретный ключ
• В настройках платёжной страницы указан callback URL: https://mhub-max.ru/v1/integrations/prodamus/webhook
• В админ-боте MHUB введены URL и секретный ключ
• Тестовый платёж прошёл, доступ выдан

FAQ

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

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

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

Да, комиссия зависит от тарифа Prodamus и способа оплаты (обычно 2.5–3.5%). Подробности на prodamus.ru.

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

1. Проверьте, что callback URL указан правильно: https://mhub-max.ru/v1/integrations/prodamus/webhook
2. Убедитесь, что секретный ключ в MHUB совпадает с ключом в Prodamus.
3. Проверьте, что Prodamus не приостановлен в настройках MHUB (нет статуса "Приостановлено").
4. Если проблема сохраняется — напишите в поддержку MHUB.

Поддерживает ли MHUB автоплатежи через Prodamus?

Автоплатежи (рекуррентные списания) — это отдельная возможность Prodamus, которую нужно запрашивать у их поддержки. MHUB передаёт необходимые параметры, но активация автоплатежей на стороне Prodamus требует дополнительного согласования.

Можно ли использовать одну платёжную страницу для нескольких проектов?

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