SDK JavaScript cho checkout crypto: đã lên kế hoạch và dùng được hôm nay
SDK JavaScript cho checkout crypto là gì: một script dự kiến mở cửa sổ thanh toán, nằm trong lộ trình của Qvard ra sao và những gì dùng được hôm nay.
SDK JavaScript cho checkout crypto sẽ mở cửa sổ thanh toán chỉ với vài dòng mã trên website của bạn. Low-Code SDK của Qvard nằm trong lộ trình và chưa được phát hành. Hướng dẫn này giải thích ý tưởng và chỉ ra luồng v1 thực tế bạn có thể dùng ngay bây giờ.
SDK checkout làm gì
SDK checkout là một thư viện JavaScript nhỏ mà website nạp vào để bắt đầu thanh toán. Nó vẽ cửa sổ thanh toán, dẫn khách hàng qua các bước và trả trạng thái về trang. Logic đơn hàng vẫn nằm trên máy chủ của merchant.
Trạng thái: SDK nằm trong lộ trình
Low-Code SDK của Qvard chưa được phát hành, và bài viết này không mô tả nó như một thư viện hoàn chỉnh. Đoạn mã dưới đây là bản xem trước của lệnh gọi đã lên kế hoạch, không phải mã chạy được hôm nay.
Những gì dùng được hôm nay
Tạo thanh toán trên máy chủ bằng POST /api/v1/payment kèm header x-api-key, chuyển khách hàng tới redirectUrl trả về trên trang checkout hosted và nhận trạng thái cuối qua webhook. Đây là bản tương đương chức năng của lệnh gọi SDK đã lên kế hoạch.
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ủ
Gửi mã đơn hàng trong id và giá tính bằng USD trong price. Giữ khóa API trên máy chủ; trình duyệt chỉ nhận redirectUrl do máy chủ trả về.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Lệnh gọi SDK đã lên kế hoạch
SDK trong lộ trình dự kiến sẽ mở cùng luồng thanh toán từ trang bằng một lệnh gọi. Tên phương thức và các tùy chọn có thể thay đổi trước khi phát hành, nên đừng phát triển dựa trên bản xem trước lúc này.
Cách chuẩn bị
Giữ việc tạo thanh toán trong một hàm backend và tách bộ xử lý webhook riêng. Khi SDK ra mắt, chỉ lệnh gọi front-end thay đổi; lệnh gọi máy chủ và webhook giữ nguyên.
FAQ
Hôm nay Qvard đã có SDK JavaScript cho checkout chưa?
Chưa. Low-Code SDK nằm trong lộ trình. Hôm nay cùng kết quả đạt được qua API, trang checkout hosted và webhook.
Tôi có thể dùng lệnh gọi QvardCheckout.open() ngay không?
Không. Nó chỉ là bản xem trước của API dự kiến. Hãy dùng POST /api/v1/payment và chuyển hướng tới redirectUrl.
Tôi có cần thư viện JavaScript để nhận crypto hôm nay không?
Không. Một nút thông thường gọi backend và chuyển hướng tới redirectUrl là đủ; webhook xác nhận thanh toán.
Làm sao để kiểm thử luồng?
Tạo hóa đơn demo và kiểm tra webhook của bạn nhận được trạng thái cuối.
