Продамус(Prodamus)
Платежная система для онлайн-школ и самозанятых
Для подключения 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 для уведомлений
Адрес для уведомлений:
https://chatter.salebot.pro/prodamus_callback/result
Для настройки работы с оплатами по подписке перейдите во вкладку Подписки и пропишите адрес для уведомлений:
https://chatter.salebot.pro/prodamus_callback/result
Настройка url для уведомлений для оплат по подписке
Обратите внимание! После ввода url обязательно нажмите кнопку «Сохранить».
Для подключения Prodamus необходимо перейти в раздел "Платежные системы"

Левое меню в проекте

Выбрать платежную систему
и нажать Подключить
Далее необходимо просто указать данные, о которых говорили выше в форму:

ВАЖНО! url - платежной формы указываем БЕЗ https://
На этом подключение закончено. Теперь давайте разберемся как использовать данный функционал.
Сформировать ссылку на оплату в блоке можно ОДНИМ ИЗ из доступных способов:
- Создание ссылки с помощью переменной payment_sum и дополнительных параметров (устаревшая работающая версия)
Ссылку на оплату можно создавать в кнопке с функцией "Оплата". О том как создавать такую кнопку рассказано в этой статье:

Кнопки
Salebot.pro
Статья про кнопку с функцией Оплата
Рассмотрим все возможные параметры данной кнопки.
Для формирования ссылки на оплату в настройках кнопки необходимо указать обязательные параметры: Сумма и Наименование товара.
При переходе на страницу оформления заказа заранее будет прописана информация о продукте и его стоимости, клиенту останется только указать свои контакты.
Если в настройках кнопки указать Email и\или телефон пользователя, то на странице оформления заказа будут указаны контакты плательщика и информация о продукте и его стоимости.

Настройка формы кнопки Оплата для Продамус
поле Текст. Данный текст будет указан на кнопке с ссылкой на оплату в сообщении
поле Функция. Для создания кнопки для выдачи ссылки на оплату выбираем функцию Оплата
поле Платежная система. В списке отображаются подключенные к проекту платежные системы
Если к проекту не подключены платежные системы данный тип кнопок будет не доступен
поле Наименование товара (обязательное). В данном поле нужно указать название товара. Чем точнее указано название товара, тем лучше. Например: не Телефон, а Смартфон Xiaomi модель …
НЕЛЬЗЯ использовать двойные кавычки в наименовании товара: удалите или замените на одинарные кавычки.
поле Сумма (обязательное). В этом поле указываем стоимость товара.
меню Дополнительная информация. При клике по данной кнопке откроются дополнительные поля для формирования ссылки
- Описание заказа
- Скидка в руб.
- Переменная с email покупателя
- Переменная с номером телефона покупателя
- Время жизни ссылки
- ID товара для подписки (для создания автоплатежей)
чекбокс С уведомление о клике. Для отслеживания перехода по ссылке для оплаты можно поставить галочку. В таком случае, при клике по кнопке в диалог с клиентом в Сейлбот придет уведомление о том, что был совершен переход по ссылке
На данное уведомление можно настраивать дальнейшую логику работы бота.
Многие платежные системы поддерживают облачные онлайн-кассы, они необходимы по 54-ФЗ.
Прочитайте особенности оформления чеков на сайте выбранной платежной системы, чтобы не попасть в неловкую ситуацию с налоговой инспекцией.
А вот так выглядит страница оплаты, которая открывается при переходе по ссылке в кнопке Оплата:

Страница оплаты: в кнопке заполнены только основные параметры

