TelegramPayment
Действие TelegramPayment
позволяет настроить оплату через Telegram.
telegramPayment
в $response.replies
.Параметры
Параметр | Тип | Описание | Комментарии | Обязательный |
---|---|---|---|---|
providerToken | Строка | Токен платежной системы | Для каждой платежной системы необходимо получить уникальный токен на стороне Telegram. | Да |
startParameter | Логический | Разрешать ли клиенту пересылать ссылку на оплату другим клиентам | true — другие клиенты смогут оплатить товар или услугу по ссылке. false — другие клиенты не смогут оплатить товар или услугу по ссылке. Они будут перенаправлены на диалог с ботом. | Да |
paymentTitle | Строка | Название товара или услуги | Допустимо не более 32 символов. | Да |
description | Строка | Описание товара или услуги | Допустимо не более 255 символов. | Да |
imageUrl | Строка | Ссылка на изображение | Изображение товара или услуги, которое будет отображаться в форме оплаты. | Нет |
amount | Строка | Цена товара или услуги | Telegram устанавливает ограничения на минимальную и максимальную цену товара или услуги. Допустимо не более 12 цифр. Чтобы отделять десятичную часть от целой, используйте точку. | Да |
currency | Строка | Валюта | Трехбуквенный код валюты, соответствующий ISO 4217. Вы можете использовать только те валюты, которые поддерживают Telegram и ваша платежная система. | Да |
invoicePayload | Строка | Произвольные данные для счета-фактуры | Данные не будут отображаться в диалоге с клиентом. Их увидит только владелец кассы. | Да |
precheckoutEnabled | Логический | Проверка наличия товара перед оплатой | true — перед оплатой бот буде т посылать запросы на URL-адрес сервиса, который указан в поле precheckoutUrl . Если товара нет в наличии и сервис вернет ответ с HTTP-кодом, отличным от 2xx , то бот перейдет в errorState . false — бот не будет проверять наличие товара перед оплатой. | Нет |
precheckoutUrl | Строка | URL-адрес сервиса, который возвращает информацию о наличии товара | — | Нет |
okState | Строка | Стейт, в который перейдет диалог, если оплата прошла успешно | — | Нет |
errorState | Строка | Стейт, в который перейдет диалог, если параметры тега заполнены некорректно | Сценарий перейдет в указанный стейт, если, например, был указан невалидный токен или цена меньше минимального допустимого значения. | Нет |
catchAllState | Строка | Стейт, в который перейдет диалог, если клиент не сможет оплатить счет и отправит произвольное сообщение боту | — | Нет |
Получение токена платежной системы
Чтобы принимать платежи от клиентов,
необходимо получить уникальный токен платежной системы и указать его в параметре providerToken
.
Прежде чем получить токен платежной системы, нужно создать бота на стороне Telegram.
Выполните шаги, описанные в статье Telegram как входящий канал, и вернитесь к этой статье.
- Откройте Telegram и в поиске контактов введите
BotFather
. - Отправьте команду
/mybots
в чат с BotFather. - Выберите бота и нажмите Payments.
- Выберите платежную систему из списка.
- Выберите один из вариантов подключения:
- Test для тестирования платежей.
- Live для настройки реальной интеграции с платежной системой.
- Откроется диалог с ботом для выбранной вами платежной системы. Запустите бота.
- Выполните все шаги, о которых вас попросит бот платежной системы.
- Вернитесь в чат с BotFather.
- В последнем сообщении от BotFather вы увидите список подключенных платежных систем к боту и токены для них. Скопируйте нужный токен.
- Вставьте скопированный токен в параметр
providerToken
.
Ограничения на цену
Telegram устанавливает ограничения для каждой валюты на минимальную и максимальную цену товара или услуги. Она должна примерно соответствовать лимиту 1–10 000 USD. Для каждой валюты, кроме USD, эти лимиты зависят от актуальных обменных курсов и могут меняться со временем.
В д окументации Telegram вы можете найти примерные значения максимальной и минимальной цены для каждой валюты, которую поддерживает Telegram.
Пример использования
state: TelegramPayment
intent!: /Купить билет
TelegramPayment:
providerToken = {{$secrets.get("providerToken")}}
startParameter = true
paymentTitle = Она
description = Кинотеатр «Аврора», 25 декабря, 12:00
imageUrl = https://upload.wikimedia.org/wikipedia/en/4/44/Her2013Poster.jpg
amount = 400
currency = RUB
invoicePayload = 197110, Санкт-Петербург, ул. Большая Зеленина, 24, стр. 1
okState = /TelegramPayment/PaymentSuccessful
errorState = /TelegramPayment/PaymentFailed
catchAllState = /TelegramPayment/CatchAll
state: PaymentSuccessful
a: Оплата прошла успешно. Мы выслали ваш билет на указанный email. До встречи в эфире!
go!: /SendTickets
state: PaymentFailed
a: Возникли неполадки. Пожалуйста, напишите нам на client@just-ai.com, чтобы купить билет.
state: CatchAll
a: Платеж не прошел. Проверьте, пожалуйста, правильность введенных данных и повторите попытку.
go!: /TelegramPayment
Когда в ходе диалога клиент перейдет в стейт TelegramPayment
, в чате появится следующее сообщение: