Платежная система Продамус(Prodamus)

Платежная система для онлайн-школ и самозанятых

Подключение

Получить скидку 1000р на подключение можно указав промокод SALEBOT https://prodamus.ru/

Для подключения Prodamus Вам понадобятся URL-платежной формы и секретный ключ.

URL-платежной формы вы получаете после регистрации, он имеет вид: demo.payform.ru

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

Секретный ключ

Подробная инструкция как это сделать: https://help.prodamus.ru/payform.ru-onlain-oplaty/prochee/url-dlya-uvedomlenii-i-sekretnyi-klyuch

Адрес для уведомлений: https://chatter.salebot.pro/prodamus_callback/result

Этот адрес нужно прописать в настройках в двух местах.

На главной странице настроек:

Настройка url для уведомлений(Часть 1)

После вверху перейти во вкладку Подписки:

Кнопка перехода в вкладку с настройками подписок

И ниже так же прописать:

Настройка url для уведомлений(Часть 2)

Обратите внимание! После ввода url обязательно нажмите кнопку «Сохранить».

Для подключения Prodamus необходимо перейти в раздел "Платежные системы"

Раздел с настройками платежных систем

Далее необходимо просто указать данные, о которых говорили выше в форму.

Настройки продамуса

На этом подключение закончено. Теперь давайте разберемся как использовать данный функционал.

Создание ссылки на оплату

Для генерации ссылки на оплату, вам необходимо установить значение переменной payment_sum и payment_description (Название оплаты и описание) сразу после этого появится переменная prodamus_pay_url.

Так же до объявления переменной payment_sum, можно задать дополнительные данные, для платежа

discount_value - размер скидки (например discount_value = 25 или discount_value = 50.25)

link_expired - время жизни ссылки на оплату, в формате дд.мм.гггг (например 25.01.2021). Также можно в поле Назначение переменных при переходе указать: link_expired = current_date + 2 (ссылка будет действительна 2 дня до 00:00)

Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить". Ссылка имеет вид: https://payform.ru/7p3JR8/

Пример реализации.

В первом блоке задаем сумму оплаты:

Ввод суммы платежа

Дальше выводим в нужном месте url, ссылку prodamus_pay_url:

Вывод ссылки на оплату

Обработка результата

Важно! после успешной или неуспешной оплаты в бот придут колбеки, по которым вы сможете понять что была успешная оплата. Эти колбеки в системе вы видите как сообщения от пользователя, чтобы их не мог отправить пользователь, они состоят из секретного ключа и приписки со статусом, например: 453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_success или 453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_fail. Также после успешной оплаты переменная prodamus_payment_completed устанавливается в True.

Внимание! Колбеки приходят с задержкой, так что после вывода ссылки на оплату пользователю рекомендуем отправить сообщение, что вроде: “После оплаты дождитесь сообщения об успешном завершении оплаты”

Например, можно сделать обработку успешной оплаты блоком с условием и вывести соответствующее сообщение пользователю:

Тип сравнения должен быть "Полное совпадение"

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

Платежи по подписке

Создание подписки

Для создания подписки, нужно создать подписной товар. Подробная инструкция как это сделать : https://help.prodamus.ru/payform.ru-onlain-oplaty/rekurrent-i-kluby/nastroiki-kluba/sozdanie-i-redaktirovanie-podpiski

Далее копируем id подписного товара, ниже показано где его взять:

Создание подписного товара

Для генерации ссылки на оплату подписки, вам необходимо установить значение (id подписного товара) переменной prodamus_subscription, сразу после этого появится переменная prodamus_pay_url. Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить". Ссылка имеет вид: https://payform.ru/7p3JR8/

Обработка результата происходит так же как и при разовой оплате (читать выше)

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

Управление статусом подписки

Для возможности отписки пользователя от подписки нужно создать блок и вызвать функцию: https://store.salebot.pro/function/delete_subscription_prodamus

С параметрами:

{ "customer_phone": "#{customer_phone}", "id_subscription":"#{prodamus_subscription}", "url":"https://demo.payform.ru/", "secret_key":"453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66", "switcher":"0" }

url - URL-платежной формы указанный в настройках конструктора secret_key - секретный ключ из настроек id_subscription - id подписного товара customer_phone - телефон подписчика switcher = 0 это остановка подписки, если передать 1, подписка снова активируется.

Пример настройка блока отписки:

Обратите внимание, что функция возвращает status, который сохраняем и можем обработать по своему усмотрению, при успешной деактивации\активации status равен ok