Раскрывающее меню настроек кнопки Оплата для Продамус
поле Описание заказа. Информация указанная в данном поле будет отображаться на странице оплаты в поле Дополнительные данные
поле Скидка. В данном поле можно указать размер скидки в рублях или рубли с копейками. Для того, чтобы указать сумму с копейками в качестве разделителя используем точку: 50.99
На странице оплаты в поле Сумма к оплате будет указана с учетом скидки , а основная стоимость товара будет перечеркнута.
поле Переменная с email покупателя. В данном поле можно указывать переменную, в которой хранится email клиента (покупателя) .
Например,
#{email}
поле Переменная с номером телефона покупателя. В данном поле можно указывать переменную, в которой хранится номер телефона клиента (покупателя).
Например,
#{phone}
поле Время жизни ссылки. Можно указать дату в формате дд.мм.гггг чч:мм (например 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 этого товара
Как только пользователь получит блок с кнопкой "Оплата" автоматически будут созданы переменные клиента:
Служебная переменная клиента
__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
Название переменной задаете самостоятельно. На скринах примеры названия переменных.
В эту переменную запишется ссылка на оплату. Переменную можно вывести на экран ссылкой в сообщении или разместить на кнопке с текстом "Оплатить".
Калькулятор
Описание параметров
Пример кода для копирования
Пример 1: Ссылка на оплату без чека

Пример формирования ссылки: переданы только обязательные параметры
Пример 2: Ссылка на оплату с чеком

Пример формирования ссылки: переданы все параметры
ваша_переменная =
get_prodamus_payment_url(amount, product_name, expired, customer_phone, customer_email, discount, description, extra_params)
Параметры функции:
Параметр | Значение параметра |
---|---|
amount | сумма к оплате. Можно передать значение целое число и число с точкой. Например 25 или 52.5 (обязательный параметр) |
product_name | Название товара. (обязательный параметр) |
expired | время жизни ссылки на оплату, в формате дд.мм.гггг (например 25.01.2021). Также можно в поле "Калькулятор" указать: expired = current_date + 2 (ссылка будет действительна 2 дня до 00:00) . expired так же можно указать дату с точным временем, через пробел, в формате дд.мм.гггг чч:мм (например: 25.01.2021 12:23). Так же можно использовать стандартные переменные, например зададим время действия ссылки 30 минут: time = current_time + 30
expired = "#{current_date} #{time}"
Чтобы пропустить данный параметр, передайте вместо него пару одинарных или двойных кавычки, или значение None |
customer_phone | номер телефона покупателя, не обязательно, если передан параметр customer_email Чтобы пропустить данный параметр, передайте вместо него одинарные или двойные кавычки. |
customer_email | емейл покупателя, не обязательно, если передан параметр customer_phone Чтобы пропустить данный параметр, передайте вместо него одинарные или двойные кавычки. |
discount | размер скидки. Передаем параметр число или число с точкой: 25 или 63.5 Чтобы пропустить данный параметр, передайте вместо него одинарные или двойные кавычки. |
description | описание товара (если не указать заполняется 'Оплата счета order_id') Чтобы пропустить данный параметр, передайте вместо него одинарные или двойные кавычки. |
extra_params | дополнительные параметры, которых нет в данной функции.
Возможные дополнительные параметры можно посмотреть по ссылке в документации работы с API платежной системы https://help.prodamus.ru/payform/integracii/rest-api/instrukcii-dlya-samostoyatelnaya-integracii-servisov
Пример: extra_params = {"payments_limit": "3"}
Чтобы пропустить данный параметр, передайте вместо него пару одинарных/ пару двойных кавычек или значение None. |
Пример 1: ссылка на оплату без чека
link_prodamus = get_prodamus_payment_url(100, 'Название товара')
Пример 2: ссылка на оплату с чеком
extra_params = {"payments_limit": "3"}
link_prodamus = get_prodamus_payment_url(100, 'Купи меня', '28.03.2023 14:25', '77777777777', '[email protected]', 10, 'Доп описание', extra_params)
Если в блоке несколько функций для получения ссылки и допущена ошибка, то значение ошибки будет записано в переменной
error_payment_func
Ошибка запишется по последней функции в Калькуляторе
Обратите внимание: переменной payment_sum присваивается значение последней, после необязательных переменных payment_description, product_name и т.д.
Для генерации ссылки на оплату, вам достаточно в поле Калькулятор установить значение переменной payment_sum. Сразу после этого появится переменная prodamus_pay_url.
Эту переменную можно вывести на экран ссылкой в сообщении или разместить на кнопке с текстом "Оплатить".
До объявления переменной 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}"
Переменные discount_value, customer_phone, customer_email и link_expired актуальны и для подписок.
Пример реализации.
В первом блоке задаем сумму оплаты:

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

prodamus_available_payment_methods объявляется до объявления payment_sum, возможные значения:
AC - банковская карта
ACUSDXP - карты зарубежных банков, кроме Казахстана
ACkz - карты Казахстана
ACkztjp - Оплата картой всех стран мира, кроме РФ. Оплата в Тенге
ACusd - карты зарубежных банков, кроме РФ и Украины. Оплата в USD
ACeur - карты зарубежных банков, кроме РФ и Украины. Оплата в EUR
SBP - быстрый платеж
PC - Юmoney
QW - Qiwi Wallet
GP - платежный терминал
sbol - Сбербанк онлайн
invoice - Оплата по счету
installment - Частями от Продамус
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 месяца
credit - Кредит от Тинькофф
vsegdada_installment_0_0_6 - Рассрочка от ВсегдаДа на 6 месяцев
vsegdada_installment_0_0_10 - Рассрочка от ВсегдаДа на 10 месяцев vsegdada_installment_0_0_12 - Рассрочка от ВсегдаДа на 12 месяцев
Допускается передача нескольких значений, разделяя их вертикальной чертой.
Например: 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.
Внимание! Колбеки приходят с задержкой, так что после вывода ссылки на оплату пользователю рекомендуем отправить сообщение, что вроде: “После оплаты дождитесь сообщения об успешном завершении оплаты”
Например, можно сделать обработку успешной оплаты блоком с условием и вывести соответствующее сообщение пользователю:

