Продамус(Prodamus)
Платежная система для онлайн-школ и самозанятых
Last updated
Платежная система для онлайн-школ и самозанятых
Last updated
Доступно только на тарифе "Инфобиз".
Получить скидку 2000р на подключение можно указав промокод 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
Этот адрес нужно прописать в настройках в двух местах.
На главной странице настроек для настройки можно выбрать режим работы формы: демо-режим без оплат или режим оплат:
Адрес для уведомлений нужно прописать в настройках платежной системы в двух местах: вкладка Настройка формы - для обычных оплат и вкладка Подписки - для оплат по подписке.
Адрес для уведомлений: https://chatter.salebot.pro/prodamus_callback/result
Для настройки работы с оплатами по подписке перейдите во вкладку Подписки и пропишите адрес для уведомлений:
https://chatter.salebot.pro/prodamus_callback/result
Обратите внимание! После ввода url обязательно нажмите кнопку «Сохранить».
Для подключения Prodamus необходимо перейти в раздел "Платежные системы"
Далее необходимо просто указать данные, о которых говорили выше в форму:
ВАЖНО! url - платежной формы указываем БЕЗ https://
На этом подключение закончено. Теперь давайте разберемся как использовать данный функционал.
Сформировать ссылку на оплату в блоке можно ОДНИМ ИЗ из доступных способов:
Создание ссылки с помощью переменной payment_sum и дополнительных параметров (устаревшая работающая версия)
Ссылку на оплату можно создавать в кнопке с функцией "Оплата". О том как создавать такую кнопку рассказано в этой статье:
Рассмотрим все возможные параметры данной кнопки.
Для формирования ссылки на оплату в настройках кнопки необходимо указать обязательные параметры "Сумма", "Наименование товара", также параметр "Оплаченный контент", если у вас нет своей онлайн кассы и вы хотите получать чек от Prodamus.
При переходе на страницу оформления заказа заранее будет прописана информация о продукте и его стоимости, клиенту останется только указать свои контакты. Если в настройках кнопки указать Email и\или телефон пользователя, то на странице оформления заказа будут указаны контакты плательщика и информация о продукте и его стоимости.
поле Текст. Данный текст будет указан на кнопке с ссылкой на оплату в сообщении
поле Функция. Для создания кнопки для выдачи ссылки на оплату выбираем функцию Оплата
поле Платежная система. В списке отображаются подключенные к проекту платежные системы
Если к проекту не подключены платежные системы данный тип кнопок будет не доступен
поле Наименование товара (обязательное). В данном поле нужно указать название товара. Чем точнее указано название товара, тем лучше. Например: не Телефон, а Смартфон Xiaomi модель …
НЕЛЬЗЯ использовать двойные кавычки в наименовании товара: удалите или замените на одинарные кавычки.
поле Сумма (обязательное). В этом поле указываем стоимость товара.
меню Дополнительная информация. При клике по данной кнопке откроются дополнительные поля для формирования ссылки
Описание заказа
Скидка в руб.
Переменная с email покупателя
Переменная с номером телефона покупателя
Время жизни ссылки
ID товара для подписки (для создания автоплатежей)
Оплаченный контент
чекбокс С уведомление о клике. Для отслеживания перехода по ссылке для оплаты можно поставить галочку. В таком случае, при клике по кнопке в диалог с клиентом в Сейлбот придет уведомление о том, что был совершен переход по ссылке
На данное уведомление можно настраивать дальнейшую логику работы бота.
Многие платежные системы поддерживают облачные онлайн-кассы, они необходимы по 54-ФЗ. Прочитайте особенности оформления чеков на сайте выбранной платежной системы, чтобы не попасть в неловкую ситуацию с налоговой инспекцией.
А вот так выглядит страница оплаты, которая открывается при переходе по ссылке в кнопке Оплата:
поле Описание заказа. Информация указанная в данном поле будет отображаться на странице оплаты в поле Дополнительные данные
поле Скидка. В данном поле можно указать размер скидки в рублях или рубли с копейками. Для того, чтобы указать сумму с копейками в качестве разделителя используем точку: 50.99 На странице оплаты в поле Сумма к оплате будет указана с учетом скидки , а основная стоимость товара будет перечеркнута.
Поле Переменная с email покупателя (необязательный, если передан Номер телефона) В данном поле указывается Email пользователя (клиента). Можно указывать переменную, в которой хранится email пользователя.
Например, #{email}
Поле Переменная с номером телефона покупателя (необязательный, если передан Email). В данном поле можно указать переменную, в которой записан номер телефона покупателя в формате 79000000000 Например, #{phone}
Обязательно должен присутствовать email и/или телефон
поле Время жизни ссылки. Можно указать дату в формате дд.мм.гггг чч:мм (например 25.01.2021 11:00) или использовать переменные для назначения срока окончания действия ссылки.
Пример использования переменной: #{link_expired}
поле ID товара по подписки. Чтобы выполнить автоплатеж, передайте значение ID товара. Для создания подписки, нужно создать подписной товар.
Подробная инструкция как создать товар для подписки : https://help.prodamus.ru/payform.ru-onlain-oplaty/rekurrent-i-kluby/nastroiki-kluba/sozdanie-i-redaktirovanie-podpiski
Если передать значение ID товара по подписке, то сумма платежа не учитывается. Данные по товару будут получены из карточки товара из кабинета Продамус
Номер телефона указанный при оплате будет необходим для управлением подпиской.
Если передать ID товара по подписки, то в колбэке при успешном платеже будет передан ID этого товара
Поле Оплаченный контент (условно обязательное). Данные необходимы для фискализации оплаты Prodamus'ом, если у вас нет своей онлайн кассы. В данном поле нужно указать описание покупки, её стоимость и ссылку на ресурс с контентом.
Например: Курс ‘Рыбалка на леща’, стоимость 4999 рублей, ссылка на страницу курса: https://www.lovilescha.ru/courses/poimai_kilogram/.
Эти данные необходимы для передачи в ФНС.
Если вы указываете время жизни ссылки, то в случае
Когда пользователь запросил ссылку оплаты в ее активный срок (то есть ее срок жизни еще не закончился) и она есть в диалоге, то оплатить он не сможет и у него будет уведомление следующего вида:
Срок действия ссылки должен быть позже текущей даты, иначе и по такой ссылке клиент не сможет оплатить.
2. Когда пользователь запрашивает ссылку, а она уже неактивна В таком случае кнопка просто не появится. И в переменных клиента появится переменная "error_payment_button", которая содержит в себе следующее значение: "Ошибка: Срок действия ссылки должен быть позже текущей даты".
Чтобы пользователь мог оплатить корректно, желательно дополнительно обработать такой случай.
Как это сделать?
Создайте блок с условием, в котором укажите, если пришло уведомление подобного плана, error_payment_button == "Ошибка: Срок действия ссылки должен быть позже текущей даты"
С выводом текста: "Извините, вы не успели и ссылка на оплату больше не действительна":
Как только пользователь получит блок с кнопкой "Оплата" автоматически будут созданы переменные клиента:
Служебная переменная клиента __payments , которая хранит сумму, идентификатор созданной ссылки, нужна для идентификации хука от платежной системы.
Служебную переменную клиента __payments НЕЛЬЗЯ удалять или изменять!
Переменная клиента error_payment_button создается, если при формировании кнопки возникла ошибка.
В значение переменной error_payment_button запишется либо текст ошибки, либо ответ платежной системы с ошибкой.
Значение переменных становятся актуальными при переходе в следующий блок
Успешный платеж.
После успешной оплаты в бота АВТОМАТИЧЕСКИ придет КОЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _success и через пробел сумма платежа. Для использования в настройках схемы достаточно его скопировать.
Например: ovg58keefc_success 44, где:
ovg58keefc : первые первые 10 символов секретного ключа платежной системы
_success : результат обработки запроса (успешный платеж)
44 : сумма платежа
Колбеки (уведомления) от платежной системы пользователь НЕ ВИДИТ. Они отображаются только во вкладке Клиенты и видны оператору.
Пример использования: Шаг 1. В блоке "с кнопкой Оплата" добавляем кнопки с функцией Оплата.
Шаг 2. В поле Условие соединения от этого блока к блоку "Успешная оплата" указываем колбэк. Аналогично работает, если указать колбэк об успешной оплате в поле Условие блока Первостепенной проверки условия.
Важно: выбор соответствия Полное совпадение или По наличию ключевых слов
❗️Если вы решили проверять оплату именно в стрелке по условию, то продумайте логику вашей схемы. В случае если клиент покинет блок с переходом по условию с колбеком, то перехода в блок не будет. Такой способ проверки логично использовать, только тогда когда клиент не меняет свою позицию в воронке (положение в схеме). В схемах, в которых клиент перемещается по блокам лучше использовать вариант с указанием колбека в блоке "Первостепенная проверка условия".
После успешной оплаты в бота АВТОМАТИЧЕСКИ придет КОЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _success и через пробел ID товара по подписке
Например: 214009eefc_success 618117, где:
009eefc : 10 символов секретного ключа платежной системы
_success : результат обработки запроса (успешный платеж)
618117: ID товара по подписке
Платеж с ошибкой
При ошибке проведения оплаты в бота АВТОМАТИЧЕСКИ придет КОЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _fail и через пробел сумма платежа
Например, ovg58keefc_fail 44 , где
ovg58keefc : 10 символов секретного ключа платежной системы
_fail : результат обработки запроса - платеж не выполнен или с ошибкой.
44 : сумма платежа
Зависит от платежной системы. Не все платежные системы присылают колбэк об ошибке платежа.
Если сумма указанная в настройках кнопки отличается от суммы, которую клиент оплатил, то АВТОМАТИЧЕСКИ придет КОЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _different_amounts и через пробел уникальный ID платежа
Например: ovg58keefc_different_amounts 123456 , где:
ovg58keefc : 10 символов секретного ключа платежной системы
_different_amounts : результат обработки запроса (сумма оплаты отличается от суммы в ссылке)
123456 : уникальный ID платежа
Для формирования ссылки на оплату можно воспользоваться функцией get_prodamus_payment_url в Калькуляторе блоке.
В поле Калькулятор переменной присвоим значение функции get_prodamus_payment_url
Название переменной задаете самостоятельно. На скринах примеры названия переменных.
В эту переменную запишется ссылка на оплату. Переменную можно вывести на экран ссылкой в сообщении или разместить на кнопке с текстом "Оплатить".
ПРИМЕР ссылки на оплату: https://payform.ru/7p3JR8/
Пример 1:
Если в блоке несколько функций для получения ссылки и допущена ошибка, то значение ошибки будет записано в переменной error_payment_func
Ошибка запишется по последней функции в Калькуляторе
Обратите внимание: переменной payment_sum присваивается значение последней, после необязательных переменных payment_description, product_name и т.д.
Для генерации ссылки на оплату, вам достаточно в поле Калькулятор установить значение переменной payment_sum. Сразу после этого появится переменная prodamus_pay_url.
ПРИМЕР ссылки на оплату:: https://payform.ru/7p3JR8/
Эту переменную можно вывести на экран ссылкой в сообщении или разместить на кнопке с текстом "Оплатить".
До объявления переменной payment_sum так же можно указать следующие, необязательные переменные:
| Параметры функции | Описание параметра |
|---|---|
product_name | наименование товара (если не указать заполняется 'Оплата счета order_id') - на скриншоте ниже показано где отображается |
payment_description | описание товара (если не указать заполняется 'Оплата счета order_id', скрин ниже) - на скриншоте ниже показано где отображается |
discount_value | размер скидки (например discount_value = 25 или discount_value = 50.25) |
customer_phone | номер телефона покупателя, не обязательно, если передан параметр |
customer_email | емейл покупателя |
link_expired | время жизни ссылки на оплату, в формате дд.мм.гггг (например 25.01.2021). Также можно в поле "Калькулятор" указать: link_expired = current_date + 2 (ссылка будет действительна 2 дня до 00:00) |
link_expired | так же можно указать дату с точным временем, через пробел, в формате дд.мм.гггг чч:мм (например: 25.01.2021 12:23). Так же можно использовать стандартные переменные, например зададим время действия ссылки 30 минут: time = current_time + 30 link_expired = "#{current_date} #{time}" |
currency | валюта платежа, по умолчанию "rub". Полный список аргументов: rub usd eur kzt Данный параметр должен быть передан в нижнем регистре. |
payment_title | заголовок платежа (до 127 символов). Если не указать, заполняется текстом: “Оплата счета payment_id” (payment_id - идентификатор заказа в Salebot) |
payment_description | краткое описание платежа (до 127 символов) |
locale | язык страницы оплаты, указывается в виде en-US, fr-XC и т. д. По умолчанию - ‘ru-Ru’. Полный список доступен по ссылке https://developer.paypal.com/api/rest/reference/locale-codes/ |
products_for_receipt | Строка от 50 до 4000 символов в формате "описание заказа - стоимость - ссылка на приобретаемый ресурс”. Например: “Курс ‘Рыбалка на леща’, стоимость 4999 рублей, ссылка на страницу курса: https://www.lovilescha.ru/courses/poimai_kilogram/". Обязательный, если у вас нет своей онлайн кассы, для фискализации оплат через Prodamus. |
payment_sum | (обязательный) сумма платежа |
Переменные discount_value, customer_phone, customer_email и link_expired актуальны и для подписок.
Пример реализации.
В первом блоке задаем сумму оплаты:
Дальше выводим в нужном месте url, ссылку prodamus_pay_url:
prodamus_available_payment_methods объявляется до объявления payment_sum.
Возможные значения:
AC | оплата картой, выпущенной в РФ |
ACkz | оплата картой Казахстана |
ACf | оплата картами стран СНГ, кроме РФ |
ACEURNMBX | Оплата EUR картой всех стран, кроме РФ и РБ |
SBP | Быстрый платёж, без ввода данных карты. Для карт РФ |
QW | Qiwi wallet |
PC | Юmoney |
GP | платежный терминал |
sbol | Сбербанк онлайн invoice - Оплата по счету installment - Частями от Продамус |
installment_5_21 | Частями от Продамус на 3 месяца |
installment_6_28 | Частями от Продамус на 6 месяцев |
installment_10_28 | Частями от Продамус на 10 месяцев |
installment_12_28 | Частями от Продамус на 12 месяцев installment_0_0_3 - Рассрочка от Тинькофф на 3 месяца |
installment_0_0_4 | Рассрочка от Тинькофф на 4 месяца |
installment_0_0_6 | Рассрочка от Тинькофф на 6 месяцев |
installment_0_0_10 | Рассрочка от Тинькофф на 10 месяцев |
installment_0_0_12 | Рассрочка от Тинькофф на 12 месяцев |
installment_0_0_24 | Рассрочка от Тинькофф на 24 месяца |
installment_0_0_36 | Рассрочка от Тинькофф на 36 месяцев |
credit | Кредит от Тинькофф |
vsegdada_installment_0_0_4 | Рассрочка ВсегдаДа на 4 месяца (не работает с available_payment_methods) |
vsegdada_installment_0_0_6 | Рассрочка от ВсегдаДа на 6 месяцев |
vsegdada_installment_0_0_10 | Рассрочка от ВсегдаДа на 10 месяцев |
vsegdada_installment_0_0_12 | Рассрочка от ВсегдаДа на 12 месяцев без переплаты |
vsegdada_installment_0_0_24 | Рассрочка от ВсегдаДа на 24 месяца |
vsegdada_installment_0_0_36 | Рассрочка от ВсегдаДа на 36 месяцев |
sbrf_installment_0_0_6 | Рассрочка от СберБанка на 6 месяцев |
sbrf_installment_0_0_10 | Рассрочка от СберБанка на 10 месяцев |
sbrf_installment_0_0_12 | Рассрочка от СберБанка на 12 месяцев |
sbrf_installment_0_0_24 | Рассрочка от СберБанка на 24 месяца |
sbrf_installment_0_0_36 | Рассрочка от СберБанка на 36 месяцев |
otp_installment_0_0_6 | Рассрочка «ОТП Банка» на 6 месяцев |
otp_installment_0_0_10 | Рассрочка «ОТП Банка» на 10 месяцев |
otp_installment_0_0_12 | Рассрочка «ОТП Банка» на 12 месяцев |
otp_installment_0_0_24 | Рассрочка «ОТП Банка» на 24 месяца |
otp_installment_0_0_36 | Рассрочка «ОТП Банка» на 36 месяцев |
mts_installment_0_0_6 | Рассрочка «МТС Банка» на 6 месяцев |
mts_installment_0_0_10 | Рассрочка «МТС Банка» на 10 месяцев |
mts_installment_0_0_12 | Рассрочка «МТС Банка» на 12 месяцев |
mts_installment_0_0_24 | Рассрочка «МТС Банка» на 24 месяца |
mts_installment_0_0_36 | Рассрочка «МТС Банка» на 36 месяцев |
monetaworld | Карты банков мира, кроме РФ |
sbrf_bnpl | Частями от Сбер |
Допускается передача нескольких значений, разделяя их вертикальной чертой. Например: prodamus_available_payment_methods = "AC|PC|QW"
prodamus_currency - еще один дополнительный параметр для передачи суммы в определенной валюте. Возможные значения валюты: kzt - для тенге eur - для евро usd - для доллара
Тогда сумма, указанная в ссылке, будет в указанной валюте.
При получении колбэка payment_callback нужно ориентироваться на параметр currency и currency_sum, в которых будет валюта и сумма валюте.
Важно! Проверьте есть ли у вас на странице метод оплаты в нужной валюте, поскольку если он отсутствует, то будет переход на страницу без методов оплаты. Методы подключаются через поддержку. Посмотреть включенные можно в настройках страницы или сформировав ссылку на оплату
Важно! после успешной или неуспешной оплаты в бот придут колбеки, по которым вы сможете понять что была успешная оплата. Эти колбеки в системе вы видите как сообщения от пользователя, чтобы их не мог отправить пользователь, они состоят из секретного ключа и приписки со статусом, например: 453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_success или 453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_fail. Также после успешной оплаты переменная prodamus_payment_completed устанавливается в True.
Внимание! Колбеки приходят с задержкой, так что после вывода ссылки на оплату пользователю рекомендуем отправить сообщение, что вроде: “После оплаты дождитесь сообщения об успешном завершении оплаты”
ВАЖНО! Для ссылок созданных с помощью кнопки с функцией Оплата или с помощью функции в Калькуляторе, после оплаты в бота АВТОМАТИЧЕСКИ придет КОЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _success и через пробел сумма платежа. Для использования в настройках схемы достаточно его скопировать.
Например: ovg58keefc_success 44, где:
ovg58keefc : первые первые 10 символов секретного ключа платежной системы
_success : результат обработки запроса (успешный платеж)
44 : сумма платежа
Например, можно сделать обработку успешной оплаты блоком с условием и вывести соответствующее сообщение пользователю:
Тип сравнения должен быть "Полное совпадение"
Для совершения повторного платежа обязательно необходимо обнулить payment_sum, ранее сформированную ссылку и уже после переназначить переменную payment_sum для получения свежей ссылки
Также в Продамусе существуют уведомления по поводу активации/деактивации подписки:
"Подписчик деактивировал подписку" - деактивация подписки подписчиком (например, отказался от подписки).
Может прийти до окончания текущего оплаченного периода. Подразумевает действие на ваше усмотрение - игнорирование или постановка на контроль, попытка вернуть подписчика.
"Подписчик реактивировал подписку" - восстановление подписки.
Может прийти, если подписчик реактивировал подписку до окончания текущего оплаченного периода. Подразумевает действие на ваше усмотрение - игнорирование или удаление из списка мониторинга к возвращению.
После получения уведомления об успешной оплате клиенту в заявку (переменная payment_callback) запишется колбек от продамуса, со всеми данными по полученному платежу. Из него можно сохранить нужные данные и использовать по своему усмотрению. Пример колбека:
{"date": "2021-03-30T11:44:43+03:00", "order_id": "757679", "order_num": "", "domain": "demo.payform.ru", "sum": "14.50", "customer_phone": "+77777777777", "customer_extra": "Тут описание товара", "payment_type": "Пластиковая карта Visa, MasterCard, МИР", "commission": "3.5", "commission_sum": "0.51", "attempt": "1", "discount_value": "10.5", "products[0][name]": "Доступ к обучающим материалам", "products[0][price]": "14.50", "products[0][quantity]": "1", "products[0][sum]": "14.50", "payment_status": "success", "payment_status_description": "Успешная оплата", "payment_init": "manual"}
При формировании ссылки можно указать переменные product_name и payment_description. Тогда при приходе колбэка их можно будет достать вот так
product = get(payment_callback,'products[0][name]')
description = get(payment_callback,'customer_extra')
Обратите внимание: переменной payment_sum присваивается значение последней, после необязательных переменных payment_description, product_name
Сумму можно получить так
summa = get(payment_callback,'sum')
Кроме основных колбеков об успешной оплате в чате с пользователем выводится сообщение, которое пользователь не видит, со следующими текстами:
Деактивация подписки
Реактивация подписки
Подписка завершена
Не успешная оплата - приписка с пояснением (на скриншоте выше)
Уведомление о предстоящем списании - дата и время предстоящего списания
Заявка на рассрочку со статусом
Примеры колбэков в диалоге с клиентом:
Деактивация подписки
Реактивация подписки
Подписка завершена
Не успешная оплата - Недостаточно средств.
Не успешная оплата - Срок действия карты истёк.
Не успешная оплата - Превышен лимит по карте.
Не успешная оплата - Карта утеряна
Не успешная оплата - Системная ошибка
Не успешная оплата - Операция отклонена. Обратитесь в банк, выпустивший карту.
Не успешная оплата - Отказ в проведении операции банком эмитентом.
Не успешная оплата - Отказ в проведении операции банком.
Уведомление о предстоящем списании - дд.мм.гггг чч:мм
Заявка на рассрочку одобрена
Заявка на рассрочку отменена
Заявка на рассрочку отклонена
Подробнее прочитать описание ошибок можно здесь:
По желанию, можно настроить отправку пользователю, какого-то сообщения. Для примера отправим сообщение, что автоматическое списание не удалось. На уведомление о не успешной оплате с конкретной причиной, можно настроить, например вот так:
Для отправки сообщения на все неудачные списания, независимо от причины, можно настроить следующим образом:
И на все колбеки, в которых присутствует текст Не успешная оплата, пользователю будет приходить сообщение с указанным вами текстом.
Для создания подписки, нужно создать подписной товар. Подробная инструкция как это сделать : https://help.prodamus.ru/payform/rekurrent-i-kluby/kak-sozdat-i-nastroit-podpiski
Далее копируем id подписного товара, ниже показано где его взять:
Для генерации ссылки на оплату подписки, вам необходимо установить значение (id подписного товара) переменной prodamus_subscription, сразу после этого появится переменная prodamus_pay_url.
Переменную prodamus_pay_url можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить". Ссылка имеет вид: https://payform.ru/7p3JR8/
Обработка результата происходит так же как и при разовой оплате (читать выше)
После успешной подписки пользователю добавится переменная с введенным при оплате номером телефона customer_phone. Номер телефона нужен для управлением подпиской.
customer_phone нужен для управления подпиской, если не передан customer_email
Рассмотри другой способ сформировать ссылку на оплату товара по подписке.
Создаем подписной товар в кабинете Продамус. Подробная инструкция как это сделать : https://help.prodamus.ru/payform/rekurrent-i-kluby/kak-sozdat-i-nastroit-podpiski
Далее копируем id подписного товара, ниже показано где его взять:
Для получения ссылки для оплаты товара по подписке в Калькуляторе указываем функцию
get_prodamus_subscription_url(subscription_id, product_name, expired, customer_phone, customer_email, discount, description, extra_params, products_for_receipt)
Пример 1: Ссылка на оплату товара по подписке
Если в блоке несколько функций для получения ссылки и допущена ошибка, то значение ошибки будет записано в переменной error_payment_func
Ошибка запишется по последней функции в Калькуляторе
Метод работает только на реальных подписках, в демо-режиме связки с картой нет
Для управления подпиской должен быть передан один из обязательных параметров customer_phone или customer_email.
Для возможности отписки пользователя от подписки нужно создать блок и вызвать функцию: .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" "profile_id":"12345" }
url - URL-платежной формы указанный в настройках конструктора secret_key - секретный ключ из настроек id_subscription - id подписного товара customer_phone - телефон подписчика switcher = 0 это остановка подписки, если передать 1, подписка снова активируется. profile_id - ID профиля в системе Продамус
Обращаем внимание!
Если придет id профиля, то значение будет сохранено в переменную profile_id.
profile_id можно передать в функцию delete_subscription_prodamus вместо customer_phone или customer_email для отмены подписки.
Пример настройка блока подписки:
Обратите внимание, что функция возвращает status, который сохраняем и можем обработать по своему усмотрению, при успешной деактивации\активации status равен ok
id_subscription - id подписного товара
switcher = 0 это остановка подписки, если передать 1, подписка снова активируется.
customer_phone - телефон подписчика - необязательный, если передан customer_email
customer_email - email подписчика - необязательный, если передан customer_phone
profile_id - ID профиля в системе Продамус
Пример: передан параметр customer_phone, пропущен customer_email
stat = prodamus_subscription_switch_status('618117', '0', '75431312321')
Пример 2: передан параметр customer_email, пропущен customer_phone
stat = prodamus_subscription_switch_status('618117', '0', '', 'examp@mail.com')
Функция вернет ok, если все прошло успешно или описание ошибки
Функция задает размер скидки на последующие платежи по подписке. Скидка может быть установлена на ограниченное и неограниченное количество списаний.
prodamus_subscription_discount(subscription_id, discount, customer_phone, num, profile_id) где: subscription_id - ID подписки discount - десятичное число с точностью до двух знаков после точки, значение должно быть больше нуля и не превышать базовую стоимость подписки customer_phone - номер телефона клиента в формате: +79999999999 (необязательный параметр, если есть переменная customer_email (появляется после первой оплаты описание выше)) num - Количество оплат на которые будет действовать скидка (необязательный параметр, если не передавать, то количество оплат со скидкой не ограничено)
profile_id - ID профиля в системе Продамус При успешном выполнении запроса функция вернет 'ok', если запрос выполняется с ошибкой, то функция вернет ее описание.
Размер скидки и интервал перезаписываются ТОЛЬКО если функцию вызвать повторно с новыми значениями!
1. Оформление скидки на все последующие автоплатежи в размере 1р (номер телефона не указывается, так как будет автоматически взят из переменной customer_phone, а количество списаний со скидкой по умолчанию - на весь период подписки)
r = prodamus_subscription_discount('624034', '1')
2. Оформление скидки 2р на следующие 3 списания (номер телефона заменен пустыми кавычками, так как будет автоматически взят из переменной customer_phone)
r = prodamus_subscription_discount('624034', '2', '', '3')
3. Пример оформления скидки в виде числа с дробной частью до сотых (разделитель точка), числовые данные указываются без кавычек, номер телефона передаем через переменную
r = prodamus_subscription_discount(#{prodamus_subscription}, 10.25, #{customer_phone}, 3)
С помощью данного метода можно сдвинуть дату следующего платежа по подписке. Сдвигать дату можно только "в будущее" относительно текущей установленной даты следующего платежа. Тем самым увеличивая срок пребывания в клубе.
Например, можно применять в качестве бонуса для подписчиков.
Для этого нужно использовать функцию:
prodamus_subscription_payment_date(subscription_id, date, customer_phone, profile_id)
где:
subscription_id - ид подписки date - дата в формате дд.мм.гггг чч:мм или дд.мм.гггг, тогда время будет 00:00 customer_phone - не обязателен, если не передать подтянется из переменной customer_phone, если и там не найдет, то не отработает profile_id - ID профиля в системе Продамус
Чтобы передать в Продамус нужные вам параметры (например, дата старта подписки, отключение рассрочки и тд), в названии переменной приписывайте в начале prodamus_
Тогда при формировании ссылки на оплату эти параметры будут передаваться в платежную систему автоматически.
Тестируем только оплату!
Для того, чтобы с вашего счета не списывались средства при тестировании интеграции и настройки воронок на оплату, можно воспользоваться тестовыми картами
Сначала переведите свою платежную странницу в ДЕМО режим ⤵
Не забудьте нажать кнопку "Сохранить"
VISA
Номер карты 4111 1111 1111 1111
Дата истечения срока действия 2024/12
Проверочный код на обратной стороне 123
3-D Secure veres=y, pares=y
Проверочный код 3-D Secure 12345678
MasterCard
Номер карты 5555 5555 5555 5599
Дата истечения срока действия 2024/12
Проверочный код на обратной стороне 123
3-D Secure veres=n
МИР
Номер карты 2200 0000 0000 0053
Дата истечения срока действия 2024/12
Проверочный код на обратной стороне 123
3-D Secure veres=y, pares=y
Проверочный код 3-D Secure 12345678
! При оплате с тестовых счетов все настроенные воронки и интеграции сработают, как при обычной оплате !
Форма протестирована
Для приема оплат реальными деньгами, необходимо перевести форму в рабочий режим. То есть перевести бегунок переключения демо-режима в положение, чтобы он стал бледно-красным
