Продамус(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

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

На главной странице настроек для настройки можно выбрать режим работы формы: демо-режим без оплат или режим оплат:

Адрес для уведомлений нужно прописать в настройках платежной системы в двух местах: вкладка Настройка формы - для обычных оплат и вкладка Подписки - для оплат по подписке.

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

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

https://chatter.salebot.pro/prodamus_callback/result

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

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

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

Как сформировать ссылку на оплату

Кнопка с функцией Оплата

Ссылку на оплату можно создавать в кнопке с функцией "Оплата". О том как создавать такую кнопку рассказано в этой статье:

КнопкиSalebot.pro

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

Обязательные параметры кнопки Оплата для Продамус

Для формирования ссылки на оплату в настройках кнопки необходимо указать обязательные параметры "Сумма", "Наименование товара", также параметр "Оплаченный контент", если у вас нет своей онлайн кассы и вы хотите получать чек от Prodamus.

При переходе на страницу оформления заказа заранее будет прописана информация о продукте и его стоимости, клиенту останется только указать свои контакты. Если в настройках кнопки указать Email и\или телефон пользователя, то на странице оформления заказа будут указаны контакты плательщика и информация о продукте и его стоимости.

поле Текст. Данный текст будет указан на кнопке с ссылкой на оплату в сообщении

поле Функция. Для создания кнопки для выдачи ссылки на оплату выбираем функцию Оплата

поле Платежная система. В списке отображаются подключенные к проекту платежные системы

поле Наименование товара (обязательное). В данном поле нужно указать название товара. Чем точнее указано название товара, тем лучше. Например: не Телефон, а Смартфон Xiaomi модель …

поле Сумма (обязательное). В этом поле указываем стоимость товара.

меню Дополнительная информация. При клике по данной кнопке откроются дополнительные поля для формирования ссылки

• Описание заказа

• Скидка в руб.

• Переменная с email покупателя

• Переменная с номером телефона покупателя

• Время жизни ссылки

• ID товара для подписки (для создания автоплатежей)

• Оплаченный контент

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

На данное уведомление можно настраивать дальнейшую логику работы бота.

А вот так выглядит страница оплаты, которая открывается при переходе по ссылке в кнопке Оплата:

Дополнительные параметры формирования ссылки на оплату

поле Описание заказа. Информация указанная в данном поле будет отображаться на странице оплаты в поле Дополнительные данные

поле Скидка. В данном поле можно указать размер скидки в рублях или рубли с копейками. Для того, чтобы указать сумму с копейками в качестве разделителя используем точку: 50.99 На странице оплаты в поле Сумма к оплате будет указана с учетом скидки , а основная стоимость товара будет перечеркнута.

Поле Переменная с email покупателя (необязательный, если передан Номер телефона) В данном поле указывается Email пользователя (клиента). Можно указывать переменную, в которой хранится email пользователя.

Например, #{email}

Поле Переменная с номером телефона покупателя (необязательный, если передан Email). В данном поле можно указать переменную, в которой записан номер телефона покупателя в формате 79000000000 Например, #{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

Номер телефона указанный при оплате будет необходим для управлением подпиской.

Поле Оплаченный контент (условно обязательное). Данные необходимы для фискализации оплаты Prodamus'ом, если у вас нет своей онлайн кассы. В данном поле нужно указать описание покупки, её стоимость и ссылку на ресурс с контентом.

Например: Курс ‘Рыбалка на леща’, стоимость 4999 рублей, ссылка на страницу курса: https://www.lovilescha.ru/courses/poimai_kilogram/.

Эти данные необходимы для передачи в ФНС.

Кнопка с функцией оплаты

Если вы указываете время жизни ссылки, то в случае

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

2. Когда пользователь запрашивает ссылку, а она уже неактивна В таком случае кнопка просто не появится. И в переменных клиента появится переменная "error_payment_button", которая содержит в себе следующее значение: "Ошибка: Срок действия ссылки должен быть позже текущей даты".

Как это сделать?

Создайте блок с условием, в котором укажите, если пришло уведомление подобного плана, error_payment_button == "Ошибка: Срок действия ссылки должен быть позже текущей даты"

С выводом текста: "Извините, вы не успели и ссылка на оплату больше не действительна":

Переменные клиента, которые будут созданы автоматически при использовании кнопки с функцией Оплата

Как только пользователь получит блок с кнопкой "Оплата" автоматически будут созданы переменные клиента:

Служебная переменная клиента __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 в Калькуляторе блоке.

В поле Калькулятор переменной присвоим значение функции get_prodamus_payment_url

В эту переменную запишется ссылка на оплату. Переменную можно вывести на экран ссылкой в сообщении или разместить на кнопке с текстом "Оплатить".

ПРИМЕР ссылки на оплату: https://payform.ru/7p3JR8/

КалькуляторОписание параметровПример кода для копирования

Пример 1:

ваша_переменная = get_prodamus_payment_url(amount, product_name, expired, customer_phone, customer_email, discount, description, extra_params, products_for_receipt)

Параметры функции:

Параметр

Значение параметра

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", "payment_method": "vsegdada_installment_0_0_6"}

Чтобы пропустить данный параметр, передайте вместо него пару одинарных/ пару двойных кавычек или значение None.

products_for_receipt

Строка от 50 до 4000 символов в формате "описание заказа - стоимость - ссылка на приобретаемый ресурс”.

Например:

“Курс ‘Рыбалка на леща’, стоимость 4999 рублей, ссылка на страницу курса: https://www.lovilescha.ru/courses/poimai_kilogram/". Обязательный, если у вас нет своей онлайн кассы, для фискализации оплат через Prodamus.

extra_params = {"payments_limit": "3"}

products_for_receipt = "Курс ‘Рыбалка на леща’, стоимость 4999 рублей, ссылка на страницу курса: https://www.lovilescha.ru/courses/poimai_kilogram/"

link_prodamus_url = get_prodamus_payment_url(4999, 'Курс ‘Рыбалка на леща’', '27.03.2023 17:00', '79167777771', '[email protected]', 20, 'Лучший курс на рынке', extra_params, products_for_receipt)

Создание ссылки с помощью переменной payment_sum и дополнительных параметров

Для генерации ссылки на оплату, вам достаточно в поле Калькулятор установить значение переменной payment_sum. Сразу после этого появится переменная prodamus_pay_url.

ПРИМЕР ссылки на оплату:: https://payform.ru/7p3JR8/

Эту переменную можно вывести на экран ссылкой в сообщении или разместить на кнопке с текстом "Оплатить".

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

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

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

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

prodamus_available_payment_methods объявляется до объявления payment_sum.

Возможные значения:

Допускается передача нескольких значений, разделяя их вертикальной чертой. Например: 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.

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

Деактивация/реактивация подписки

Также в Продамусе существуют уведомления по поводу активации/деактивации подписки:

1. "Подписчик деактивировал подписку" - деактивация подписки подписчиком (например, отказался от подписки).

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

1. "Подписчик реактивировал подписку" - восстановление подписки.

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

Как сохранить значения из колбека

После получения уведомления об успешной оплате клиенту в заявку (переменная 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')

Сумму можно получить так summa = get(payment_callback,'sum')

Какие колбеки доступны

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

1. Подписчик деактивировал подписку (подробнее тут)

2. Подписчик реактивировал подписку (подробнее тут)

3. Подписка завершена

4. Не успешная оплата - приписка с пояснением (на скриншоте выше)

5. Уведомление о предстоящем списании - дата и время предстоящего списания

6. Заявка на рассрочку со статусом

Примеры колбеков в диалоге с клиентом:

• Подписчик деактивировал подписку

• Подписчик реактивировал подписку

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

• Не успешная оплата - Недостаточно средств.

• Не успешная оплата - Срок действия карты истёк.

• Не успешная оплата - Превышен лимит по карте.

• Не успешная оплата - Карта утеряна

• Не успешная оплата - Системная ошибка

• Не успешная оплата - Операция отклонена. Обратитесь в банк, выпустивший карту.

• Не успешная оплата - Отказ в проведении операции банком эмитентом.

• Не успешная оплата - Отказ в проведении операции банком.

• Уведомление о предстоящем списании - дд.мм.гггг чч:мм

• Заявка на рассрочку одобрена

• Заявка на рассрочку отменена

• Заявка на рассрочку отклонена

Подробнее прочитать описание ошибок можно здесь:

Коды ошибокProdamus

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

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

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

Как создать платежи по подписке

Как создать подписку

Для создания подписки, нужно создать подписной товар. Подробная инструкция как это сделать : 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. Номер телефона нужен для управлением подпиской.

Как создать ссылку на подписку функцией get_prodamus_subscription_url

Рассмотри другой способ сформировать ссылку на оплату товара по подписке.

Создаем подписной товар в кабинете Продамус. Подробная инструкция как это сделать : 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: Ссылка на оплату товара по подписке

link = get_prodamus_subscription_url(subscription_id, product_name, expired, customer_phone, customer_email, discount, description, extra_params, products_for_receipt)

Параметры функции:

Параметр

Значение параметра

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://help.prodamus.ru/payform/integracii/rest-api/instrukcii-dlya-samostoyatelnaya-integracii-servisov Пример: extra_params = {"payments_limit": "3"} Чтобы пропустить данный параметр, передайте вместо него пару одинарных/ пару двойных кавычек или значение None.

products_for_receipt

Строка от 50 до 4000 символов в формате "описание заказа - стоимость - ссылка на приобретаемый ресурс”.

Например:

“Курс ‘Рыбалка на леща’, стоимость 4999 рублей, ссылка на страницу курса: https://www.lovilescha.ru/courses/poimai_kilogram/".

Обязательный, если у вас нет своей онлайн кассы, для фискализации оплат через Prodamus.

extra_params = {"payments_limit": "3"}

products_for_receipt = "Курс ‘Рыбалка на леща’, стоимость ежемесячной подписки 2000 рублей, ссылка на страницу курса: https://www.lovilescha.ru/courses/poimai_kilogram/"

link_prodamus_sub = get_prodamus_subscription_url(618988, 'Курс ‘Рыбалка на леща’', '27.03.2023 17:02', '79167777771', '[email protected]', 20, 'Лучший курс на рынке', extra_params, products_for_receipt)

Как управлять статусом подписки

Для возможности отписки пользователя от подписки нужно создать блок и вызвать функцию: .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 профиля в системе Продамус

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

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

Функция для управления подпиской

prodamus_subscription_switch_status(subscription_id, switcher, customer_phone, customer_email, profile_id)

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', '', '[email protected]')

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

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

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_

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

Как тестировать оплату

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

Чтобы провести тестовый платеж вы можете воспользоваться тестовыми счетами

Тестовые карты Сбербанка:

МИР Номер карты 2202 2050 0001 2424 Дата истечения срока действия 05/35 Проверочный код на обратной стороне 669

MasterCard Номер карты 5469 9801 0004 8525 Дата истечения срока действия 05/26 Проверочный код на обратной стороне 041 Проверочный код 3-D Secure 111111

Visa Номер карты 4006 8009 0096 2514 Дата истечения срока действия 05/26 Проверочный код на обратной стороне 941 Проверочный код 3-D Secure 111111

Форма протестирована