Prodamus: настройка подписок и автопродления

Ближайшее обновление BotMan. Инструкция описывает новую поддержку подписок Prodamus с автопродлением. Если поле ID подписки ещё отсутствует в вашем кабинете BotMan, дождитесь обновления сервиса.

Как работает подписка¶

Покупатель оформляет подписку по ссылке из сценария BotMan. Первый и последующие платежи проводит Prodamus. После подтверждения оплаты BotMan обновляет оплаченный срок. Собственный повторный платёж BotMan для такой подписки не запускает.

1. Подготовьте подписку в Prodamus¶

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

2. Создайте подписку в кабинете Prodamus: задайте фиксированную цену в рублях и период оплаты.

3. Скопируйте ID подписки — он понадобится для тарифного плана в BotMan.

4. В настройках уведомлений укажите адрес https://s.botman.pro/prodamus. Уведомления нужны и для первого платежа, и для продлений.

Условия списаний и порядок отмены покажите покупателю до оплаты. Расписание повторных списаний задаётся на стороне Prodamus.

2. Подключите магазин к BotMan¶

Откройте «Интеграции» → «Платёжные провайдеры» и создайте подключение Prodamus либо используйте существующее подключение нужного магазина. Укажите домен платёжной страницы и секретный ключ по инструкции подключения Prodamus. Для разных магазинов используйте отдельные подключения.

3. Создайте тарифный план¶

1. Откройте тарифные планы в BotMan и создайте тариф подписки.

2. Выберите подключение Prodamus нужного магазина.

3. Укажите название, фиксированную цену и период. Они должны соответствовать настройкам подписки в Prodamus.

4. Заполните поле ID подписки Prodamus значением из кабинета провайдера.

5. Сохраните тариф и выберите его в шаге оформления подписки вашего сценария.

Для автопродлений используется фиксированная цена. Изменение тарифного плана в BotMan само по себе не меняет условия уже оформленных договоров у провайдера. Сначала согласуйте изменения в Prodamus и проверьте соответствие настроек.

4. Настройте выдачу доступа¶

Первое оформление запускайте из сценария BotMan: так платёж связывается с нужным покупателем и тарифом. Ранее созданные в Prodamus подписки автоматически в BotMan не импортируются.

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

Продление и отмена¶

При успешном повторном списании Prodamus отправляет уведомление, и BotMan продлевает оплаченный срок. Неуспешное списание само по себе срок не увеличивает.

Владелец может отключить автопродление в списке подписок BotMan. Для покупателя добавьте в сценарий действие отмены подписки. Отмена отключает будущие списания у Prodamus, но сохраняет уже оплаченный доступ до конца периода. При включённом автопродлении после оплаченного периода действует льготный срок тарифа (по умолчанию три дня): доступ сохраняется на время ожидания следующего платежа. Если оплата не поступит до конца льготного срока, доступ закончится. При отключённом автопродлении доступ заканчивается строго в конце оплаченного периода.

Отключение автопродления не является возвратом денег. Вопросы возврата решайте отдельно через магазин и Prodamus.

Проверка перед запуском¶

• Пройдите сценарий покупателя и проверьте цену и период на платёжной странице.

• После первого платежа проверьте запись оплаты, активность подписки и дату окончания доступа.

• Убедитесь, что уведомления Prodamus поступают по указанному адресу.

• Проверьте отмену: будущие списания отключены, оплаченный срок сохранён.

Если подписка не работает¶

• Не удаётся сохранить тариф: проверьте ID подписки, фиксированную цену и период.

• Платёж есть, доступа нет: проверьте секретный ключ, адрес уведомлений и то, что оформление началось из сценария BotMan для нужного покупателя.

• Нет повторного списания: проверьте активность подписки и расписание в Prodamus, затем статус платежа.

• Поле ID отсутствует: новая настройка появится после обновления BotMan.

Связанные материалы: подключение Prodamus, платёжные провайдеры, товары и подписки Telegram Stars.