Thanh toán crypto trong bot Telegram: cách thêm thanh toán crypto vào bot
Thanh toán crypto trong bot Telegram: cách thêm thanh toán crypto vào bot, Telegram checkout gốc của Qvard dự kiến là gì và con đường chạy được qua API.
Một bot Telegram có thanh toán crypto sẽ nhận đơn hàng trong chat và gửi cho khách một nút thanh toán. Qvard dự kiến một Telegram checkout gốc, nhưng chưa được phát hành. Hướng dẫn này chỉ cách thêm thanh toán crypto vào bot ngay hôm nay với API thực tế, trang hosted và webhook.
Bot cần làm gì
Bot thu thập đơn hàng, tạo thanh toán trên backend của bạn, gửi cho khách nút thanh toán và chờ webhook. Chat là gian hàng, còn việc thanh toán diễn ra trên trang hosted.
Trạng thái: checkout gốc cho bot nằm trong lộ trình
Checkout gốc của Qvard cho bot Telegram chưa được phát hành, và bài viết này không mô tả nó là sẵn có. Tích hợp dưới đây hoạt động hôm nay với API hiện có.
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 thanh toán từ backend của bot
Backend của bot gửi POST /api/v1/payment kèm header x-api-key, mã đơn hàng trong id và tổng tiền bằng USD trong price. Phản hồi chứa redirectUrl, trở thành nút bấm.
Nút và tin nhắn đơn hàng
Gửi một tin nhắn duy nhất gồm đơn hàng, số tiền và nút tới redirectUrl. Giữ tin nhắn ngắn gọn và đừng hứa giao hàng hay mở quyền truy cập trước khi webhook xác nhận thanh toán.
Nhận trạng thái trên backend
Endpoint webhook của bạn nhận id và status, kiểm tra header x-api-key và cập nhật đơn hàng. Chỉ trạng thái paid mới nên mở khóa sản phẩm hoặc dịch vụ.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Xử lý lặp lại và lỗi
Nếu khách đóng trang, đơn hàng vẫn chờ và bot có thể gửi lại đúng liên kết thanh toán đó. Làm cho bộ xử lý webhook an toàn khi lặp lại, vì cùng một thông điệp có thể đến hai lần.
FAQ
Bot Telegram có nhận crypto hôm nay không?
Có. Bot tạo thanh toán qua API, gửi nút tới redirectUrl và xác nhận đơn hàng từ webhook. Telegram checkout gốc nằm trong lộ trình.
Tôi có cần framework bot đặc biệt không?
Không. Bất kỳ mã bot nào gọi được endpoint HTTPS và nhận webhook đều có thể tạo thanh toán qua API.
Khóa API nên lưu ở đâu?
Chỉ trên backend của bot. Tuyệt đối không đưa khóa vào tin nhắn chat hoặc mã mà khách có thể thấy.
Làm sao để thử thanh toán của 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 nhận được webhook.
