Hóa đơn crypto trong Telegram: cách gửi hóa đơn crypto từ bot của bạn
Hóa đơn crypto trong Telegram được giải thích: cách gửi hóa đơn crypto từ bot Telegram, hóa đơn trong chat Qvard dự kiến là gì và điều gì chạy được qua API.
Hóa đơn crypto trong Telegram là một yêu cầu thanh toán gửi trong chat, kèm số tiền, đơn vị tiền tệ và nút thanh toán. Qvard dự kiến một luồng hóa đơn trong Telegram, nhưng chưa được phát hành. Hướng dẫn này chỉ cách gửi hóa đơn crypto từ bot ngay hôm nay: bot tạo hóa đơn qua API và nút mở trang hosted.
Hóa đơn crypto gồm những gì
Hóa đơn hiển thị đơn hàng, số tiền bằng USD, hạn thanh toán và một nút thanh toán. Khách hàng thấy mình cần trả bao nhiêu và có thể thanh toán mà không phải rời cuộc trò chuyện quá lâu.
Trạng thái: hóa đơn trong chat nằm trong lộ trình
Luồng hóa đơn gốc bên trong Telegram chưa được phát hành, và bài viết này không trình bày nó là sẵn có. Con đường dưới đây tạo hóa đơn qua API thực tế và liên kết với trang hosted.
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
}Tạo hóa đơn từ bot
Backend của bot gọi POST /api/v1/payment kèm header x-api-key, mã đơn hàng trong id và số tiền bằng USD trong price. redirectUrl trả về chính là liên kết hóa đơn mà bot gửi cho khách.
Viết tin nhắn hóa đơn rõ ràng
Hiển thị số đơn hàng, số tiền bằng USD, khách đang mua gì và nút bấm. Thêm một ghi chú ngắn rằng số tiền crypto chính xác sẽ hiện ở trang sau theo tỷ giá cố định.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Theo dõi trạng thái hóa đơn
Webhook gửi trạng thái cho mã đơn hàng. Khi trạng thái chưa phải paid, hóa đơn vẫn mở, và bot có thể nhắc khách một lần.
Cho hóa đơn cũ hết hạn
Đừng để hóa đơn chưa thanh toán mở mãi mãi. Đánh dấu hết hạn trong hệ thống sau thời hạn của riêng bạn, và chỉ tạo thanh toán mới khi khách yêu cầu.
FAQ
Bot Telegram có gửi được hóa đơn crypto hôm nay không?
Có. Bot tạo thanh toán qua API, gửi redirectUrl làm liên kết hóa đơn và cập nhật đơn hàng từ webhook. Luồng hóa đơn gốc trong Telegram nằm trong lộ trình.
Hóa đơn đã được trả khi khách bấm nút không?
Chưa. Hóa đơn chỉ được coi là đã trả khi webhook gửi id và trạng thái paid.
Tôi có thể gửi lại hóa đơn chưa thanh toán không?
Có, gửi lại đúng redirectUrl đó khi thanh toán còn mở, và chỉ tạo thanh toán mới khi cái cũ đã hết hạn.
Làm sao để thử một hóa đơn?
Tạo hóa đơn demo và kiểm tra tin nhắn, nút bấm và kết quả webhook trước khi dùng đơn hàng thật.
