telegramPayment и telegramPaymentPrecheckout
Типы ответов telegramPayment
и telegramPaymentPrecheckout
используются для настройки оплаты
за предоставляемые товары или услуги в канале Telegram.
подсказка
Вы также можете использовать встроенный тег действия
TelegramPayment
в сценарии.
Этот тег не требует дополнительной обработки событий:
вам нужно будет только указать аналогичные параметры, а также переходы в стейты в зависимости от выполняемого условия.telegramPayment
Используется для вывода формы оплаты в сообщении бота.
Свойства
Свойство | Тип | Описание | Примечание | Обязательный |
---|---|---|---|---|
providerToken | Строка | Токен платежной системы. | Для каждой платежной системы необходимо получить уникальный токен на стороне Telegram. | Да |
startParameter | Логический | Разрешение клиенту пересылать ссылку на оплату другим клиентам. | true — другие клиенты смогут оплатить товар или услугу по ссылке.false — другие клиенты не смогут оплатить товар или услугу по ссылке. Они будут перенаправлены на диалог с ботом. | Да |
paymentTitle | Строка | Название товара или услуги. | Допустимо не более 32 символов. | Да |
description | Строка | Описание товара или услуги. | Допустимо не более 255 символов. | Да |
imageUrl | Строка | Ссылка на изображение. | Изображение товара или услуги, которое будет отображаться в форме оплаты. | Нет |
amount | Строка | Цена товара или услуги. | Telegram устанавливает ограничения на минимальную и максимальную цену товара или услуги. Допустимо не более 12 цифр. Чтобы отделять десятичную часть от целой, используйте точку. | Да |
currency | Строка | Валюта. | Трехбуквенный код валюты, соответствующий ISO 4217. Вы можете использовать только те валюты, которые поддерживают Telegram и ваша платежная система. | Да |
invoicePayload | Строка | Произвольные данные для счета-фактуры. | Данные не будут отображаться в диалоге с клиентом. Они будут отображаться только владельцу кассы для анализа платежей. | Да |
Получение токена платежной системы
Чтобы принимать платежи от клиентов,
необходимо получить уникальный токен платежной системы и указать его в свойстве providerToken
.
Прежде чем получить токен платежной системы, нужно создать бота на стороне Telegram.
Выполните шаги, описанные в статье Telegram как входящий канал, и вернитесь к этой статье.
примечание
Если у вас уже есть бот в Telegram, то продолжайте читать эту статью.
- Откройте Telegram и в поиске контактов введите
BotFather
. - Отправьте команду
/mybots
в чат с BotFather. - Выберите бота и нажмите Payments.
- Выберите платежную систему из списка.
- Выберите один из вариантов подключения:
- Test для тестирования платежей.
- Live для настройки реальной интеграции с платежной системой.
- Откроется диалог с ботом для выбранной вами платежной системы. Запустите бота.
- Выполните все шаги, о которых вас попросит бот платежной системы.
- Вернитесь в чат с BotFather.
- В последнем сообщении от BotFather вы увидите список подключенных платежных систем к боту и токены для них. Скопируйте нужный токен.
- Вставьте скопированный токен в свойство
providerToken
.