Продамус(Prodamus)

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

Доступно только на тарифе "Инфобиз".

Как подключить Продамус

Получить скидку 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://

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

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

Сформировать ссылку на оплату в блоке можно ОДНИМ ИЗ из доступных способов:

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

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

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

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

Для формирования ссылки на оплату в настройках кнопки необходимо указать обязательные параметры "Сумма", "Наименование товара", также параметр "Оплаченный контент", если у вас нет своей онлайн кассы и вы хотите получать чек от 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/.

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

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

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

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

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

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

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

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

Пример 1:

Если в блоке несколько функций для получения ссылки и допущена ошибка, то значение ошибки будет записано в переменной error_payment_func

Ошибка запишется по последней функции в Калькуляторе

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

Обратите внимание: переменной 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’. Полный список доступен по ссылке https://developer.paypal.com/docs/api/reference/currency-codes/

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

оплата картой Казахстана

ACUSDSOM

оплата картой всех стран мира, кроме РФ

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')

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

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

  1. Деактивация подписки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Как создать ссылку на подписку функцией 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: Ссылка на оплату товара по подписке

Если в блоке несколько функций для получения ссылки и допущена ошибка, то значение ошибки будет записано в переменной 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

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

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', '', '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

! При оплате с тестовых счетов все настроенные воронки и интеграции сработают, как при обычной оплате !

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

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

Last updated