CloudPayments
Для того, чтобы добавить интеграцию с CloudPayments, вам нужно зайти в раздел Интеграций и нажать кнопку " Добавить интеграцию ".
В появившемся окне, в верхнем поле выбора интеграции выберите «CloudPayments». После этого форма обновится и появятся следующие поля:
Название интеграции - можно указать любое удобное вам название. Оно служит для вашего удобства и поиска. Пользователь не увидит его.
Public ID - заходим на страницу CloudPayments, выбираем вкладку «Сайты», открываем наш и копируем Public ID
Секретный ключ - находится так же на вкладке «Сайты» - Пароль для API
Адрес для получения уведомлений - эту ссылку нужно будет скопировать и сохранить в настройках CloudPayments
Добавляем интеграцию со стороны CloudPayments
Заходим на вкладку «Сайты» и нажимаем «Создать сайт»
Даем название нашему сайту и в поле URL вставляем ссылку на BotHunter https://bot.targethunter.ru/
Открывается окно настроек. Именно отсюда мы и возьмем данные для подключения интеграции внутри BotHunter. А именно Public ID и Пароль для API
Переходим на вкладку Уведомления, и в поле Url сайта вставляем ссылку https://bot.targethunter.ru/callback/cloudpayments
Подключаем уведомления о принятом платеже, о возврате платежа и об изменении статуса подписки
Нажимаем Сохранить уведомления
Готово. Интеграция на стороне обоих сервисов настроена
В интеграции с CloudPayments есть несколько действий, а именно
Создать ссылку на оплату - действие дает выбрать тип платежа - разовый или рекуррентный
Деактивировать ссылку - деактивирование ссылки на оплату
Оформить возврат - позволяет оформить возврат по платежу (необходимо знать ID транзакции)
Отмена подписки на рекуррентные платежи - отменяет подписку по рекуррентному платежу
Изменить подписку - позволяет изменить интервал платежа и сумму данного платежа
Подробнее о каждом действии мы расскажем ниже
Для того, чтобы создавать ссылки на оплату через CloudPayments, нужно добавить блок Действия - Действия с платежными системами - Выбрать название вашей интеграции (которое указывали выше) - выбрать действие "Создать ссылку на оплату".
Тип платежа выбираем разовый. Заполняем все обязательные поля
Пример бота
Отследить оплату можно двумя способами. Первый - в настройках блока "Сообщение" с ссылкой на оплату выбать пункт "Ожидать оплаты заказа"
В расширенных настройках бота включаем настройку "Сохранять входные параметры в переменную". Это нужно для возможности отследить ID транзакции, он будет находиться в переменной{%trigger.transaction_id%} которую вы получите после оплаты пользователем заказа. Сохраняем эту переменную в переменную пользователя
Второй способ - создать отдельного бота с активностью "Пришла оплата по заказу"
При переходе по ссылке, пользователю откроется страница оплаты
После оплаты мы получили сообщение
Отслеживание оплаты разового платежа
Для отслеживания оплаты создадим нового бота с активностью "Пришла оплата по заказу"
В расширенных настройках включим функцию "Сохранять входные параметры в переменную trigger"
Когда приходит оплата по заказу, сохраняем переменные{%trigger.amount%}(сумма заказа) и{%trigger.transaction_id%}(ID транзакции) в пользовательские переменные. Это нужно для возможности оформить возврат (об этом мы напишем ниже)
Наши действия точно такие же, как при создании ссылки для разового платежа, но теперь мы выбираем Рекуррентный платеж (подписка). У нас появляется поле с выбором интервала платежа. Выбрать можно неделю или месяц. Заполняем все обязательные поля
Пример бота
Отследить оплату можно двумя способами. Первый - в настройках блока "Сообщение" с ссылкой на оплату выбать пункт "Ожидать оплаты заказа"
В расширенных настройках бота включаем настройку "Сохранять входные параметры в переменную". Это нужно для возможности отследить ID транзакции, он будет находиться в переменной{%trigger.transaction_id%} которую вы получите после оплаты пользователем заказа. Сохраняем эту переменную в переменную пользователя
При переходе по ссылке, пользователю откроется страница оплаты, на которой будет указано, что данный платеж является подключением автоплатежей. Будет указана сумма автоплатежа и интервал автоплатежей
Второй способ - создать отдельного бота с активностью "Пришла новая оплата по подписке"
Отслеживание оплаты рекуррентного платежа
Для отслеживания оплаты создадим нового бота с активностью "Пришла новая оплата по подписке"
В расширенных настройках включим функцию "Сохранять входные параметры в переменную trigger"
Когда приходит оплата по заказу, сохраняем переменную{%trigger.transaction_id%}(ID транзакции) в пользовательскую переменную. Это нужно для возможности отмены подписки на рекуррентные платежи и изменения условий подписки
Теперь, когда пользователь оплатит заказ, у нас будет вся информация для работы с его платежами в будущем
Данное действие позволяет даективировать ссылку на оплату. Через блок действия с интеграцией создаем ссылку на оплату и отправляем ее пользователю. Создаем блок действия с платежными системами и выбираем Деактивировать ссылку. В ID транзакции вписываем переменную{%i.transaction_id%} именно в ней хранится id транзакции
Пример бота
Таким образом, вы можете давать пользователю определенное время на оплату
Данное действие позволит оформить возврат пользователю по платежу. Для возврата нам понадобится ID транзакции и сумма возврата. Их мы получили и сохранили в пользовательские переменные в момент отслеживания оплаты
Для отмены подписки, нам достаточно знать ID подписки. ID подписки мы получаем и сохраняем в момент отслеживания оплаты рекуррентного платежа. Вставляем в поле ID подписки нашу переменную
Пример бота
Данным действием мы можем проводить манипуляции с подпиской пользователя. Например, изменить назначение платежа, сумму платежа или интервал платежа. Для взаимодействия с подпиской пользователя нам необходимо знать ID подписки. Его мы сохраняли в пользовательскую переменную в момент отслеживания оплаты по рекуррентному платежу
Заполняем обязательное поле ID подписки и меняем нужные нам параметры
Пример бота
