Продамус(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
Этот адрес нужно прописать в настройках в двух местах.
На главной странице настроек для настройки можно выбрать режим работы формы: демо-режим без оплат или режим оплат:
Адрес для уведомлений нужно прописать в настройках платежной системы в двух местах: вкладка Настройка формы  - для обычных оплат и вкладка Подписки - для оплат по подписке. 
Настройка url для уведомлений
Адрес для уведомлений: https://chatter.salebot.pro/prodamus_callback/result
​
Для настройки работы с оплатами по подписке  перейдите во вкладку Подписки и пропишите адрес для уведомлений:
 https://chatter.salebot.pro/prodamus_callback/result
Настройка url для уведомлений для оплат по подписке
Обратите внимание! После ввода url обязательно нажмите кнопку «Сохранить».
Для подключения Prodamus необходимо перейти в раздел "Платежные системы"
Левое меню в проекте
Выбрать платежную систему
и нажать Подключить
Далее необходимо просто указать данные, о которых говорили выше в форму:
ВАЖНО! url - платежной формы указываем БЕЗ https:// 
На этом подключение закончено. Теперь давайте разберемся как использовать данный функционал.

Как сформировать ссылку на оплату
Сформировать ссылку на оплату в блоке можно ОДНИМ ИЗ из доступных способов:
​Кнопка с функцией Оплата или
​Функция get_prodamus_payment_url в Калькуляторе или
​Создание ссылки с помощью переменной 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 в Калькуляторе блоке.
В поле Калькулятор  переменной присвоим значение функции get_prodamus_payment_url 
Название переменной задаете самостоятельно.  На скринах примеры названия переменных. 
В эту переменную запишется ссылка на оплату. Переменную можно вывести на экран ссылкой в сообщении или разместить на кнопке с текстом "Оплатить". 
ПРИМЕР ссылки на оплату: https://payform.ru/7p3JR8/​
Калькулятор
Описание параметров
Пример кода для копирования
Пример 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_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}"
​
Переменные 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
Как создать ссылку на подписку функцией get_prodamus_subscription_url
Рассмотри другой способ сформировать ссылку на оплату товара по подписке. 
Создаем подписной товар в кабинете Продамус.  Подробная инструкция как это сделать : 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
Функция для управления подпиской
prodamus_subscription_switch_status(subscription_id, switcher, customer_phone, customer_email)
 id_subscription - id подписного товара 
switcher = 0 это остановка подписки, если передать 1, подписка снова активируется. 
customer_phone - телефон подписчика - необязательный, если передан customer_email 
customer_email - телефон подписчика - необязательный, если передан customer_phone
Пример использования функции 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
! При оплате с тестовых счетов все настроенные воронки и интеграции сработают, как при обычной оплате ! 
Форма протестирована
Для приема оплат реальными деньгами, необходимо перевести форму в рабочий режим. То есть перевести бегунок переключения демо-режима в положение, чтобы он стал бледно-красным

Параметр	Значение параметра
`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.

Параметр	Значение параметра
`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.

Платежные системы

Робокасса

Last modified 4d ago