Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Prodamus (KZ)

Как подключить Prodamus

Для подключения Prodamus вам понадобятся URL платежной формы и секретный ключ.

URL платежной формы выдается после регистрации, его пример: demo.payform.ru.

Секретный ключ можно взять в личном кабинете, там же нужно указать URL, на который будут отправляться уведомления (notification).

Секретный ключ в настройках платежной формы в личном кабинете платежной системы «Продамус»

Подробная инструкция о том, как это сделать

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

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

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

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

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

Чтобы настроить работу с платежами по подписке, «Подписки» перейдите во вкладку и укажите адрес для уведомлений:

https://chatter.mavibot.ai/prodamus_callback/result

Внимание! После ввода URL обязательно «Сохранить» кнопку.

Чтобы подключить Prodamus, «Эквайринг» раздел.

После этого достаточно ввести указанные выше данные в форму:

Важно! При указании URL платежной формы https:// не добавляйте.

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

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

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

Ссылку на оплату можно сделать в кнопке с функцией «Оплатить».

О том, как сделать такую кнопку, рассказано в этой статье.

Теперь рассмотрим все возможные параметры этой кнопки.

Обязательные параметры кнопки «Оплатить» для Prodamus

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

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

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

Окно настроек кнопки

«Мәтін» өрісі — этот текст отображается в сообщении на кнопке со ссылкой на оплату.

«Функция» өрісі — для создания кнопки, которая дает ссылку на оплату, выбираем функцию «Оплатить».

«Поле платежной системы» — подключенные к проекту платежные системы отображаются в списке. Если к проекту не подключена ни одна платежная система, этот тип кнопки будет недоступен.

«Поле Название товара» (обязательное) — необходимо указать точное название товара. Например: не «Телефон», а «Смартфон Xiaomi, модель …». Примечание: в названии товара нельзя использовать двойные кавычки; удалите их или замените одинарными.

«Поле Сумма» (обязательное) — указываем стоимость товара.

Меню «Дополнительная информация» — при нажатии на эту кнопку будут доступны дополнительные поля для создания ссылки:

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

  • Скидка в рублях

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

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

  • Время действия ссылки

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

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

Чекбокс «Уведомлять о нажатии» — можно отметить, чтобы отслеживать переход по ссылке на оплату. В этом случае при нажатии на кнопку в диалог клиента в SaleBot придет сообщение о том, что был совершен переход по ссылке.

По этому сообщению можно настроить дальнейшую логику работы бота. Многие платежные системы поддерживают облачные онлайн-кассы, которые необходимы в соответствии с требованиями 54-ФЗ.

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

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

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

Дополнительные настройки для создания ссылки на оплату

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

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

«Поле Переменная Email покупателя» (необязательно, если указан номер телефона) — здесь указывается Email пользователя (клиента). Можно использовать и сохраненную переменную Email, например: #{email}

«Поле Переменная номера телефона покупателя» (необязательно, если указан Email) — здесь можно использовать переменную, в которой указан номер телефона покупателя, формат: 79000000000, например: #{phone} Обязательно должен быть Email и/или телефон.

«Поле Время действия ссылки» — дату дд.мм.гггг чч:мм можно указать в формате (например, 25.01.2021 11:00) или задать срок действия ссылки через переменную. Например: #{link_expired}

«Поле ID товара для подписки» — укажите значение ID товара для автоплатежа. Для создания подписки нужно создать подписочный товар. Подробная инструкция: Создание и настройка подписок Prodamus Если для подписки указан ID товара, сумма оплаты не учитывается. Данные о товаре берутся из карточки товара в кабинете Prodamus. Указанный в оплате номер телефона будет необходим для управления подпиской. Если для подписки указан ID товара, при успешной оплате в колбэке будет передан ID этого товара.

«Поле Оплаченный контент» (условно обязательное) — эти данные нужны для фискализации оплаты через Prodamus, если у вас нет собственной онлайн-кассы. В это поле указывается описание покупки, ее цена и ссылка на контент. Например: курс «Плетение кос», цена 3000 рублей, ссылка на страницу курса: https://nbu.su/krasota/master-po-pleteniyu-kos/?yclid=13602995275739430911

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

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

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

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

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

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

То показывайте следующий текст: "Извините, вы не успели вовремя совершить платеж, платежная ссылка уже недействительна".

