search
Ctrlk

Кнопка оплаты

Кнопка с функцией «Платёж» упрощает работу с подключёнными платёжными системами, предоставляя ссылку на оплату.

картинка

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

Кнопка функции «Платёж» доступна для следующих платёжных систем:

  • Stripe

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

Если к проекту не подключены платёжные системы, этот тип кнопки будет недоступен.

картинка

Основные поля кнопки «Платёж»:

  • Поле «Текст»: Этот текст будет отображаться на кнопке со ссылкой на оплату в сообщении.

  • Функция: Выберите тип кнопки Платёж.

  • Поле «Функция»: Чтобы создать кнопку, которая предоставляет ссылку на оплату, выберите Платёж .

  • Поле «Платёжная система»: В списке показаны платёжные системы, подключённые к проекту.

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

Здесь вы можете посмотреть настройки кнопки функции «Платёж» для разных платёжных систем:

Текст обязательные поля для генерации ссылки на оплату это Сумма и Название товара/Описание товара.

  • Поле «Сумма»: Введите здесь сумму оплаты.

  • Поле «Название товара»: Введите название товара, которое будет отображаться на странице оплаты.

Двойные кавычки не можете можно использовать в названии товара.

Вы можете заменить их апострофами или одинарными кавычками.

В зависимости от выбранной платёжной системы в настройках кнопки появятся выпадающие списки «Данные чека» и/или «Дополнительная информация». При нажатии на них откроются дополнительные поля:

картинка

hashtag
Переменные при использовании кнопки функции «Платёж»

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

  • Системная клиентская переменная __payments — эта переменная хранит сумму оплаты и идентификатор сгенерированной ссылки на оплату. Она используется для идентификации ответа webhook от платёжной системы.

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

Клиентская переменная error_payment_button создаётся, если при генерации кнопки оплаты возникает ошибка.

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

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

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

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

После успешной оплаты бот получит callback состоящий из первых 10 символов секретного ключа платёжной системы, слова _successи суммы оплаты, разделённых пробелом. Например: ovg58keefc_success 44где:

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

  • _success: обозначает результат запроса (успешная оплата)

  • 44: сумма оплаты

Колбэки (уведомления) от платёжной системы не видны пользователю. Они отображаются только во вкладке Клиенты и видны оператору.

Пример использования: Шаг 1. В блоке с кнопкой Платёж добавьте кнопки с Платёж . Шаг 2. Во вкладке полем «Условие подключения» из этого блока в Успешная оплата блок, укажите callback. Это работает так же, если вы укажете колбэк успешной оплаты в Поле «Условие» блока Проверка основного условия .

Важно! Выбор типа совпадения — Точное совпадение или Совпадение по ключевому слову.

Полезный совет

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

Оплата с ошибкой

Если произошла ошибка оплаты, бот получит callback состоящий из первых 10 символов секретного ключа платёжной системы, слова _failи суммы оплаты, разделённых пробелом. Например: ovg58keefc_fail 44где:

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

  • _fail: результат обработки запроса — оплата не удалась или произошла ошибка

  • 44: сумма оплаты

Это зависит от платёжной системы. Не все платёжные системы отправляют колбэк при ошибках оплаты.

Если сумма, указанная в настройках кнопки, отличается от суммы, фактически оплаченной клиентом, бот получит callback состоящий из первых 10 символов секретного ключа платёжной системы, фразы _different_amountsи уникального ID платежа, разделённых пробелом. Например: ovg58keefc_different_amounts 123456где:

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

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

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

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