Thanh toán Telegram mini app: nhận crypto bên trong mini app
Thanh toán Telegram mini app được giải thích: nhận crypto bên trong mini app Telegram, Qvard dự kiến gì cho checkout mini app và con đường API hôm nay.
Thanh toán Telegram mini app nghĩa là một cửa hàng được xây dựng như ứng dụng web bên trong Telegram nhận crypto cho các mặt hàng của mình. Qvard dự kiến một checkout cho mini app, nhưng chưa được phát hành. Hướng dẫn này giải thích cách một thanh toán trong mini app sẽ hoạt động và con đường đang chạy hôm nay: backend của mini app tạo thanh toán qua API, mở trang hosted và xác nhận đơn hàng qua webhook.
Thanh toán trong mini app là gì
Mini app Telegram là một ứng dụng web mở ngay trong chat. Thanh toán trong mini app nghĩa là khách chọn một mặt hàng trong ứng dụng và trả tiền cho nó mà không phải rời Telegram quá lâu.
Trạng thái: checkout mini app nằm trong lộ trình
Checkout gốc của Qvard cho mini app Telegram chưa được phát hành, và bài viết này không mô tả nó là sẵn có. Con đườ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 mini app tạo thanh toán bằng POST /api/v1/payment kèm header x-api-key, nhận redirectUrl và mở trang hosted cho khách. Sau đó webhook gửi trạng thái cuối về backend, và backend mở khóa mặt hàng.
Giữ khóa trên backend
Mini app chạy trong trình duyệt của khách, nên khóa API không bao giờ được đặt trong mã front-end. Chỉ backend gọi POST /api/v1/payment.
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
}Mở khóa mặt hàng bằng webhook
Mini app chỉ hiển thị mặt hàng là đã mở khóa sau khi webhook gửi id và trạng thái paid của đơn hàng đó. Trước đó mặt hàng vẫn bị khóa, ngay cả khi khách quay lại ứng dụng.
Lên kế hoạch cho checkout gốc của mini app
Khi checkout gốc ra mắt, cửa sổ thanh toán có thể mở ngay trong ứng dụng. Cho đến lúc đó, hãy giữ logic đơn hàng và webhook trên backend, để sau này chỉ front-end thay đổi.
FAQ
Mini app Telegram có nhận crypto hôm nay không?
Có. Backend của mini app tạo thanh toán qua API, mở trang hosted và mở khóa mặt hàng sau khi webhook xác nhận trạng thái paid. Checkout gốc cho mini app nằm trong lộ trình.
Mini app có thể gọi API thanh toán trực tiếp từ trình duyệt không?
Không. Hãy giữ khóa API trên backend và chỉ gọi endpoint thanh toán từ đó.
Khách hàng có phải rời mini app không?
Hôm nay trang thanh toán hosted mở để thanh toán, và kết quả quay lại mini app qua backend và webhook của bạn.
Làm sao để thử thanh toán trong mini app?
Tạo hóa đơn demo từ một mặt hàng thử, thanh toán trên trang hosted và kiểm tra mặt hàng được mở khóa sau webhook.
