Рекуррентные платежи

Для работы вам потребуется настроенная интеграция. Как ее подключить вы можете прочитать здесь.

Вместе с интеграцией вам будет необходимо подключить соответствующий функционал Клуба на стороне Продамус. Если вы еще этого не сделали, вы можете ознакомиться с ним по ссылке.

Настройка в Продамус

Откройте свою форму для приема оплат, авторизуйтесь и зайдите в настройки подписок.

В верхней части выберите раздел Подписки

Если у вас ранее было пустое поле с URL адресами, то просто вставьте нашу ссылку и сохраните настройки блока.

Ссылку можно найти в окне подключения или скопировать отсюда - https://bot.targethunter.ru/callback/prodamus

Если у вас уже есть адреса для уведомлений, то добавьте новый, нажав на Добавить. Не забудьте Сохранить изменения.

Создание платежа с подпиской

Чтобы создать платежную ссылку с подпиской, необходимо указать ID подписки в соответствующее поле при формировании платежа.

Получение оплаты по подписке

Первую оплату подписки вы можете отследить 2 способами:

1 способ. Как и с обычными платежами, добавить отслеживание оплаты в блоке сообщения

2 способ. Создать бота с активностью "Пришла новая оплата по подписке"

И обязательно включить в расширенных настройках бота пункт "Сохранять входные данные"

Затем внутри бота собираем такую цепочку:

По шагам:

1. Добавляем условие - Интеграции - По какой системе пришло событие - выбираем вашу интеграцию с Продамус

2. Добавляем условие - Интеграции - ID подписки равен - указываем ID подписки, которую проверяем

3. Добавляем условие - Функции - Выражение верно - в левую часть ставим переменную {%trigger.subscription.actioncode%}, в правую ничего. Сохраняем.

4. Указываем что должно произойти при первой оплате подписки (мы указали сообщение с текстом "Пришла первая оплата по подписке", вы можете указать что нужно именно для вашей задачи)

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

Как отследить оплаты по продлению подписки

За основу возьмем бота, которого собрали в пункте выше. Кратко здесь: проверка на то, из какой платежной системы пришло событие, затем проверка ID подписки, чтобы реагировать только на нужную нам, затем мы проверяем пришла ли первая оплата или продление.

Для того, чтобы отследить, что пришло именно продление подписки: добавляем Условие - Интеграции - Тип полученного действия соответствует - Успешное продление.

Из зеленой ветки этого условия проводите дальнейшую цепочку с тем, что должно произойти, когда человек успешно продлил вашу подписку. Например, вы можете добавлять его в список или отправлять сообщение о том, что оплата получена. Тут уже зависит от ваших задач.

Работа с уведомлениями

Для работы нам потребуется бот с типом: Пришло новое уведомление по подписке. При необходимости включаем "Сохранение входных параметров" в переменную. Содержание этой переменной будет описано ниже.

В этого бота будут приходить события от Prodamus, а именно:

• уведомления о неуспешных оплатах

• завершение подписки

• отмена подписки

• напоминание о предстоящей оплате

Для того, чтобы отследить нужное событие - в боте есть несколько специальных условий, которые находятся в пункте Интеграции:

По какой платежной системе пришло событие

Это условие позволяет вам отслеживать только нужную интеграцию. Например, мы создавали ссылку на оплату подписки через интеграцию с названием "Продамус демо" и хотим отслеживать все события только по ней. Тогда в условии мы выбираем именно эту интеграцию.

Тип полученного действия соответствует

Это условие проверяет то, какой тип события пришел. С помощью этого условия вы можете отследить только нужное вам действие и реагировать на него.

ID подписки равен

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

Тип полученного события соответствует

Позволяет определить какой тип события по подписке пришел: действие или уведомление.

Тип полученного уведомления соответствует

С помощью этого условия вы можете определить какое именно уведомление пришло. Например, если пришло напоминание, то нужно отослать сообщение пользователю. А если пришла информация по неудачной оплате, то сообщение нужно отсылать администратору.

Для наглядного примера мы создали простого бота, который отправляет соответствующее сообщение пользователю.

Полезные переменные

Важно. Эти переменные будут доступны внутри бота только, если вы включили в расширенных настройках бота пункт "Сохранять входные значения в переменную"

{%trigger.sum%} - сумма оплаты с плавающей точкой, например 100.00

{%trigger.customer_phone%} - телефон покупателя

{%trigger.customer_email%} - электронная почта покупателя

{%trigger.commission_sum%} - сумма комиссии

{%trigger.subscription.id%} - id подписки

{%trigger.subscription.name%} - название подписки

{%trigger.subscription.date_next_payment%} - дата следующего платежа

{%trigger.subscription.error%} - описание ошибки на русском языке