Nhận thanh toán crypto trong Telegram: đã lên kế hoạch và chạy được hôm nay
Cách nhận thanh toán crypto trong Telegram: luồng qua bot, Qvard dự kiến gì cho Telegram checkout và con đường chạy được qua API hôm nay. Có ví dụ.
Nhận thanh toán crypto trong Telegram nghĩa là khách hàng trả tiền cho đơn hàng ngay trong cuộc trò chuyện với bot của bạn. Qvard dự kiến một Telegram checkout, nhưng chưa được phát hành. Hướng dẫn này giải thích luồng và con đường đang chạy hôm nay: bot tạo thanh toán qua API, nút dẫn tới trang hosted và webhook xác nhận đơn hàng.
Vì sao Telegram là kênh hữu ích
Nhiều cửa hàng và cộng đồng đã bán hàng qua bot và kênh Telegram. Bước thanh toán ngay trong chat giúp bạn không cần đưa khách sang một trang khác trước khi đặt hàng.
Trạng thái: Telegram checkout nằm trong lộ trình
Checkout gốc của Qvard bên trong Telegram chưa được phát hành, và bài viết này không mô tả nó là sẵn có. Luồng dưới đây dùng API thực tế, trang thanh toán hosted và webhook.
Những gì hoạt động hôm nay
Backend của bot tạo thanh toán bằng POST /api/v1/payment kèm header x-api-key, nhận redirectUrl và gửi cho khách như một nút bấm. Khách thanh toán trên trang hosted, và webhook gửi trạng thái cuối về backend của bạn.
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
}Lệnh gọi từ máy chủ của bot
Gửi mã đơn hàng trong id và giá tính bằng USD trong price từ backend của bot. Giữ khóa API trong cấu hình máy chủ, không bao giờ đặt trong logic chat mà khách có thể thấy.
Hiển thị đơn hàng trong chat
Gửi cho khách một tin nhắn ngắn gồm tóm tắt đơn hàng và nút mở redirectUrl. Dùng ngôn ngữ đơn giản và hiển thị tổng tiền để khách biết mình đang trả cho cái gì.
Xác nhận đơn hàng bằng webhook
Khi webhook gửi id và trạng thái paid, hãy đánh dấu đơn hàng đã thanh toán và gửi xác nhận vào chat. Chỉ bấm nút thì không đủ để xác nhận đơn hàng.
FAQ
Hôm nay có Telegram checkout gốc của Qvard bên trong Telegram không?
Chưa. Telegram checkout nằm trong lộ trình. Hôm nay bot dùng API, nút với redirectUrl và webhook.
Khách hàng có phải rời Telegram không?
Trang thanh toán mở từ nút. Cuộc trò chuyện vẫn ở trong chat, còn kết quả quay lại bot qua webhook của bạn.
Tôi có thể dùng với bot đã có không?
Có. Thêm lệnh gọi thanh toán và nút vào logic bot hiện tại, rồi xử lý webhook ở backend.
Làm sao để thử luồng bot?
Tạo hóa đơn demo từ một đơn hàng thử, thanh toán trên trang hosted và kiểm tra bot xác nhận đơn hàng sau webhook.