Тип сравнения должен быть "Полное совпадение"
Для совершения повторного платежа обязательно необходимо обнулить 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')
Кроме основных колбеков об успешной оплате в чате с пользователем выводится сообщение, которое пользователь не видит, со следующими текстами:
- 1.Деактивация подписки
- 2.Подписка завершена
- 3.Не успешная оплата - приписка с пояснением (на скриншоте выше)
- 4.Уведомление о предстоящем списании - дата и время предстоящего списания
- 5.Заявка на рассрочку со статусом
Примеры колбэков в диалоге с клиентом:
- Деактивация подписки
- Подписка завершена
- Не успешная оплата - Недостаточно средств.
- Не успешная оплата - Срок действия карты истёк.
- Не успешная оплата - Превышен лимит по карте.
- Не успешная оплата - Карта утеряна
- Не успешная оплата - Системная ошибка
- Не успешная оплата - Операция отклонена. Обратитесь в банк, выпустивший карту.
- Не успешная оплата - Отказ в проведении операции банком эмитентом.
- Не успешная оплата - Отказ в проведении операции банком.
- Уведомление о предстоящем списании - дд.мм.гггг чч:мм
- Заявка на рассрочку одобрена
- Заявка на рассрочку отменена
- Заявка на рассрочку отклонена
Подробнее прочитать описание ошибок можно здесь:

Коды ошибок
Prodamus
Продамус: коды ошибок

По желанию, можно настроить отправку пользователю, какого-то сообщения. Для примера отправим сообщение, что автоматическое списание не удалось.
На уведомление о не успешной оплате с конкретной причиной, можно настроить, например вот так:

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

пример блока для уведомлений об Не успешной оплате с любым пояснением причины
И на все колбеки, в которых присутствует текст Не успешная оплата, пользователю будет приходить сообщение с указанным вами текстом.
Для создания подписки, нужно создать подписной товар. Подробная инструкция как это сделать : https://help.prodamus.ru/payform.ru-onlain-oplaty/rekurrent-i-kluby/nastroiki-kluba/sozdanie-i-redaktirovanie-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.ru-onlain-oplaty/rekurrent-i-kluby/nastroiki-kluba/sozdanie-i-redaktirovanie-podpiski
Далее копируем id подписного товара, ниже показано где его взять:
Создание подписного товара
Для получения ссылки для оплаты товара по подписке в Калькуляторе указываем функцию
get_prodamus_subscription_url
(subscription_id, product_name, expired, customer_phone, customer_email, discount, description, extra_params)Калькулятор
Описание параметров
Пример кода для копирования
Пример 1: Ссылка на оплату товара по подписке

Пример формирования ссылки на товар по подписке
link = get_prodamus_subscription_url
(subscription_id, product_name, expired, customer_phone, customer_email, discount, description, extra_params)Параметры функции:
Параметр | Значение параметра |
---|---|
subscription_id | ID товара по подписке. Получить ID можно скопировать в кабинете Продамус (обязательный параметр) |
product_name | Название товара по подписке. (обязательный параметр) |
expired | время жизни ссылки на оплату, в формате дд.мм.гггг (например 25.01.2021). Также можно в поле "Калькулятор" указать: expired = current_date + 2 (ссылка будет действительна 2 дня до 00:00) . expired так же можно указать дату с точным временем, через пробел, в формате дд.мм.гггг чч:мм (например: 25.01.2021 12:23). Так же можно использовать стандартные перемен ные, например зададим время действия ссылки 30 минут: time = current_time + 30
expired = "#{current_date} #{time}"
Чтобы пропустить данный параметр, передайте вместо него пару одинарных или двойных кавычки, или значение None |
customer_phone | номер телефона покупателя, не обязательно, если передан параметр customer_email Чтобы пропустить данный параметр, передайте вместо него одинарные или двойные кавычки. |
customer_email | емейл покупателя, не обязательно, если передан параметр customer_phone Чтобы пропустить данный параметр, передайте вместо него одинарные или двойные кавычки. |
discount | размер скидки. Передаем параметр число или число с точкой: 25 или 63.5 Чтобы пропустить данный параметр, передайте вместо него одинарные или двойные кавычки. |
description | описание товара (если не указать заполняется 'Оплата счета order_id') Чтобы пропустить данный параметр, передайте вме сто него одинарные или двойные кавычки. |
extra_params | дополнительные параметры, которых нет в данной функции.
Возможные дополнительные параметры можно посмотреть по ссылке в документации работы с API платежной системы https://www.tinkoff.ru/kassa/develop/api/payments/init-request/
Пример: extra_params = {"payments_limit": "3"}
Чтобы пропустить данный параметр, передайте вместо него пару одинарных/ пару двойных кавычек или значение None. |
Пример 1: ссылка на оп лату товара по подписке (автоплатеж)
extra_params = {"payments_limit": "3"}
link_prodamus_sub = get_prodamus_subscription_url(618988, 'Купи меня', '27.03.2023 17:02', '77777777777', '[email protected]', 20, 'Доп описание', extra_params)
Если в блоке несколько функций для получения ссылки и допущена ошибка, то значение ошибки будет записано в переменной
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"
}
url - URL-платежной формы указанный в настройках конструктора
secret_key - секретный ключ из настроек
id_subscription - id подписного товара
customer_phone - телефон подписчика
switcher = 0 это остановка подписки, если передать 1, подписка снова активируется.
Пример настройка блока подписки:

