Криптоплатежи в Telegram: запланировано и работает сегодня
Как принимать криптоплатежи в Telegram: схема через бота, что планирует Telegram-оплата Qvard и рабочий путь через API уже сегодня. Пошагово.
Приём криптоплатежей в Telegram означает, что клиент оплачивает заказ прямо в чате с вашим ботом. Telegram-оплата Qvard в дорожной карте и ещё не выпущена. Статья объясняет схему и путь, который работает сегодня: бот создаёт платёж через API, кнопка ведёт на платёжную страницу, а webhook подтверждает заказ.
Почему Telegram — полезный канал
Многие магазины и сообщества уже продают через Telegram-ботов и каналы. Шаг оплаты внутри чата убирает необходимость отправлять клиента на отдельный сайт до оформления заказа.
Статус: Telegram-оплата в дорожной карте
Встроенный чекаут Qvard внутри Telegram ещё не выпущен, и статья не описывает его как доступный. Рабочая схема ниже использует живой API, платёжную страницу и webhook.
Что работает сегодня
Бэкенд бота создаёт платёж запросом POST /api/v1/payment с заголовком x-api-key, получает redirectUrl и отправляет его клиенту кнопкой. Клиент платит на платёжной странице, а webhook передаёт финальный статус вашему бэкенду.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Вызов с сервера бота
Передайте номер заказа в id и цену в USD в price с бэкенда бота. Ключ API храните в конфигурации сервера, а не в логике чата, которую видят клиенты.
Покажите заказ в чате
Отправьте клиенту короткое сообщение с составом заказа и кнопкой, которая открывает redirectUrl. Пишите простым языком и показывайте итог, чтобы клиент понимал, за что платит.
Подтверждение заказа по webhook
Когда webhook передаст id и статус paid, помечайте заказ оплаченным и отправляйте подтверждение в чат. Нажатие на кнопку само по себе заказ не подтверждает.
FAQ
Есть ли сегодня встроенный чекаут Qvard внутри Telegram?
Пока нет. Telegram-оплата в дорожной карте. Сегодня бот использует API, кнопку с redirectUrl и webhook.
Нужно ли клиенту покидать Telegram?
Платёжная страница открывается по кнопке. Диалог остаётся в чате, а результат возвращается боту через ваш webhook.
Можно ли использовать это с уже существующим ботом?
Да. Добавьте вызов платежа и кнопку в существующую логику бота, а webhook обрабатывайте на бэкенде.
Как протестировать сценарий бота?
Создайте тестовый платёж из тестового заказа, оплатите его на платёжной странице и проверьте, что бот подтверждает заказ после webhook.
