Крипто-счёт в Telegram: как отправить счёт на оплату криптой из бота
Крипто-счёт в Telegram: как отправить счёт на оплату криптой из бота, что планируется в виде счёта в чате Qvard и что работает сегодня через API.
Крипто-счёт в Telegram — это запрос на оплату, отправленный в чат с суммой, валютой и кнопкой оплаты. Qvard планирует поток счетов внутри Telegram, и он ещё не выпущен. Статья показывает, как отправить крипто-счёт из бота уже сегодня: бот создаёт счёт через API, а кнопка открывает платёжную страницу.
Что содержит крипто-счёт
Счёт показывает заказ, сумму в USD, срок оплаты и кнопку оплаты. Клиент видит, сколько должен, и может оплатить, не покидая диалог надолго.
Статус: счёт в чате в дорожной карте
Нативный поток счетов внутри Telegram ещё не выпущен, и статья не представляет его как доступный. Рабочий путь ниже создаёт счёт через живой API и связывает его с платёжной страницей.
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
}Создание счёта из бота
Бэкенд бота вызывает POST /api/v1/payment с заголовком x-api-key, номером заказа в id и суммой в USD в price. Возвращённый redirectUrl — ссылка на счёт, которую бот отправляет клиенту.
Понятное сообщение со счётом
Покажите номер заказа, сумму в USD, что покупает клиент и кнопку. Добавьте короткую пометку, что точная сумма в криптовалюте будет на следующей странице по фиксированному курсу.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Отслеживание статуса счёта
webhook передаёт статус по номеру заказа. Пока статус не paid, счёт остаётся открытым, и бот может один раз напомнить о нём клиенту.
Срок действия счетов
Не держите неоплаченный счёт открытым бесконечно. Отметьте его истёкшим в своей системе по собственному сроку и создавайте новый платёж, только если клиент об этом просит.
FAQ
Может ли Telegram-бот отправить крипто-счёт сегодня?
Да. Бот создаёт платёж через API, отправляет redirectUrl как ссылку на счёт и обновляет заказ по webhook. Нативный поток счетов в Telegram — в дорожной карте.
Счёт оплачен, когда клиент нажимает кнопку?
Нет. Счёт оплачен только тогда, когда webhook передаст id и статус paid.
Можно ли повторно отправить неоплаченный счёт?
Да, отправьте тот же redirectUrl, пока платёж открыт. Новый платёж создавайте только если старый истёк.
Как протестировать счёт?
Создайте демо-счёт и проверьте сообщение, кнопку и результат webhook, прежде чем работать с реальными заказами.