Обратите внимание, что функция возвращает status, который сохраняем и можем обработать по своему усмотрению, при успешной деактивации\активации status равен ok
id_subscription - id подписного товара
switcher = 0 это остановка подписки, если передать 1, подписка снова активируется.
customer_phone - телефон подписчика - необязательный, если передан customer_email
customer_email - телефон подписчика - необязательный, если передан customer_phone
.png?alt=media&token=808ba85b-91c6-4aee-ab83-788fc433eebf)
Пример использования функции prodamus_subscription_switch_status
Пример: передан параметр customer_phone, пропущен customer_email
stat = prodamus_subscription_switch_status
('618117', '0', '75431312321')
Пример 2: передан параметр customer_email, пропущен customer_phone
stat = prodamus_subscription_switch_status('618117', '0', '', '[email protected]')
Функция вернет ok, если все прошло успешно или описание ошибки
Функция задает размер скидки на последующие платежи по подписке. Скидка может быть установлена на ограниченное и неограниченное количество списаний.
prodamus_subscription_discount(subscription_id, discount, customer_phone, num)
где:
subscription_id - ID подписки
discount - десятичное число с точностью до двух знаков после точки, значение должно быть больше нуля и не превышать базовую стоимость подписки
customer_phone - номер телефона клиента в формате: +79999999999 (необязательный параметр, если есть переменная customer_email (появляется пос ле первой оплаты описание выше))
num - Количество оплат на которые будет действовать скидка (необязательный параметр, если не передавать, то количество оплат со скидкой не ограничено)
При успешном выполнении запроса функция вернет 'ok', если запрос выполняется с ошибкой, то функция вернет ее описание.
Размер скидки и интервал перезаписываются ТОЛЬКО если функцию вызвать повторно с новыми значениями!
1. Оформление скидки на все последующие автоплатежи в размере 1р (номер телефона не указывается, так как будет автоматически взят из переменной customer_phone, а количество списаний со скидкой по умолчанию - на весь период подписки)
r = prodamus_subscription_discount('624034', '1')
Пример 1
2. Оформление скидки 2р на следующие 3 списания (номер телефона заменен пустыми кавычками, так как будет автоматически взят из переменной customer_phone)
r = prodamus_subscription_discount('624034', '2', '', '3')
Пример 2
3. Пример оформления скидки в виде числа с дробной частью до сотых (разделитель точка), числовые данные указываются б ез кавычек, номер телефона передаем через переменную
r = prodamus_subscription_discount(#{prodamus_subscription}, 10.25, #{customer_phone}, 3)
Пример 3
С помощью данного метода можно сдвинуть дату следующего платежа по подписке. Сдвигать дату можно только "в будущее" относительно текущей установленной даты следующего платежа. Тем самым увеличивая срок пребывания в клубе.
Например, можно применять в качестве бонуса для подписчиков.
Для этого нужно использовать функцию:
prodamus_subscription_payment_date(subscription_id, date, customer_phone)
где:
subscription_id - ид подписки
date - дата в формате дд.мм.гггг чч:мм или дд.мм.гггг, тогда время будет 00:00
customer_phone - не обязателен, если не передать подтянется из переменной customer_phone, если и там не найдет, то не отработает
Чтобы передать в Продамус нужные вам параметры (например, дата старта подписки, отключение рассрочки и тд), в названии переменной приписывайте в начале 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
! При оплате с тестовых счетов все настроенные воронки и интеграции сработают, как при обычной оплате !
Форма протестирована
Для приема оплат реальными деньгами, необходимо перевести форму в рабочий режим. То есть перевести бегунок переключения демо-режима в положение, чтобы он стал бледно-красным
Last modified 4d ago