Блок Оплата в Telegram

Блок Оплата в Telegram позволяет принимать платежи от пользователей Telegram при помощи встроенного сервиса платежей. Сервис поддерживает интеграцию с различными платежными системами.

подсказка

Общая информация о платежах в Telegram

Чтобы использовать данный блок:

1. Создайте сценарий.
2. Зарегистрируйте бота в Telegram и подключите его к Aimylogic.
3. Получите токен платежной системы.
4. Добавьте блок в сценарий.

Получение токена платежной системы

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

1. Откройте Telegram и в поиске контактов введите BotFather.
2. Отправьте команду /mybots в чат с BotFather.
3. Выберите вашего бота и нажмите Payments.
4. Выберите платежную систему из списка поддерживаемых в Telegram.
5. Выберите один из вариантов подключения:
   • Live для настройки реальной интеграции с системой.
   • Test для тестирования платежей. Откроется диалог с ботом для выбранной вами системы.
6. Запустите бота платежной системы.
7. Проделайте все шаги, о которых вас просит бот платежной системы.
8. Вернитесь в чат с BotFather. В последнем сообщении от BotFather вы увидите список интеграций выбранного бота с платежными системами. Скопируйте нужный токен:

Добавление блока

Откройте сценарий вашего бота в Aimylogic и выберите блок Оплата в Telegram в палитре блоков.

Настройте параметры:

• Токен платежной системы — вставьте токен, который вы получили от BotFather.
• Разрешить клиенту делиться ссылкой на оплату — активируйте опцию, если хотите, чтобы по данной форме оплаты можно было совершить несколько платежей. Если клиент перешлет сообщение с формой оплаты другому человеку, сообщение будет содержать URL для оплаты. В этом случае другой человек сможет совершить оплату по той же ссылке. ? > Если вы оставите опцию отключенной, клиент сможет осуществить оплату по форме только из сообщения в чате с ботом. При пересылке сообщения другим пользователям Telegram ссылка для оплаты работать не будет. Если пользователь, которому переслали сообщение для оплаты, нажмет на кнопку оплаты, он будет перенаправлен на бота.
• Проверять наличие товара перед оплатой — активируйте опцию, чтобы клиент мог оплатить товар только в том случае, если позиция есть в наличии. Если вы активировали опцию, укажите URL-адрес сервиса, который возвращает информацию о наличии позиции. Бот будет отправлять запросы на этот адрес. ? > Если в качестве ответа на запрос вернется 200 OK, бот пойдет по ветке Успешная оплата. В противном случае — по ветке Ошибка валидации формы.
• Название — укажите название позиции, для оплаты которой будет отправляться форма.
• Описание — опишите позицию более подробно.
• Ссылка на изображение — вставьте URL изображения, если вы хотите отправлять его в форме оплаты.
• Цена — укажите сумму платежа в рублях, долларах или евро. Выберите соответствующую валюту рядом с полем для цены. ! > Telegram устанавливает ограничение на сумму платежа — она должна быть в диапазоне от 1 до 10 000 долларов США. Если вы выбрали другую валюту, укажите цену в аналогичном диапазоне с учетом текущего курса доллара.
• Данные для счета-фактуры — в произвольном формате укажите данные для счета-фактуры. Клиент не увидит эти данные.

Нажмите Сохранить и опубликуйте бота.

Теперь, когда бот перейдет на данный блок в сценарии, он отправит клиенту форму оплаты:

Переходы из блока

Из блока Оплата в Telegram есть три выхода:

• Успешная оплата.
• Ошибка валидации формы, если при настройке блока вы заполнили какие-либо поля некорректно — например, указали невалидный токен.
• Сбой при оплате, если у клиента не получилось совершить оплату.

предупреждение

Если у клиента не получится совершить оплату, бот не перейдет на следующий экран, пока клиент не отправит какое-либо сообщение боту.