Cloudpayments

• Как настроить Cloudpayments

• Как настроить Salebot.pro

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

• Функция для создания ссылки

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

• Как сформировать чек

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

• Как вывести данные о сделке

• Как совершить оплату по платежному токену

Как настроить Cloudpayments

Для подключения CloudPayments Вам понадобятся Public ID и Пароль для API.

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

Справа вверху находятся нужные данные (Public ID и Пароль для API): они понадобятся ниже для настройки оплаты в конструкторе.

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

Немного ниже в строке Pay и Recurrent (ВАЖНО именно Payи Recurrent ) необходимо включить переключатель и установить (строка обведена красным прямоугольником на скриншоте выше): Адрес: https://chatter.salebot.pro/cloudpayments_callback/result Кодировка: UTF-8 HTTP метод: POST Форма запроса: CloudPayments

Как настроить Salebot.pro

Теперь переходим в конструктор. Два значения, о которых мы говорили выше (Public ID и Пароль для API), необходимо указать в форме ниже. Форма находится в разделе "Платежные системы"

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

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

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

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

КнопкиSalebot.pro

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

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

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

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

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

чекбокс Автоплатеж. Для подключения автоплатежа, он находится в настройках подключения самой платежной системы (НЕ в настройках кнопки).

меню Данные для формирования чека. При клике откроется выпадающее меню с параметрами для формирования чека:

• Наименование товара или услуги

• Цена руб.

• Количество

• Итоговая цена

• Ставка НДС

• Способ расчёта

• Система налогообложения

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

• ФИО покупателя

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

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

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

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

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

меню "Данные для формирования чека" .

При клике откроется выпадающее меню с параметрами для формирования чека:

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

Например: не Телефон, а Смартфон Xiaomi модель ххх

поле Цена руб. (обязательный) . В данном поле указывается цена в руб за единицу товара.

поле Количество (обязательный). Количество или вес товара. Передать можно целое или дробное число через точку. Пример, 5 или 10.3

поле Итоговая цена (обязательный). В данном поле необходимо указать сумму к оплате с учетом количества товаров.

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

поле Способ расчёта. В этом поле передаем признак способа расчета(например, предоплата). Число от 0 до 7. Список значений можно посмотреть тут

поле Предмет расчёта. В этом поле передаем признак предмета расчета(например, товар/услуга). Число от 0 до 34. Список значений можно посмотреть тут

поле Система налогообложения (необязательный, если у вас одна система налогообложения )

выпадающее меню "Дополнительная информация"

При клике откроется выпадающее меню с дополнительными параметрами для формирования ссылки:

поле ФИО покупателя. В этом поле указываем для юрлиц — название организации; для ИП и физического лица — ФИО.

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

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

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

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

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

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

Переменная клиента error_payment_button создается, если при формировании кнопки возникла ошибка.

В значение переменной error_payment_button запишется либо текст ошибки, либо ответ платежной системы с ошибкой.

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

Успешный платеж.

После успешной оплаты в бота АВТОМАТИЧЕСКИ придет КОЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _success и через пробел сумма платежа. Для использования в настройках схемы достаточно его скопировать.

Например: ovg58keefc_success 44, где:

ovg58keefc : первые первые 10 символов секретного ключа платежной системы

_success : результат обработки запроса (успешный платеж)

44 : сумма платежа

Пример использования: Шаг 1. В блоке "с кнопкой Оплата" добавляем кнопки с функцией Оплата.

Шаг 2. В поле Условие соединения от этого блока к блоку "Успешная оплата" указываем колбэк. Аналогично работает, если указать колбэк об успешной оплате в поле Условие блока Первостепенной проверки условия.

Платеж с ошибкой

При ошибке проведения оплаты в бота АВТОМАТИЧЕСКИ придет КОЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _fail и через пробел сумма платежа

Например, ovg58keefc_fail 44 , где

ovg58keefc : 10 символов секретного ключа платежной системы

_fail : результат обработки запроса - платеж не выполнен или с ошибкой.

44 : сумма платежа

Если сумма, указанная в настройках кнопки, отличается от суммы, которую клиент оплатил, то АВТОМАТИЧЕСКИ придет КОЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _different_amounts и через пробел уникальный ID платежа

Например: ovg58keefc_different_amounts 123456 , где:

ovg58keefc : 10 символов секретного ключа платежной системы

_different_amounts : результат обработки запроса (сумма оплаты отличается от суммы в ссылке)

123456 : уникальный ID платежа

Функция get_cloudpayments_payment_url в Калькуляторе

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

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

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

ПРИМЕР ссылки на оплату:

https://orders.cloudpayments.ru/d/PsdA6GaZmxSXB8xi

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

Как указать сумму

Для генерации ссылки на оплату вам необходимо установить значение переменной payment_sum, сразу после этого появится переменная cloudpayments_pay_url. Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить".