Автоматически создаваемые клиентские переменные при использовании кнопки с функцией «Оплатить»

Когда пользователь получает блок с кнопкой «Оплатить», для клиента автоматически создаются переменные:

Служебная клиентская переменная __payments — эта переменная хранит сумму и идентификатор созданной ссылки и нужна для определения хука, который приходит от платежной системы.

Служебная клиентская переменная __paymentsНельзя удалять или изменять!

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 подписочного товара

Пример колбэка от Prodamus для товаров с автоподпиской

Ошибка оплаты Если при проведении оплаты произошла ошибка, в бот АВТОМАТИЧЕСКИ ПРИХОДИТ КОЛБЭК который состоит из первых 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.kz/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

Email покупателя

link_expired

Время действия ссылки на оплату — дд.мм.гггг в формате (например, 25.01.2021). Также Калькулятор в поле можно указать так: link_expired = current_date + 2 (ссылка будет действовать 2 дня до 00:00).

link_expired

Также можно указать точное время, формат: дд.мм.гггг чч:мм (например, 25.01.2021 12:23). Можно использовать и стандартные переменные, например, установить срок действия ссылки на 30 минут: time = current_time + 30 link_expired = "#{current_date} #{time}"

currency

Валюта оплаты, по умолчанию "rub". Полный список аргументов:

  • rub

  • usd

  • eur

  • kzt

Этот параметр должен быть указан в нижнем регистре.

payment_title

Заголовок платежа (до 127 символов). Если не указано, автоматически заполняется следующим текстом: “Оплата счета payment_id” (payment_id — идентификатор заказа в MaviBot).

payment_description

Краткое описание платежа (до 127 символов)

locale

Язык платежной страницы — en-US, fr-XC и т. д. отображается в формате. Значение по умолчанию — ru-RU. Полный список можно посмотреть по этой ссылке

products_for_receipt

строка от 50 до 4000 символов в формате "описание заказа - цена - ссылка на покупаемый ресурс". Например: «Курс „Ловля леща“, цена 4999 тенге, ссылка на страницу курса: https://www.lovilescha.ru/courses/poimai_kilogram/"

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

payment_sum

(обязательно) сумма платежа

discount_value, customer_phone, customer_email и link_expired переменные также актуальны для подписок.

Пример реализации. В первом блоке задаём сумму платежа:

На следующем шаге в нужном месте prodamus_pay_url выводим ссылку:

prodamus_available_payment_methods переменная payment_sum определяется до публикации. Возможные значения:

AC

Оплата картой, выпущенной в РФ

ACkz

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

ACf

Оплата картами стран СНГ, кроме РФ

ACEURNMBX

Оплата картой EUR всех стран, кроме России и Беларуси

SBP

Быстрый платёж без ввода данных карты. Для российских карт

QW

Qiwi wallet

PC

Юmoney

GP

Платёжный терминал

sbol

Сбербанк Онлайн

invoice

Оплата по счёту

installment

Рассрочка через Prodamus

installment_5_21

Рассрочка на 3 месяца через Prodamus

installment_6_28

Рассрочка на 6 месяцев через Prodamus

installment_10_28

Рассрочка на 10 месяцев через Prodamus

installment_12_28

Рассрочка на 12 месяцев через Prodamus

installment_0_0_3

Рассрочка на 3 месяца через Tinkoff

installment_0_0_4

Рассрочка на 4 месяца через Tinkoff

installment_0_0_6

Рассрочка на 6 месяцев через Tinkoff

installment_0_0_10

Рассрочка на 10 месяцев через Tinkoff

installment_0_0_12

Рассрочка на 12 месяцев через Tinkoff

installment_0_0_24

Рассрочка на 24 месяца через Tinkoff

installment_0_0_36

Рассрочка на 36 месяцев через Tinkoff

credit

Кредит через Tinkoff

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_currency — это ещё один дополнительный параметр, который позволяет указать сумму в определённой валюте.

Возможные валюты:

  • kzt — для тенге

  • eur — для евро

  • usd — для доллара

Таким образом, сумма, указанная в ссылке, будет в выбранной валюте.

Коллбэк payment_callback при получении currency и currency_sum нужно обратить внимание на параметры, в которых указаны валюта и сумма.

Если не указать, то перейдёт на страницу без способов оплаты. Способы оплаты можно подключить с помощью поддержки. Подключённые способы можно проверить в настройках страницы или через ссылку на оплату.

Как обрабатывать результат

Успешная оплата

Важно: После успешного или неуспешного платежа в бот приходят коллбэки, с помощью которых можно определить, был ли платёж успешно выполнен.

Коллбэки в системе отображаются как сообщения от пользователя, но сам пользователь их отправить не может. Они представляют собой комбинацию секретного ключа и статуса. Например:

или

После успешной оплаты prodamus_payment_completed переменная автоматически True принимает значение.

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

«После оплаты подождите завершения успешной обработки платежа.»

Структура коллбэка

Для ссылок, созданных через кнопку оплаты или через функцию в Калькуляторе, после платежа в бот автоматически приходит коллбэк. Его состав:

Например:

  • ovg58keefc — полный секретный ключ платёжной системы

  • _success — результат обработки запроса (успешная оплата)

Практическое применение

Можно обработать успешный платёж через условный блок и показать пользователю соответствующее сообщение.

Тип сравнения должен быть "Full match" / "Полное совпадение"

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

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

Кроме этого, в системе Prodamus есть уведомления о том, что подписка активирована или остановлена:

«Подписку отключил пользователь» — если подписка была остановлена вручную (например, при отказе от подписки). Это уведомление может прийти до окончания текущего оплаченного периода. Дальнейшие действия зависят от вашего решения: игнорировать, взять на контроль или попытаться вернуть пользователя.

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

«Деактивация подписки» — если подписка была остановлена после нескольких неудачных платежей.

Сохранение значений из коллбэка

После получения уведомления об успешной оплате payment_callback в переменную записывается коллбэк от Prodamus, в котором содержатся все данные платежа. Эти данные можно сохранить и использовать в нужном вам виде.

Пример коллбэка:

При создании ссылки product_name и payment_description можно указать переменные. Тогда при получении коллбэка их можно получить так:

Внимание: payment_sum в переменную передаётся последнее значение, которое идёт после необязательных переменных и расположено после: payment_description, product_name.

Сумму можно получить так:

Доступные коллбэки

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

коллбэки

  • Подписчик деактивировал подписку (подробнее здесь)

  • Подписчик реактивировал подписку (подробнее здесь)

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

  • Неуспешная оплата — примечание с пояснением (на скриншоте выше)

  • Уведомление о предстоящем списании — дата и время предстоящего списания

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Можно настроить блоки ответов на сообщение для неуспешного платежа по конкретной причине следующим образом:

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

Во всех коллбэках, если в тексте «Платёж неуспешен» есть это слово, пользователю отправится сообщение с заданным вами текстом.

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

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

Чтобы создать подписку, сначала нужно подписной товар создать. Полная инструкция: Как создать и настроить подписку

Затем у подписного товара ID копируем. Например, ниже показано, где его взять:

Создание подписного товара

Чтобы создать ссылку на оплату подписки, prodamus_subscription в переменную нужно ID установить ID подписного товара. После этого автоматически prodamus_pay_url появится переменная.

Перевод на казахский язык (деловой стиль):

prodamus_pay_url переменную можно вывести на экран как ссылку или поместить на кнопку с текстом «Оплатить». Пример ссылки: https://payform.kz/7p3JR8/

Обработка результата выполняется так же, как и при разовом платеже (как вы уже прочитали выше).

После успешной подписки у пользователя добавляется customer_phone переменная, введённая при оплате. Номер телефона нужен для управления подпиской.

Если customer_email не указано, для управления подпиской customer_phone обязательно.

get_prodamus_subscription_url как сделать ссылку на подписку с помощью функции

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

  1. В кабинете Продамус создаётся подписной товар. Полную инструкцию можно посмотреть по ссылке: Как создать и настроить подписку

  2. Затем у подписного товара 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 нужно указать один из параметров.

Чтобы отписать пользователя, необходимо создать блок и вызвать следующую функцию: delete_subscription_prodamus

Пример параметров:

  • url – URL платежной формы, взятый из настроек в конструкторе

  • secret_key – секретный ключ, полученный из настроек

  • id_subscription – ID продукта подписки

  • customer_phone – телефон владельца подписки

  • switcher – управление подпиской: 0 – остановка подписки, 1 – повторная активация подписки

  • profile_id – ID профиля в системе Продамус

Примечание: Если приходит ID профиля, он profile_id сохраняется в переменной. profile_id в функцию customer_phone или customer_email может быть передан вместо него, и подписку можно остановить.

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

Обратите внимание, функция status возвращает его, его можно сохранить и обработать по своему усмотрению. При успешной остановке или повторной активации подписки status = ok будет.

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

prodamus_subscription_switch_status(subscription_id, switcher, customer_phone, customer_email, profile_id) Параметры:

subscription_id – ID продукта подписки

switcher – управление подпиской: 0 – остановка подписки, 1 – повторная активация подписки

customer_phone – телефон владельца подписки; необязательно, если указан customer_email

customer_email – email-адрес владельца подписки; необязательно, если указан customer_phone

profile_id – ID профиля в системе Продамус

Пример использования функции prodamus_subscription_switch_status

Перевод на казахский язык (деловой стиль):

Пример 1: customer_phone указан параметр, customer_email пропущен:

Пример 2: customer_email указан параметр, customer_phone пропущен:

Функция, если все операции успешно завершатся ok возвращает его, либо, в случае ошибки, возвращает её описание.

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

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

Параметры:

  • subscription_id – ID подписки

  • discount – десятичное число с точностью до двух знаков после точки; значение должно быть больше нуля и не должно превышать базовую стоимость подписки

  • customer_phone – номер телефона клиента, формат: +79999999999 (необязательно, если customer_email есть переменная; она появляется после первого платежа)

  • num – количество платежей, к которым применяется скидка (необязательно; если не указано, скидка применяется ко всем платежам)

  • profile_id – ID профиля в системе Продамус

Если запрос выполнен успешно, функция 'ok' возвращает; если возникает ошибка, функция возвращает её описание.

Размер скидки и интервал перезаписываются только при повторном вызове функции с новыми значениями!

Примеры:

1. Дать скидку 1₽ на все последующие автоплатежи (номер телефона не указывается, поскольку он автоматически customer_phone берётся из переменной; сумма скидки по умолчанию применяется ко всему сроку подписки):

2. Пример предоставления скидки 2₽ на следующие 3 платежа (номер телефона указан пустыми кавычками, поскольку он автоматически customer_phone берётся из переменной):

3. Пример указания скидки десятичной дробью (разделитель — точка, значения указываются без кавычек), номер телефона можно передать через переменную.

r = prodamus_subscription_discount(#{prodamus_subscription}, 10.25, #{customer_phone}, 3)

Как установить дату следующего платежа по подписке

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

Например, это может использоваться как бонус для подписчиков.

Для этого нужно использовать следующую функцию:

Параметры:

  • subscription_id – идентификатор подписки

  • date – дата в формате дд.мм.гггг чч:мм или дд.мм.гггг; если указана только дд.мм.гггг, время будет 00:00

  • customer_phone – необязательно; если не указано, customer_phone берётся из переменной; если не найдено, функция не будет работать

  • profile_id – ID профиля в системе Продамус

Как отправить параметры в Prodamus

Чтобы отправить нужные параметры (например, дату начала подписки, отключение рассрочки и т. д.) в систему Prodamus, к имени переменной prodamus_ добавьте префикс.

После этого при создании платежной ссылки параметры из этой переменной будут автоматически отправлены в платёжную систему.

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

Тестируем только платёж!

Чтобы при настройке интеграции и платёжных воронок с вашего счёта не списывались деньги, можно использовать тестовые карты.

Сначала переведите вашу платёжную страницу в ДЕМО-режим ⤵ Не забудьте нажать кнопку «Сохранить».

Для тестового платежа можно использовать тестовые счёта.

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

МИР Карта нөмірі: 2202 2050 0001 2424 Жарамдылық мерзімі: 05/35 Артқы жағындағы тексеру коды (CVV): 669

MasterCard Карта нөмірі: 5469 9801 0004 8525 Жарамдылық мерзімі: 05/26 Артқы жағындағы тексеру коды (CVV): 041 3‑D Secure тексеру коды: 111111

Visa Карта нөмірі: 4006 8009 0096 2514 Жарамдылық мерзімі: 05/26 Артқы жағындағы тексеру коды (CVV): 941 3‑D Secure тексеру коды: 111111

❗️При оплате через тестовые счёта все настроенные воронки и интеграции будут работать так же, как при обычной оплате❗️

Форма проверена

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

Последнее обновление