ПРИМЕР ссылки на оплату: https://orders.cloudpayments.ru/d/PsdA6GaZmxSXB8xi

Как указать валюту

Cloudpayments принимает платежи в нескольких валютах, по умолчанию платеж создается в рублях. Для указания другой валюты вам необходимо присвоить значение переменной currency. Переменная принимает значения:

Например, как на скрине ниже, чтобы указать валюту гривны, можно установить эту переменную в настройках проекта.

Как добавить описание платежа

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

Описание берется из переменной payment_description

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

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

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

При успешной оплате по ссылке созданной с помощью кнопки с функцией ОПЛАТА или с помощью функции в калькуляторе, в бота АВТОМАТИЧЕСКИ придет КОЛБЭК, который состоит из 10 символов секретного ключа платежной системы, слова _success и через пробел сумма платежа. Для использования в настройках схемы достаточно его скопировать.

Например: ovg58keefc_success 44, где:

ovg58keefc : первые первые 10 символов секретного ключа платежной системы

_success : результат обработки запроса (успешный платеж)

44 : сумма платежа

Также после успешной оплаты переменная cloudpayments_payment_completed устанавливается в True.

Если же оплата была неуспешной, Вам придет колбек вида b426739684e4e7449323344484353_fail.

Для того чтобы узнать причину, обратите внимание на переменную cloudpayments_payment_status.

Она может принимать следующие значения:

Пример

Пример схемы, которая позволит протестировать быстро начать работу с Cloudpayments.

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

Ниже настройки стрелки, в ней должен быть включен переключатель "Пользователь вводит данные" и в поле вписана переменная payment_sum.

Ссылка на оплату содержится в переменной #{cloudpayments_pay_url}

После завершения оплаты клиенту добавится переменная cloudpayment_callback_data, содержащая данные ответа платежной системы по совершенной операции. Из полученного словаря можно извлечь необходимые данные при помощи метода get.

Как сформировать чек

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

Обязательные параметры:

! products_for_receipt - это массив с перечисленными товарами чека, следующего вида:

[{"description": "Название товара", "quantity": "Количество товара", "price": "Цена за единицу товара", "amount": "стоимость товара, произведение quantity и price", "vat_code": "ставка НДС"},

{"description": "Название товара 2", "quantity": "Количество товара 2", "price": "Цена за единицу товара 2", "amount": "стоимость товара, произведение quantity и price"}]

Каждый товар разделен запятой и имеет вид: {"description": "Название товара", "quantity": "Количество товара", "amount": "Цена за единицу товара", "vat_code": "ставка НДС"}

где:

Также необходимо указать, контактные данные клиента, как минимум: электронную почту или номер телефона:

email - E-mail покупателя для отправки чека phone - телефон покупателя в формате без скобок и дефисов для отправки ссылки на чек

Необязательные параметры: full_name - для юрлица — название организации, для ИП и физического лица — ФИО cloudpayments_method - признак способа расчета(например, предоплата). Число от 0 до 7.Список значений можно посмотреть тут cloudpayments_object - признак предмета расчета(например, товар/услуга). Число от 0 до 34. Список значений можно посмотреть тут cloudpayments_inn - ИНН организации, необходим для корректного формирования чека cloudpayments_taxation_system - система налогообложения, число от 0 до 5, где 0-Общая система налогообложения 1-Упрощенная система налогообложения (Доход) 2-Упрощенная система налогообложения (Доход минус Расход) 3-Единый налог на вмененный доход 4-Единый сельскохозяйственный налог 5-Патентная система налогообложения Если не указать, поставит первую систему, указанную при фискализации. cloudpayments_calculation_place - Место осуществления расчёта, например, адрес сайта

Пример данных для чека:

products_for_receipt = [{"description": "Название товара", "quantity": "2", "price": "25", "amount": "50", "vat_code": "0"}, {"description": "Название товара 2", "quantity": "3", "price": "50", "amount": "150"}] phone = 79000000000 email = example@gmail.com full_name = Иванов Иван Иванович

После определения переменных платежа, определяем переменную payment_sum, после которой сразу появится ссылка на оплату в переменной cloudpayments_pay_url.

После оплаты на указанную почту клиенту придет чек об оплате, если был передан номер телефона, то на него придет сообщение с ссылкой на чек.

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

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

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

Обратите внимание: Автоплатеж автоматически создается с периодом списания равным один месяц.

Вы можете задать период списания равный одной неделе, для этого перед первым (установочным) платежом дополнительно нужно задать переменную cloudpayments_subscription_period - со значением week

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

Как обработать результат платежей по подписки

Результат и статус платежа по подписке можно отследить по переменным сделки:

В случае успешного платежа в переменную subscription_payment_sum записывается его сумма, например 200.0

По каждому запросу на списание в бота придет коллбэк. Он выглядит так же, как при обычном платеже. Его описание есть выше в главе "Обработка результата".

Как получить id подписки

При попытке совершить установочной платеж Salebot получит колбек, содержащий id подписки и запишет этот id в переменную клиента cloudpayments_subscription_id.

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

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

Статус подписки клиента записывается в переменную сделки cloudpayments_subscription_status. Она принимает значения “Active” или “Inactive”.

Выбор значения зависит от двух факторов:

• статуса последнего совершенного платежа по подписке, то есть если платеж был успешным (“Completed”), переменная примет значение “Active”, а в противном случае - “Inactive”;

• информации, которая приходит в ответ на запросы изменения или отмены подписки. Например, если вы отменили подписку, в Salebot придёт колбек c обновленными данными подписки и статусом “Cancelled”. Salebot распознает изменение статуса и перезапишет переменную.

Как изменить существующую подписку

Если после создания вам нужно изменить подписки, используйте функцию cloudpayments_update_subscription(amount, description, subscription_interval, subscription_period, products_for_receipt, start_date)

Функция принимает набор параметров, однако ни один из них не является обязательным, поэтому, если вы хотите сохранить прежнюю информацию относительно одного из параметров, то просто передайте в него пустую строку - ‘’.

Параметры:

Для блоков, созданных ранее 16.01.2024:

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

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

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

Например, изменим данные подписки на следующие: products_for_subscription_receipt = [{"description": "Название товара", "quantity": "1", "price": "10", "amount": "10", "vat_code": "0"}, {"description": "Название товара 2", "quantity": "3", "price": "30", "amount": "90"}] response = cloudpayments_update_subscription(100, "Новая подписка") products_for_subscription_receipt - необязательная переменная, данные для чека (описание ниже)

Совершение обычного платежа при включенных подписках

Если Вам нужно, при включенных автоплатежах провести оплату без подписки, то до указания переменной payment_sum, нужно добавить переменную cloudpayments_manual_recurrent_disable и присвоить ей значение 1.

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

Как получить чеки для платежей по подписке

Если при первом платеже с включенными автоплатежами были переданы данные для чека, то создастся подписка уже с данными для чека. На каждый автоплатеж будет приходить чек на указанный email или номер телефона.

Если вы решили изменить сумму платежа по подписке, у вас подключена онлайн касса и после списания нужно отправлять чек, тогда до вызова функции cloudpayments_update_subscription() нужно создать переменную products_for_subscription_receipt, которая будет содержать новые данные для чека. Если их не передать, списания будут происходить без чека.

products_for_subscription_receipt заполняется таким же образом, как и переменная products_for_receipt описанная выше в главе "Формирование чеков"

Как получить информацию о подписке

Информацию о подписке клиента можно получить с помощью функции cloudpayments_subscription_info().

Функция не принимает параметров и вернёт данные подписки с id из переменной клиента cloudpayments_subscription_id.

Пример возвращаемых данных:

Как отменить подписку

Чтобы отменить подписку, достаточно вызвать функцию cloudpayments_remove_subscription()

Как понять, что подписка отменена?

Вам приходят уведомления по платежам по подписке, которые содержат текущий статус подписки.

Если подписка активна, то в диалоге будет колбек "частьключа__success" и в переменную cloudpayments_subscription_status запишется значение "Active"

Если подписка отменена или не оплачена, в диалоге будет колбек "частьключа_fail", а в переменную cloudpayments_subscription_status запишется "Inactive"

Как вывести данные о сделке

В cloudpayments доступна функция вывода полных данных о сделке.Для этого в окне подключения платежки необходимо включить “сохранять данные колбека". После этого, при совершении платежей пользователями, в информацию о сделке в переменную cloudpayment_callback_data будет приходить список, включающий в себя данные о совершенном действии. Из этого списка можно извлечь нужную вам информацию, такую как статус сделки, сумма, валюта, имя, почта и другое. Для этого воспользуйтесь встроенной функцией get()

Оплата по токену (рекарринг)

Рекарринг — это услуга, которая позволяет клиентам проводить повторную оплату банковскими картами на сайте в один клик, не тратя время на ввод данных.

Этот вид платежа инициирует покупатель, когда оформляет онлайн-покупку впервые.

Если вы хотите подключить данный сервис, вам необходимо связаться с персональным менеджером Cloudpayments.

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

Чтобы произвести безакцептное списание, задайте переменную token_payment_sum (сумма платежа по токену) и воспользуйтесь функцией калькулятора cloudpayments_payment_token, передав в неё необходимые параметры в заданном порядке:

token -> initiator -> scheduled -> customer_phone

Описание параметров:

В случае успешного платежа, вы получите привычный колбек об оплате.

Также в переменные добавится ответ от системы: